====== 書式の表記法 ======

[[DokuWiki]]は、いくつかのシンプルなマークアップ言語をサポートしています。それによって、可能な限りデータファイルに可読性を持たせています。このページには、ページの編集時に使用するすべての表記法が含まれています。上記に配置された「文書の編集」をクリックして、このページのソースを眺めるだけでも役に立つことでしょう。もし、書き込みの練習をしたいなら、[[playground:playground]]のページを利用してください。基本的なものは、[[quickbuttons]]を使っても記述することができます。

【訳者注】 原作者のWikiに、ここと同様の日本語訳[[doku>wiki:ja:syntax]]がありました。こちらはこちらで保存したままにしておきます。

===== 基本的なテキストの書式 =====

DokuWikiは、**太字**、//斜体//、__アンダーライン__そして、''等倍文字''をサポートしています。もちろん、それらすべてを**__//''組み合わせ''//__**ることも可能です。

  DokuWikiは、**太字**、//斜体//、__アンダーライン__そして、''等倍文字''をサポートしています。
  もちろん、それらすべてを**__//''組み合わせ''//__**ることも可能です。

さらに、<sub>下付き文字</sub>や<sup>上付き文字</sup>も使用できます。

  さらに、<sub>下付き文字</sub>や<sup>上付き文字</sup>も使用できます。

<del>取り消し線</del>のようなものも可能です。

  <del>取り消し線</del>のようなものも可能です。

**段落**は、空白行で作成されます。もし、**強制的に改行**したいのであれば、行末にバックスラッシュを２つ加えるか、半角スペースを１つ加えてください。

これは、いくつかの行で成り立っているテキストです。\\ 注意してほしいのは、
バックスラッシュ２つは、行末でのみ有効ということです。\\
ただし、\\の後に半角スペースが続く場合は、改行されます。

  これは、いくつかの行で成り立っているテキストです。\\ 注意してほしいのは、
  バックスラッシュ２つは、行末でのみ有効ということです。\\
  ただし、\\の後に半角スペースが続く場合は、改行されます。

本当に必要な場合にのみ、強制的な改行を使用すべきです。


===== リンク =====

DokuWikiは複数の方法でリンクを作成することが可能です。


==== 外部リンク ====

外部リンクは、http://www.google.comや単純にwww.google.comのように自動的に認識されます。
[[http://www.google.com|Googleへのリンク]]のようにリンク名を含めることもできます。
メールアドレスも<andi@splitbrain.org>のように自動的にリンクします。

  外部リンクは、http://www.google.comや単純にwww.google.comのように自動的に認識されます。
  [[http://www.google.com|Googleへのリンク]]のようにリンク名を含めることもできます。
  メールアドレスも<andi@splitbrain.org>のように自動的にリンクします。


==== 内部リンク ====

内部リンクは、角かっこを使用して作成します。
単に[[:dokuwiki:ja:pagename]]でも、[[dokuwiki:ja:pagename|タイトルテキスト]]を加えて使用することもできます。
Wikiのページ名は、自動的に小文字に変換されます。特殊文字は使用できません。【訳者注】リンク先は英語です。

  外部リンクは、角かっこを使用して作成します。
  単に[[:dokuwiki:ja:pagename]]でも、[[:dokuwiki:ja:pagename|タイトルテキスト]]を加えて使用することもできます。
  Wikiのページ名は、自動的に小文字に変換されます。特殊文字は使用できません。

ページ名にコロンを使って、[[:dokuwiki:ja:namespaces]]と表記することもできます。

  ページ名にコロンを使って、[[:dokuwiki:ja:namespaces]]と表記することもできます。

名前空間に関する詳細は、[[doku>wiki:namespaces]](英語)を参照してください。

特定のセクションへのリンクも可能です。HTMLでおなじみのシャープ記号の後に、セクション名を加えるだけです。
このリンクは、[[syntax#internal|このセクション]]を参照しています。

  このリンクは、[[syntax#internal|このセクション]]を参照しています。

ノート:

  * [[:dokuwiki:ja:syntax|存在するページ]]は、[[:dokuwiki:ja:nonexisting|存在しないページ]]と異なる表示をします。
  * DokuWikiは、デフォルトで[[wp>CamelCase]]を自動的にリンクにする処理はしません。しかし、[[doku>wiki:config|設定]]ファイルで、有効にすることもできます。もし、DokuWikiがリンクになっている場合は、設定で有効になっています。
  * セクションの見出しを変更した場合、ブックマークも変更してください。なので、過度にセクションのリンクに頼らないでください。


==== Interwiki ====

DokuWikiは、[[doku>wiki:interwiki|Interwiki]]リンクをサポートしています。他のWikiに素早くリンクできます。例えば、
[[wp>Wiki]]では、Wikiに関するWikipediaのページが表示されます。

  DokuWikiは、[[doku>wiki:interwiki|Interwiki]]リンクをサポートしています。
  他のWikiに素早くリンクできます。例えば、[[wp>Wiki]]では、
  Wikiに関するWikipediaのページが表示されます。


==== Windows共有 ====

[[\\server\share|this]]のようにWindows共有を認識します。注意してほしいのは、これらが企業のイントラネット([[wp>Intranet]])のように同種のグループに属していないと意味をなさないということです。

  [[\\server\share|this]]のようにWindows共有を認識します。

注意:

  * セキュリティの理由から、Windows共有の直接閲覧は、デフォルトではマイクロソフトのInternet Explorerでしか動作しません。(そして「ローカルゾーン」のみです)
  * MozillaやFirefoxでは、設定オプションで有効にすることはできますが([[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]])、お勧めしません。
  * 追加情報は、[[bug>151]]をご覧ください。



==== 画像リンク ====

リンクの書式と[[#images_and_other_files|画像]](下記参照)と組み合わせて、別の内部または外部ページへのリンクに使用することもできます。

  [[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

注意：画像の書式は、リンク名として容認された書式文法のみです。

すべての[[#images_and_other_files|画像]]や[[#links|リンク]]の文法がサポートされます。
(画像のサイズ変更や内部および外部の画像、そしてURLやInterWikiのリンクが含まれます)


===== 脚注 =====

二重かっこを使うと脚注を加えることができます。((これが脚注です。))

  二重かっこを使うと脚注を加えることができます。((これが脚注です。))





===== セクション =====

５つの異なるレベルの見出しを使用することができます。もし、３つ以上の見出しを使っていたら、コンテンツのテーブルは自動的に作成されます。文書内に''<nowiki>~~NOTOC~~</nowiki>''という文字を含めると、無効にすることができます。


==== 第三見出し ====
=== 第四見出し ===
== 第五見出し ==

  ==== 第三見出し ====
  === 第四見出し ===
  == 第五見出し ==

マイナス記号を4つ以上使用すると、横罫線を引くことができます。

----

【訳者注】ずいぶん地味なところに説明があるものだなぁ。

===== イメージまたはその他のファイル =====

大かっこを使うと、外部または内部の[[doku>wiki:images|画像]]を含めることができます。サイズを変えることもできます。

実サイズ:                        {{wiki:dokuwiki-128.png}}

幅を指定:            {{wiki:dokuwiki-128.png?50}}

幅と高さを指定: {{wiki:dokuwiki-128.png?200x50}}

外部画像のリサイズ:           {{http://de3.php.net/images/php.gif?200x50}}

  実サイズ:                        {{wiki:dokuwiki-128.png}}
  幅を指定:            {{wiki:dokuwiki-128.png?50}}
  幅と高さを指定: {{wiki:dokuwiki-128.png?200x50}}
  外部画像のリサイズ:           {{http://de3.php.net/images/php.gif?200x50}}

右か左に半角スペースを入れると、寄せることもできます。

{{ wiki:dokuwiki-128.png}}

{{wiki:dokuwiki-128.png }}

{{ wiki:dokuwiki-128.png }}

  {{ wiki:dokuwiki-128.png}}
  {{wiki:dokuwiki-128.png }}
  {{ wiki:dokuwiki-128.png }}

もちろん、タイトル(多くのブラウザでは、ツールチップに表示される)も追記することもできます。

{{ wiki:dokuwiki-128.png |This is the caption}}

  {{ wiki:dokuwiki-128.png |This is the caption}}

もし、画像ファイル(''gif, jpeg, png'')ではないファイル名を指定した場合、リンクが表示されます。

画像で別のページにリンクしたい場合は、上記の[[#画像リンク]]を参照してください。




===== リスト =====

Dokuwikiは、数字付きリストと数字なしリストをサポートしています。リストを作成するには、行頭に半角スペースを２つ使用して字下げをし、数字なしの場合は''*''を、数字付きの場合は''-''を、一つ付けてください。

  * これがリストです。
  * 2つ目の項目です。
    * 別のレベルの項目です。\\ 改行もできます。
  * 別の項目です。

  - 同じリストですが、数字付きです。
  - 別の項目です。
    - 深い階層にするには字下げをするだけです。
    - スペースは２つ追加です。
  - 以上です。

<code>
  * これがリストです。
  * 2つ目の項目です。
    * 別のレベルの項目です。\\ 改行もできます。
  * 別の項目です。

  - 同じリストですが、数字付きです。
  - 別の項目です。
    - 深い階層にするには字下げをするだけです。
    - スペースは２つ追加です。
  - 以上です。
</code>



===== スマイリ =====

DokuWikiは、一般的に使われる[[wp>emoticon]]をグラフィカルなものに変換します。スマイリを''smiley''ディレクトリに置き、''conf/smileys.conf''ファイルを設定することで、より多くのスマイリを表示させることができます。下記のものは、DokuWikiに含まれるスマイリです。

  * 8-) %%  8-)  %%
  * 8-O %%  8-O  %%
  * :-( %%  :-(  %%
  * :-) %%  :-)  %%
  * =)  %%  =)   %%
  * :-/ %%  :-/  %%
  * :-\ %%  :-\  %%
  * :-? %%  :-?  %%
  * :-D %%  :-D  %%
  * :-P %%  :-P  %%
  * :-O %%  :-O  %%
  * :-X %%  :-X  %%
  * :-| %%  :-|  %%
  * ;-) %%  ;-)  %%
  * ^_^ %%  ^_^  %%
  * :?: %%  :?:  %%
  * :!: %%  :!:  %%
  * LOL %%  LOL  %%
  * FIXME %%  FIXME %% (修正)
  * DELETEME %% DELETEME %% (削除)




===== タイポグラフィ =====

[[DokuWiki]]は、単純な文字列で、特殊な文字へ変換することができます。以下は、認識する文字列の例です。

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

<code>
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
</code>

注意：[[doku>wiki:config#typography|設定オプション]](英語)や[[doku>wiki:entities|パターンファイル]](英語)で、この変換をオフにすることもできます。

===== 引用 =====

返信やコメントを表示するとき、テキストをマークしたいときがあるでしょう。そんなときは、以下の表記を使用してください。

  I think we should do it
  
  > No we shouldn't
  
  >> Well, I say we should
  
  > Really?
  
  >> Yes!
  
  >>> Then lets do it!

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!




===== テーブル =====

DokuWikiは、テーブル作成のためのシンプルな文法をサポートしています。

^ 見出し1      ^ 見出し2       ^ 見出し3          ^
| 行 1 列 1    | 行 1 列 2     | 行 1 列 3        |
| 行 2 列 1    | ２つの列にまたがっています ||
| 行 3 列 1    | 行 2 列 2     | 行 2 列 3        |

テーブルの列は、通常行で''|''を、見出し行で ''^''を使い、行頭と行末を囲む必要があります。
【訳者注】''|''は、アルファベットのl(エル)でも数字の１(いち)でもありません。また、''^''は、カタカナの「ヘ」ではありません。

  ^ 見出し1      ^ 見出し2       ^ 見出し3          ^
  | 行 1 列 1    | 行 1 列 2     | 行 1 列 3        |
  | 行 2 列 1    | ２つの列にまたがっています ||
  | 行 3 列 1    | 行 2 列 2     | 行 2 列 3        |

水平にセルを結合させるには、次のセルを上記のように空にします。セルの区切り文字の総数は同じになることを確認してください。

垂直にテーブルの見出しを指定することも可能です。

|            ^ 見出し1            ^ 見出し2          ^
^ 見出し3    | 行 1 列 2          | 行 1 列 3        |
^ 見出し4    | 今回は列をまたがっていません |        |
^ 見出し5    | 行 2 列 2          | 行 2 列 3        |

ご覧の通り、セルの区切りは、書式化で決まるセルの前になっています。

  |            ^ 見出し1            ^ 見出し2          ^
  ^ 見出し3    | 行 1 列 2          | 行 1 列 3        |
  ^ 見出し4    | 今回は列をまたがっていません |        |
  ^ 見出し5    | 行 2 列 2          | 行 2 列 3        |

注意：縦のセル(列)の結合はできません。

テーブルの項目を寄せることもできます。2つ以上の半角スペースを加えるだけです。左にスペースを入れると右寄せになり、右にスペースを入れると左寄せになります。両方にスペースを入れると中央寄せになります。

^           テーブルでの寄せ方             ^^^
|        右寄せ|   中央寄せ   |左寄せ        |
|左寄せ        |        右寄せ|   中央寄せ   |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

ソースで見るとこうなります。

  ^           テーブルでの寄せ方             ^^^
  |        右寄せ|   中央寄せ   |左寄せ        |
  |左寄せ        |        右寄せ|   中央寄せ   |
  | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

【訳者注】別に区切り文字を縦にそろえる必要はないようです。


===== 非解析ブロック =====

最低２つの半角スペースにより字下げすることで、文書内に非解析ブロックを含ませることができます(前述の例で使用したもののように)。または、''code''や''file''というタグを使用することでも非解析ブロックにすることができます。

<code>
これは、すべてのスペースを保持するコードを使用しています。              <-this
</code>

<file>
こちらもよく似たものですが、ファイルを引用を示すために使用します。
</file>

完全に解析させないためには(言い換えれば、何も書式化しない)、''nowiki''タグで両端を囲むか、パーセント記号を２つ「''<nowiki>%%</nowiki>''」で囲むと可能となる。

<nowiki>
これは、アドレスを含むテキストです。nowikiタグで囲ってあるので、http://www.splitbrain.org and **formatting**のように、何もしません。
</nowiki>

これらのブロックの使い方は、このページのソースを参照してください。



===== 文法強調 =====

[[DokuWiki]] は、ソースコードを強調し、可読性を高めることができます。[[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter(包括的文法強調)を使用しています。GeSHiは多くの言語をサポートしています。文法は、前述のセクションのコードブロックとよく似たものですが、こちらは使用される言語は、タグの中に挿入されます。例えば、''<nowiki><code java></nowiki>''のように指定します。

<code java>
/** 
 * The HelloWorldApp class implements an application that
 * simply displays "Hello World!" to the standard output.
 */
class HelloWorldApp {
    public static void main(String[] args) {
        System.out.println("Hello World!"); //Display the string.
    }
}
</code>

現在のところ、次にあげる言語の文字列が認識されます。
//actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html4strict, idl, ini, inno, java5, java, javascript, latex, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml//


===== 埋め込みHTMLとPHP =====

''html''や''php''というタグを使うと、文書内にHTMLとPHPのコードをそのまま埋め込むことができます。

<code>
<html>
This is some <font color="red" size="+1">HTML</font>
</html>
</code>

<html>
This is some <font color="red" size="+1">HTML</font>
</html>

<code>
<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>
</code>

<php>
echo 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

**注意**：埋め込みHTMLとPHPは、デフォルトで設定を無効にしてあります。もし無効であれば、実行されずにコードが表示されます。



===== 文法プラグイン =====

DokuWikiの文法は、[[doku>wiki:plugins|プラグイン]]で、拡張できます。インストールされたプラグインの使い方は、それぞれの解説ページをご覧ください。次にあげる文法プラグインが、このDokuwikiにインストールされ、有効になっています。

~~INFO:syntaxplugins~~