編集ヘルプ
本Wikiで記事編集する際の書式、及びその際によく使うであろうプラグインについて説明しています。
各ページのソースは、ページ右側の「文書の編集」(スマートフォンからはプルダウンで選択)から閲覧可能です。
編集の感触を確かめたい場合はプレイグラウンドページで練習して下さい。
一部の書式はクイックボタンからも挿入可能です。
このページの内容は、Wiki付属の英語版ページを元にしています(不要と思しき内容は、当ページでは省略しました)。英語版ページも参照可能ですが、一部、本Wikiでカスタマイズした内容と合いません。
※当Wikiでは『DokuWiki』というWikiエンジンを採用しています。
基本的なテキスト書式
**太字** //斜体字// __下線付き__ ''等幅フォント'' **__//''全部または一部''//__**を混ぜられます **改行をまたいでも へーきへーき! まっかせてー!**
太字 斜体字 下線付き 等幅フォント 全部または一部を混ぜられます
改行をまたいでも
へーきへーき! まっかせてー!
下付き文字<sub>(subscript)</sub>と上付き文字<sup>(superscript)</sup> <del>取り消し線</del>
下付き文字(subscript)と上付き文字(superscript) 取り消し線
<color red>赤色</color> <color white/black>白黒</color>
赤色 白黒
注釈:1)
<fs 200%>200パーセント</fs> <fs 30px>30ピクセル</fs>
200パーセント 30ピクセル
注釈:2)
{{ruby|豹|ひょう}}の{{ruby|模様|もよう}}は、{{ruby|丸|まる}}っこい{{ruby|輪|わ}}っかが、{{ruby|体|からだ}}に{{ruby|散|ち}}らばってますやんか
注釈:3)
#;; 左揃え #;; ;#; 中央揃え ;#; ;;# 右揃え ;;# ### 両端揃え ###
左揃え
中央揃え
右揃え
両端揃え
注釈:4)
段落の途中で 改行出来ます。バックスラッシュ(一部環境からは円記号)2つを連ねて\\ 空白を置いても改行出来ます。行の途中で改行したい場合は\\ そうして下さい。 バックスラッシュの後にスペースを置かないと改行されません。\\ほらね。 空行を置くと改段落となります。 ただ改行するだけだと2行以上は空かないので、2行以上開けたい場合はバックスラッシュ×2×(開けたい行数)を置いて下さい。空白も忘れずに。\\ \\ \\ それはそうと私はコツメカワウソちゃんがすきです
段落の途中で
改行出来ます。バックスラッシュ(一部環境からは円記号)2つを連ねて
空白を置いても改行出来ます。行の途中で改行したい場合は
そうして下さい。
バックスラッシュの後にスペースを置かないと改行されません。\\ほらね。
空行を置くと改段落となります。
ただ改行するだけだと2行以上は空かないので、2行以上開けたい場合はバックスラッシュ×2×(開けたい行数)を行末に置いて下さい。空白も忘れずに。
それはそうと私はコツメカワウソちゃんがすきです
注釈:5)
リンク
一口に「リンク」と言っても色々あります。
外部リンク(このWikiの外のページ)
URLは「 http://www.google.co.jp 」「 www.google.co.jp 」のように自動認識されます。 当然、「[[http://www.google.co.jp|Google Japan]]」のようにリンクテキストも指定可能です。
URLは「 http://www.google.co.jp 」「 www.google.co.jp 」のように自動認識されます。
当然、「Google Japan」のようにリンクテキストも指定可能です。
内部リンク(このWikiの中のページ)
文字列を四角括弧2つで囲むと、それをページ名として内部リンクを張れます。[[:indexpage]] リンクテキストは、そのページで指定されたタイトルに自動で差し替わります。 「[[:indexpage|全てが始まるページ]]」こんな感じで文字列指定も可能。
文字列を四角括弧2つで囲むと、それをページ名として内部リンクを張れます。ジャガマニストオリキャラWikiへようこそ!
リンクテキストは、そのページで指定されたタイトルに自動で差し替わります。
「全てが始まるページ」こんな感じで文字列指定も可能。
注釈:6)
DokuWikiでは、「名前空間」と呼ばれる物をコロン「:」で指定します(PukiWikiとかで言う所のスラッシュ「/」に当たる)。
[[wiki:syntax|このページ]]にも名前空間を利用しています。 [[indexpage]]←トップページにリンクしたいのですが、これではいけません。 このヘルプページは「wiki」という名前空間に属していて、さっきの例だと「wiki:indexpage」という存在しないページにリンクしようとしました(「相対パス」のため)。 [[:indexpage]]←こうすれば大丈夫です(「絶対パス」)
このページにも名前空間を利用しています。
indexpage←トップページにリンクしたいのですが、これではいけません。
このヘルプページは「wiki」という名前空間に属していて、さっきの例だと「wiki:indexpage」という存在しないページにリンクしようとしました(「相対パス」のため)。
ジャガマニストオリキャラWikiへようこそ!←こうすれば大丈夫です(「絶対パス」)
注釈:7)
Interwiki
Interwikiは、他のWikiやサイトへのリンクを素早く作成出来る機能です。
通常ではわざわざURLを入力する必要がありますが、Interwikiによってそれを簡略化しています。
当Wikiでは、DokuWiki付属のInterwiki(上記のDokuWikiサイトリンク参照)の他、関連Wiki・関連サイトへのInterwikiも追加で利用可能です。
「[[wp>Wiki]]」で、ウィキペディアに飛びます(ただし英語版なので、日本語がいい場合(殆どそうだろ)は「[[wp>ja:ウィキ]]」のようにして下さい)。[[google>ジャガーマンシリーズ|ググる]]事も出来ます(キーワードを元に無作為選出のページに飛ばされる)。
「Wiki」で、ウィキペディアに飛びます(ただし英語版なので、日本語がいい場合(殆どそうだろ)は「ja:ウィキ」のようにして下さい)。ググる事も出来ます(キーワードを元に無作為選出のページに飛ばされる)。
[[nicovideo>sm31854709|ジャガーマン]]・[[nicouser>68325696|千賀さん]]・[[nicomylist>59812084|すまんマイリスト]]
[[jmswiki>FrontPage|ジャガーマンシリーズWikiのトップページ]]・[[jmswiki>用語集|用語集で教えてもらうんだ!]]
ジャガーマンシリーズWikiのトップページ・用語集で教えてもらうんだ!
[[twitter>YukkuriDosanko|管理人のTwitter]]・[[twitter>YukkuriDosanko/status/1062987431228563456|ツイート貼り付けも(URLリンクのほうが早い気もするけど)]]
新しいタブで開く
当Wikiでは原則同じタブでリンクを開きますが、新しいタブで開くようにも出来ます。
[[+tab|:indexpage|こことか]]、[[+tab|https://www.google.com|こことか]]、[[+tab|jmswiki>FrontPage|こことか]]を新しいタブで開きます。
注釈:8)
画像リンク
当Wikiではあまり出番が無いかもしれませんが、Wikiにうpした画像(後述)を内部/外部リンクに使えます。
[[http://php.net|{{wiki:dokuwiki-128.png}}]]
画像とリンクの整形記法(画像については後述)は全てサポートされています(画像のリサイズ、内部/外部画像9)、URL、Interwikiリンク等)。
脚注
見出し
5階層までの見出しを作れます。
当Wikiでは、1階層目の見出しをページタイトルとして最上部に設置しています。
なので本格的に使うのは2階層目からです。
上の「見出し」って大きく書いてあるのが2階層目の見出しです。
見出しが3つ以上ある場合、目次が自動生成されます。
==== 見出しレベル3 ==== === 見出しレベル4 === == 見出しレベル5 ==
見出しレベル3
見出しレベル4
見出しレベル5
見出しのスタイリング
当Wikiでは、見出しも本文同様に装飾出来ます。
==== **見出し**//装飾//の''サンプルです'' ==== === <color yellow>黄色</color>の__砂__が付いてます === === <color #FF00FF>わぁ~! プルプルプル…</color> === === <color #800080>ハハ アハハハハ</color> <color #800000>アアハハハハハハ アアハハハハハハハハハ</color> <color #330033>ハハハハハハハハハハハハハハ</color> ===
見出し装飾のサンプルです
黄色の砂が付いてます
わぁ~! プルプルプル…
ハハ アハハハハ アアハハハハハハ アアハハハハハハハハハ ハハハハハハハハハハハハハハ
水平線
半角ダッシュ(マイナス)を4つ以上連ねると ---- 水平線でぶった切られます。
半角ダッシュ(マイナス)を4つ以上連ねると
水平線でぶった切られます。
メディアファイル
文中に画像を使えます(他にも動画ファイルや音声ファイルを使えるらしい)。
波括弧2つでファイル名を囲って下さい。サイズ指定も可能です。
サイズ変更無し:{{wiki:dokuwiki-128.png}}
幅サイズ指定:{{wiki:dokuwiki-128.png?50}}
幅・高さサイズ指定:{{wiki:dokuwiki-128.png?200x50}}
外部画像(当Wikiでは非推奨):{{http://php.net/images/php.gif?200x50}}
注釈:13)
次のように半角スペースを挿入すると、画像の位置を指定出来ます。
{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}
画像にタイトルを指定出来ます(大体のブラウザではツールチップとして表示されます。画像の上にマウスポインタを置くと浮かび上がってくるアレです)。
{{ wiki:dokuwiki-128.png |ここはツールチップだよ! 私はサーバル!}}
画像にハイパーリンクを張る方法は上述しています。
画像などを新規にアップロードしたい場合はこちらのFAQをご覧下さい。
対応するファイル形式
DokuWikiに直接埋め込めるのは次の形式のファイルです。
| 画像 | gif, jpg, png |
| 動画 | webm, ogv, mp4 |
| 音声 | ogg, mp3, wav |
| フラッシュ | swf |
上以外のファイルを指定した場合、埋め込まない代わりにそのファイルへのリンクを表示します。
ニコニコ動画のサムネイル表示
ツイート埋め込み
{{embedtweet|url=https://twitter.com/JMSWikiChanges/status/1015223443703324678}}
{{embedtweet|url=https://mobile.twitter.com/JMSWikiChanges/status/1015223443703324678|theme=dark|linkcolor=#f49842}}
https://twitter.com/JMSWikiChanges/status/1015223443703324678
https://twitter.com/JMSWikiChanges/status/1015223443703324678
注釈:15)
箇条書き
箇条書きリストを作成する場合は、行頭に半角スペース2つを挿入して、*(番号無し)もしくは-(番号付き)を入力して下さい。
* 箇条書きリストです * 2つ目の項目だよ * インデントしてます * また別の項目 - こっちは番号付き - 別の項目 - インデントすると階層が深くなります - 完
- 箇条書きリストです
- 2つ目の項目だよ
- インデントしてます
- また別の項目
- こっちは番号付き
- 別の項目
- インデントすると階層が深くなります
- 完
噂に聞こえたすごい(要出典)箇条書きについてのFAQがあるらしいよ
折り畳みプラグイン
ネタバレ記述等を隠したい場合は、折り畳みプラグインを使って、閲覧者の目に届きにくいようにします。
++++ 開くなよ? 絶対開くなよ?? | 開くなって言ったじゃねぇかぁぁぁぁぁぁぁぁ ++++
注釈:16)
テキスト変換
DokuWikiでは、幾つか定義されている文字列や記号を、画像や他のテキスト、HTMLに変換出来ます。
テキストから画像への変換は、主にスマイリーについて行われます。また、テキストからHTMLへの変換は、タイポグラフィ置換に使われますが、他のHTMLを使うような設定にも出来る……らしいよ?(全然わからん!)
テキスト→画像
DokuWikiでは、多く使われる「emoticon」(欧州型の顔文字)を、同じ意味の画像に変換します。これらのスマイリーや他の画像は設定・拡張が可能です(あまり無いと思うけど要望があれば管理人までご連絡下さい)。 以下に示すようなスマイリーが使えます。
8-)
8-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
:?:
:!:
LOL
FIXME
DELETEME
テキスト→HTML
タイポグラフィ:DokuWikiでは、単純なテキスト文字を印刷向きの物に変換します(このWikiのページを印刷する機会はあるのだろうか)。以下がその例です。
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..."
→ ← ↔ ⇒ ⇐ ⇔ » « – — 640x480 © ™ ®
"He thought 'It's a man's world'…"
同じ事が、HTML生成段階で必ず適用されます。パターンファイルをいじるとカスタム出来るらしいです(他人事)
3つ例外があり(パターンファイルでは設定をいじれない)、乗算記号(640x480)、シングル/ダブルクォートです。設定はconfigオプションでいじれます。変更要望(無いと思うけど)は管理人まで。
半角スペース挿入
このタイポグラフィを用いて、半角スペースを(通常は連続で入力しても1個だけの所)いくらでも挿入出来ます。
うらうらうらーーっ{{nbsp}}{{nbsp}}{{nbsp}}{{nbsp}}{{nbsp}}{{nbsp}}{{nbsp}}{{nbsp}}{{nbsp}}半角スペース祭りじゃああああああああ
うらうらうらーーっ 半角スペース祭りじゃああああああああ
引用
返信やコメントを強調したい時に、次の通り引用機能を使えます。
> 英語版の整形記法ページでの「引用」紹介の会話を元ネタにしたのを > 仲良し3人組にやらせていたが > あまりに く だ ら ん ので > この文言に差し替える事と > した >>知るか
英語版の整形記法ページでの「引用」紹介の会話を元ネタにしたのを
仲良し3人組にやらせていたが
あまりに く だ ら ん ので
この文言に差し替える事と
した
知るか
表
DokuWikiではシンプルな記法で表を作れます。
…っていう触れ込みだったけど実際はPukiWikiとかとそんなに変わらんかもしれん
^ ヘッダー1 ^ ヘッダー2 ^ ヘッダー3 ^ | 1行目1列目 | 1行目2列目 | 1行目3列目 | | 2行目1列目 | 列を結合(バーティカルバーを2つ連ねる) || | 3行目1列目 | 3行目2列目 | 3行目3列目 |
| ヘッダー1 | ヘッダー2 | ヘッダー3 |
|---|---|---|
| 1行目1列目 | 1行目2列目 | 1行目3列目 |
| 2行目1列目 | 列を結合(バーティカルバーを2つ連ねる) | |
| 3行目1列目 | 3行目2列目 | 3行目3列目 |
注釈:17)
表の列は|(普通のセル)もしくは^(ヘッダーになるセル)で開始・終了します。
上に示したように、表を水平方向に結合する場合はその次のセルに何も入力しないで下さい。
垂直方向にヘッダーを設ける事も出来ます。(翻訳がめんどくさくなってきたので表の中身は英語のままにしています)
| ^ Heading 1 ^ Heading 2 ^ ^ Heading 3 | Row 1 Col 2 | Row 1 Col 3 | ^ Heading 4 | no colspan this time | | ^ Heading 5 | Row 2 Col 2 | Row 2 Col 3 |
| Heading 1 | Heading 2 | |
|---|---|---|
| Heading 3 | Row 1 Col 2 | Row 1 Col 3 |
| Heading 4 | no colspan this time | |
| Heading 5 | Row 2 Col 2 | Row 2 Col 3 |
上を見ると分かるように、各セルの状態(ヘッダーかそうでないか)を決めるのは、そのセルが始まる前のセパレーターです(上の例で、「^ Heading 1 ^」の部分が「| Heading 1 ^」になってたら、Heading1セルはヘッダーでなくなります)。
:::をセルに入力すると、垂直方向に結合出来ます。(翻訳がめんどくさくなってきたので表の中身(ry)
^ Heading 1 ^ Heading 2 ^ Heading 3 ^ | Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 | | Row 2 Col 1 | ::: | Row 2 Col 3 | | Row 3 Col 1 | ::: | Row 2 Col 3 |
| Heading 1 | Heading 2 | Heading 3 |
|---|---|---|
| Row 1 Col 1 | this cell spans vertically | Row 1 Col 3 |
| Row 2 Col 1 | Row 2 Col 3 | |
| Row 3 Col 1 | Row 2 Col 3 |
垂直結合する場合は、そのセルの中には:::の他に何も入力してはいけません。
表の中の内容を位置調整する事も出来ます。
右揃えしたいなら、内容の左側に2つ以上の半角スペースを、左揃えしたいなら内容の右側に2つ以上の半角スペースを、
中央揃えしたいなら内容の両端に2つ以上の半角スペースを入力します。
(翻訳がめんどくさくなってきたので表(ry)
^ Table with alignment ^^^ | right| center |left | |left | right| center | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
| Table with alignment | ||
|---|---|---|
| right | center | left |
| left | right | center |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
縦方向の位置調整はサポートされていません。へーきへーき、Wikiによって得意な事違うから!
書式設定の無効化
Wikiの書式と全く同じ内容を入力したくて、それに対して書式設定を適用させたくない場合は、
その部分を<nowiki>タグ、もしくはもっとシンプルに、パーセントを2つ連ねた物%%で囲って下さい。
<nowiki> URLを http://jdwiki.hkdyukkuri.space こんな感じで入力したり、**書式設定**を適用させたりしようとしても、nowikiタグの前では無様にもそのまま出力されます。 </nowiki> %%//__ここの__テキスト//や、スマイリー;-)であっても、パーセント追い込み漁の前では無力なのです。%%
URLを http://jdwiki.hkdyukkuri.space こんな感じで入力したり、**書式設定**を適用させたりしようとしても、nowikiタグの前では無様にもそのまま出力されます。
//__ここの__テキスト//や、スマイリー;-)であっても、パーセント追い込み漁の前では無力なのです。
注釈:18)
コード区画
主にプログラムのソースコードを載せたりする際に使うらしいですが、ここではあまり使わないかも。
当ページではこれまで、灰色の四角の中でWikiのソースコードを紹介していましたが、
これらは、このコード区画の機能を利用して表示していました。
行頭に半角スペース2つを入れると、こんな感じの空間に入ります。
行頭に半角スペース2つを入れると、こんな感じの空間に入ります。
<code> 通常は、半角スペースを連ねたとしても出力されるのは1つの半角スペースのみですが、このコード区画では こんな風に、幾らでもスペースを挿入出来ます。 </code>
通常は、半角スペースを連ねたとしても出力されるのは1つの半角スペースのみですが、このコード区画では こんな風に、幾らでもスペースを挿入出来ます。
<file> ここの部分は、見た目は同じですがファイル内容のソースを表示するのに使います。つまり当Wikiではいらァーン </file>
ここの部分は、見た目は同じですがファイル内容のソースを表示するのに使います。つまり当Wikiではいらァーン
コメント行
編集画面には表示されないがソースコードには表示される記法です。
主に、編集者に対するメモ書きを残したり、ソースコードの可読性を向上させたりします。
わーいわーい /* あほくさ */ /* この世の中はどうなってるんだろう */ やっぱ人生って楽しいなぁ〜 /* はーつまんな */
わーいわーい
やっぱ人生って楽しいなぁ〜
注釈:19)
その他の記法プラグイン
DokuWikiでは、第三者が作った多彩なプラグインを導入出来ます。
以下、Wikiの記法に関連するプラグインのうち、当Wikiで導入している物です。
- Access Counter and Popularity Plugin 2019-03-12 by HokkaidoPerson
Export the number of those who visited a specified page in your wiki today, yesterday, or in whole period. You can also show the list of the popularity according to the log data taken by the plugin. This plugin is ported from those of PukiWiki (with some customizing). - Add New Page 2015-11-02 by Benjamin Santalucia, Sam Wilson, Michael Braun, Gerrit Uitslag, Albert Chern
Adds a "new page form" to any wiki page. - Cloud Plugin 2017-08-05 by Michael Hamann, Michael Klier, Gina Haeussge
Displays the most used words in a word cloud. - Comment Syntax support 2018-10-14 by Satoshi Sahara
Allow to use source comment syntax to leave edit instructions of the page. Comments are visible only in the source view, not rendered as any page elements. - discussion plugin 2017-08-24 by Michael Hamann, Gerrit Uitslag, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner, Matthias Schulte
Provides discussion funtionality for wiki pages - folded plugin 2018-07-31 by Michael Hamann, Fabian van-de-l_Isle, Christopher Smith, Esther Brunner
Foldable page sections - fontsize2 plugin 2017-01-07 by Thorsten Stratmann
DokuWiki plugin for controlling the size of your text - LineBreak2 plugin 2019-02-07 beta by Satoshi Sahara
Alternative xhtml renderer that works with LINEBREAK directive. The LineBreak2 renderer also provides ability to remove unwanted spaces between CJK full-width characters, and supports Markdown linebreak trick of more than two spaces at the end of line. - Nicovideo Plugin 2018-08-06 by HokkaidoPerson
Add players and thumbnails of videos, mylists, etc. on Nicovideo. - numberof plugin 2014-06-02 by S.C. Yoo
Simple plugin count the number of pages & media files in your Dokuwiki - The Number of Online Plugin 2018-08-29 by HokkaidoPerson
Export the current number of those who is browsing your wiki, in plain text. This plugin is ported from that of PukiWiki (with some customizing). - Pagelist Plugin 2017-08-24 by Matthias Schulte, Michael Hamann, Michael Klier, Gina Haeussge
Lists pages in a nice formatted way - PageTitle plugin 2018-07-24 by Satoshi Sahara
Define a title of the wiki page by <title> tag. This plugin allows to write decorative title on the page with setting plain title text in metadata storage. - Ruby Plugin 2018-08-08 by HokkaidoPerson
Add ruby (normally used to display Japanese Kana on Chinese characters to describe how to read the Chinese characters. This plugin is mainly for Japanese surroundings) - Searchable javascript 2010-10-22 by Robert Henjes
Add <searchtable> and </searchtable> around your table. - struct plugin 2018-10-08 by Andreas Gohr, Michael Große
Add and query additional structured page data - Tag Plugin 2017-08-24 by Michael Hamann, Gina Häussge, Christopher Smith, Michael Klier, Esther Brunner
tag wiki pages - Target-Link Plugin 2018-08-08 by HokkaidoPerson
Make links with specified targets not depending on the configuration. e.g.: The links usual open in the same tab, but this link opens in a new tab.



