====== 整形記法 ======
文章の整形を行うには、シンプルなマークアップ記法を用います。
[[doku>DokuWiki]] の記法は、ソース自体もできるだけ読みやすくなるよう考慮されています。
画面の上部か下部にある //編集// ボタンをクリックすると、ページのソースを見ることができます。
このページでは、編集にあたって利用できる記法をすべて説明します。
ためしに編集をしてみたい場合には、 [[playground:playground|playground]] ページを使ってください。
主な記法は、[[doku>toolbar|quickbuttons]] からも利用できます。
===== 基本的なテキスト整形 =====
文字飾りとして **太字**、 //斜体//、 __下線__ 、''等幅'' を利用できます。
もちろん **__//''組み合わせる''//__** こともできます。
文字飾りとして **太字**、 //斜体//、 __下線__ 、''等幅'' を利用できます。
もちろん **__//''組み合わせる''//__** こともできます。
さらに 下付き と 上付き も使えます。
さらに 下付き と 上付き も使えます
取り消し線 も利用できます。
取り消し線 も利用できます。
空行をおくと、**段落** となります。
段落内で **強制的に改行** するには、バックスラッシュ(日本語環境では円記号¥)を 2 つ連ねた後に空白文字を置くか改行します。
この文は改行\\ を含んでいます。2 連バックスラッシュが改行として処理されるのは、空白文字が続く\\ か行の最後\\
にある場合だけで、\\それ以外はそのまま表示されます。
この文は改行\\ を含んでいます。2 連バックスラッシュが
改行として処理されるのは、空白文字が続く\\ か行の最後\\
にある場合だけで、\\それ以外はそのまま表示されます。
強制改行は、どうしても必要な場合だけ使ってください。
注:
* 改行に関して、プラグインによりEnterキーを押すだけで出来るようになりました。上記の記法は不要です。
===== リンク =====
リンクの記述には様々な方法があります。
==== 外部リンク ====
http://www.google.com や、よりシンプルに www.google.com のように文書中の URL は、外部リンクとして自動的に認識されます。
表題を指定して、[[http://www.google.com|googleへのリンク]] のようにもできます。
メールアドレスも、不等号で括ると、 のように自動的に認識されます。
http://www.google.com や、よりシンプルに www.google.com のように文書中の URL は、
外部リンクとして自動的に認識されます。表題を指定して、
[[http://www.google.com|googleへのリンク]] のようにもできます。
メールアドレスも、不等号で括ると、 のように自動的に認識されます。
==== 内部リンク ====
この DokuWiki 内のページへのリンクには 2 連角カッコを使います。
ページ名そのままで[[pagename]] とするか、[[pagename|表題]] を指定します。
この DokuWiki 内のページへのリンクには 2 連角カッコを使います。ページ名そのままで
[[pagename]] とするか、[[pagename|表題]] を指定します。
[[doku>pagename|ページ名]] は自動的に小文字に変換されます。特殊文字は使えません。
ページ名をコロンで区切ると [[some:namespaces]](名前空間)を利用できます。
ページ名をコロンで区切ると [[some:namespaces]](名前空間)を利用できます。
詳細は [[doku>namespaces]] をご覧ください。
ページ中の特定のセクションにリンクすることも可能です。
ハッシュ記号(#)に続けてセクション名を記述します。
[[syntax#internal|このセクション]] へのリンクです。
[[syntax#internal|このセクション]] へのリンクです。
注:
* [[syntax|既存のページ]] へのリンクと [[存在しないページ]] へのリンクとは表示が異なります。
* デフォルト設定では [[wp>CamelCase]] をリンクとして扱いません。[[doku>config]] ファイルで変更できます。もし、「DokuWiki」 がリンクになっていれば有効になっています。
* セクションの見出しが変更されると、そこへのリンク名も変化します。セクションへのリンクは多用しないほうが良いでしょう。
==== Interwiki ====
[[doku>Interwiki|Interwiki]] リンクも利用できます。
InterWikiは、他の Wiki に手軽にリンクを張るための方法です。
たとえば、[[wp>Wiki]] は Wikipedia のページへのリンクです。
[[doku>Interwiki]] リンクも利用できます。
InterWikiは、他の Wiki に手軽にリンクを張るための方法です。
たとえば、[[wp>Wiki]] は Wikipedia のページへのリンクです。
==== Windows共有フォルダ ====
Windows 共有フォルダも [[\\server\share|this]] のように使えます。
ただし、[[wp>Intranet|イントラネット]] 内のように、仲間内でしか正常に使えませんので、注意してください。
Windows 共有フォルダも [[\\server\share|this]] のように使えます。
注:
* セキュリティ上、Windows 共有フォルダを直接ブラウズできるのは、デフォルトでは Microsoft Internet Explorer(の「ローカルゾーン」)のみに限られます。
* Mozilla や Firefox では [[http://kb.mozillazine.org/Links_to_local_pages_do_not_work|MozillaZine Knowledge Base]] にあるような対処を行う[[https://www.dokuwiki.org/ja:syntax#%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E5%A4%89%E6%8F%9B|と有効にすることができます。
]]と有効にすることができます。しかし、Windows Shareを開こうとするとJavaScriptの警告が表示されます。この警告を(すべてのユーザーに対して)取り除くには、以下の行を''conf/lang/ja/lang.php''に記述してください(詳しくは[[doku>localization#changing_some_localized_texts_and_strings_in_your_installation|localization]]を参照してください):
==== 画像にリンク ====
リンク記法と [[#画像やその他のファイル|画像]] (後述)を組み合わせると、次のように、画像に内外部へのリンクをつけることができます。
[[http://php.net|{{wiki:dokuwiki-128.png}}]]
[[http://php.net|{{wiki:dokuwiki-128.png}}]]
注: リンクの表題については、この画像以外の整形記法は使えません。
[[#画像やその他のファイル|画像]] と [[#リンク|リンク]] の記法はすべてサポートされます
(画像のサイズ変更や、内外部イメージ、URL 指定や interwiki リンクなど)。
===== 脚注 =====
脚注 ((これが脚注です)) には、2 連の丸カッコを用います。
脚注 ((これが脚注です)) には、2 連の丸カッコを用います。
===== セクション見出し =====
最大 5 つのレベルまでの見出しを使って、文章の構造化を行えます。
3 つ以上の見出しを記述すると、目次が自動的に生成されます。
文書中に ''~~NOTOC~~'' という文字列を書くと目次の生成を止めることができます。
==== 第 3 見出し ====
=== 第 4 見出し ===
== 第 5 見出し ==
==== 第 3 見出し ====
=== 第 4 見出し ===
== 第 5 見出し ==
===== 水平線 =====
ダッシュ (-) を四つ以上続けると、水平線が書けます。
----
===== 画像やその他のファイル =====
波カッコを使って、[[doku>images|画像やその他のファイル]] を記述できます(画像ファイルが wiki 内部にあっても外部でもかまいません)。
オプションで、画像サイズも指定できます。
実サイズ: {{wiki:dokuwiki-128.png}}
幅を変更: {{wiki:dokuwiki-128.png?50}}
幅と高さを変更((画像のアスペクト比と指定された幅と高さの比が異なる場合は、リサイズされる前に新しいアスペクト比に切り抜かれます。)): {{wiki:dokuwiki-128.png?200x50}}
外部イメージのサイズを変更: {{https://www.php.net/images/php.gif?200x50}}
実サイズ: {{wiki:dokuwiki-128.png}}
幅を変更: {{wiki:dokuwiki-128.png?50}}
幅と高さを変更: {{wiki:dokuwiki-128.png?200x50}}
外部イメージのサイズを変更: {{https://www.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 |キャプションです}}
{{ wiki:dokuwiki-128.png |キャプションです}}
画像 (''gif,jpeg,png'') 以外のファイル名を指定すると(ファイルが内外部いずれでも)、そのファイルへのリンクとして表示されます。
画像を他のページへのリンクとするには、上記の [[#画像にリンク]] をご覧ください。
==== サポートされるメディア形式 =====
DokuWikiでは、以下のメディア形式を直接埋め込むことができます。
| 画像 | ''gif'', ''jpg'', ''png'' |
| 動画 | ''webm'', ''ogv'', ''mp4'' |
| 音声 | ''ogg'', ''mp3'', ''wav'' |
| フラッシュ | ''swf'' |
サポートされていないメディア形式を指定した場合、代わりにリンクとして表示されます。
''?linkonly''を追加することで、インライン表示せずにメディアへのリンクを提供します。
{{wiki:dokuwiki-128.png?linkonly}}
{{wiki:dokuwiki-128.png?linkonly}}これは単なる画像へのリンクです。
==== フォールバック・フォーマット ====
残念ながら、すべてのブラウザがすべてのビデオおよびオーディオ形式を理解しているわけではありません。
この問題を軽減するために、ブラウザの互換性を最大限に高めるために、異なる形式でファイルをアップロードすることができます。
たとえば、この埋め込みmp4ビデオを考えてみましょう。
{{video.mp4|面白いビデオ}}
参照されている ''video.mp4'' の隣に ''video.webm'' と ''video.ogv'' をアップロードすると、DokuWiki は自動的にこれらのファイルを代替ファイルとして追加します。
さらにDokuWikiは、動画が始まる前に表示される「ポスター」画像をサポートしています。
この画像はビデオと同じファイル名で、jpgまたはpngファイルである必要があります。
上記の例では、''video.jpg''ファイルが動作します。
===== リスト =====
リスト(番号付き・番号無し)を利用できます。行頭にスペースを 2 つ連ねた後に、''*'' (番号無し)または ''-'' (番号付き)を記述します。
* リストです
* 2番目の要素です
* 入れ子にもできます
* 次の要素です
- 番号付きリストです
- 次の要素です
- 入れ子にするにはインデントを深くします
- 以上です
* リストです
* 2番目の要素です
* 入れ子にもできます
* 次の要素です
- 番号付きリストです
- 次の要素です
- 入れ子にするにはインデントを深くします
- 以上です
[[doku>faq:lists|リストに関する FAQ]] も参照してください。
===== テキストの変換 =====
DokuWiki は特定の文字や文字列を、画像や他のテキスト、HTML などに変換することができます。
テキストから画像への変換機能は、主にスマイリーで使用されます。
テキストから HTML への変換機能は記号の変換に使用されますが、他の HTML に変換するように設定することもできます。
==== テキストから画像への変換 ====
DokuWiki は一般的に使用されている[[wp>emoticon|顔文字]]を、同じような見た目を持つ画像に変換します。
このような[[doku>smileys|スマイリー]]や他の画像は、独自の設定で拡張することもできます。
標準で使用できるスマイリーは以下の通りです。
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
==== テキストから HTML への変換 ====
記号: [[DokuWiki]] は、特定の文字列を活字表記的に同等な文字に変換することができます。以下に認識される文字列の例を示します。
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."
同様にして、どのような HTML でも[[doku>entities|パターンファイル]]を設定しておけば生成することができます。
パターンファイル設定による変換には、3 つの例外があります。
掛け算記号 (640x480)、'シングルクォート' および "ダブルクォート" です。
これらの変換は、[[doku>config:typography|設定オプション]]からオフにすることができます。
===== 引用 =====
ある文が、返信であったり、コメントであるということを表現したい場合もあります。その場合、次の記法を使います。
やった方が良いと思うけど。
> いや、やるべきではない!
>> まあ、やるべきでしょうね。
> ほんとに?
>> 本気です!
>>> では、やりましょう!
やった方が良いと思うけど。
> いや、やるべきではない!
>> まあ、やるべきでしょうね。
> ほんとに?
>> 本気です!
>>> では、やりましょう!
===== 表 =====
簡単な記法で表を作成できます。
^ 見出し 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 |
セルを水平に結合するには、上記のように、後のセルの中身を完全に無しにします。
セルの区切りとなる縦線やハット記号は、どの行も同じ数だけ必要ですので注意してください。
列見出しも可能です。
| ^ 見出し 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 |
行を結合することもできます。
行の結合をする場合は、結合対象セルの下のセルの中に ''%%:::%%'' という文字列を入力します。
^ 見出し1 ^ 見出し 2 ^ 見出し 3 ^
| 行 1 列 1 | 行の結合 | 行 1 列 3 |
| 行 2 列 1 | ::: | 行 2 列 3 |
| 行 3 列 1 | ::: | 行 2 列 3 |
これらのセルに ''%%:::%%'' 以外の文字列を入力することはできません。
^ 見出し 1 ^ 見出し 2 ^ 見出し 3 ^
| 行 1 列 1 | 行の結合 | 行 1 列 3 |
| 行 2 列 1 | ::: | 行 2 列 3 |
| 行 3 列 1 | ::: | 行 2 列 3 |
表の内容の配置を指定できます。
2個以上のスペースをテキストの反対側に置きます。
つまり、右揃えにするには左側に2個のスペースを、左揃えにするには右側に2個のスペースを置きます。
中央揃えにするにはテキストの両側に2個以上のスペースを置きます。
^ 配置を指定した表 ^^^
| 右| 中央 |左 |
|左 | 右| 中央 |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
上記のソースは次のようになります。
^ 配置を指定した表 ^^^
| 右| 中央 |左 |
|左 | 右| 中央 |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
注:縦アライメントには対応していません。
===== 整形の無効化 =====
もし入力した通りに (何も整形せずに) 表示する必要がある場合は、''%%%%'' タグか、よりシンプルに 2 つの連続したパーセント記号 ''%%'' で挟みます。
このテキストには http://www.splitbrain.org のようなアドレスや**整形記法**を含みますが、実際には何も整形されません。
同様に %%//__この__スマイリー付きの//テキスト ;-)%% も整形されません。
このテキストには http://www.splitbrain.org のようなアドレスや**整形記法**を含みますが、実際には何も整形されません。
同様に %%//__この__スマイリー付きの//テキスト ;-)%% も整形されません。
===== コードブロック =====
2 つ以上の半角スペースでインデントするか、''%%%%'' もしくは ''%%%%'' タグを使用することにより、コードブロックを記述することができます。
このテキストは 2 つの半角スペースによってインデントされています。
整形済みのコードです。スペースの数が次のように保持されます。例、 <- ここ
同様ですが、ファイルの内容を示すときに使います。
上記のブロックは以下のようなソースから作成されています。
このテキストは 2 つの半角スペースによってインデントされています。
整形済みのコードです。スペースの数が次のように保持されます。例、 <- ここ
同様ですが、ファイルの内容を示すときに使います。
==== 構文のハイライト ====
[[wiki:DokuWiki]]はソースコードの構文をハイライト表示して、読みやすくすることができます。
[[http://qbnz.com/highlighter/|GeSHi]] という汎用の構文ハイライトソフトを使用しており、GeSHi がサポートするすべての言語を扱うことができます。
記法は、前述したコードブロックと同様ですが、言語の名称を ''
'' や '''' のようにタグ内に記述します。
/**
* 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.
}
}
現在のところ、次の言語がサポートされています。//4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript3, actionscript, ada, aimms, algol68, apache, applescript, apt_sources, arm, asm, asp, asymptote, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, batch, bf, biblatex, bibtex, blitzbasic, bnf, boo, caddcl, cadlisp, ceylon, cfdg, cfm, chaiscript, chapel, cil, c_loadrunner, clojure, c_mac, cmake, cobol, coffeescript, c, cpp, cpp-qt, cpp-winapi, csharp, css, cuesheet, c_winapi, dart, dcl, dcpu16, dcs, delphi, diff, div, dos, dot, d, ecmascript, eiffel, email, epc, e, erlang, euphoria, ezt, f1, falcon, fo, fortran, freebasic, freeswitch, fsharp, gambas, gdb, genero, genie, gettext, glsl, gml, gnuplot, go, groovy, gwbasic, haskell, haxe, hicest, hq9plus, html, html4strict, html5, icon, idl, ini, inno, intercal, io, ispfpanel, java5, java, javascript, jcl, j, jquery, julia, kixtart, klonec, klonecpp, kotlin, latex, lb, ldif, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, mathematica, matlab, mercury, metapost, mirc, mk-61, mmix, modula2, modula3, mpasm, mxml, mysql, nagios, netrexx, newlisp, nginx, nimrod, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, octave, oobas, oorexx, oracle11, oracle8, oxygene, oz, parasail, parigp, pascal, pcre, perl6, perl, per, pf, phix, php-brief, php, pic16, pike, pixelbender, pli, plsql, postgresql, postscript, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, pys60, python, qbasic, qml, q, racket, rails, rbs, rebol, reg, rexx, robots, roff, rpmspec, rsplus, ruby, rust, sas, sass, scala, scheme, scilab, scl, sdlbasic, smalltalk, smarty, spark, sparql, sql, sshconfig, standardml, stonescript, swift, systemverilog, tclegg, tcl, teraterm, texgraph, text, thinbasic, tsql, twig, typoscript, unicon, upc, urbi, uscript, vala, vbnet, vb, vbscript, vedit, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, wolfram, xbasic, xml, xojo, xorg_conf, xpp, yaml, z80, zxbasic//
[[doku>syntax_highlighting|advanced options]]さらに、シンタックスハイライトには、行のハイライトや行番号の追加などがあります。
==== ダウンロード可能なコードブロック ====
前述の ''%%%%'' や ''%%%%'' タグを使用した場合、示されているコードをダウンロード可能にしたいと思われるかもしれません。
以下のように言語名の後にファイル名を記入することで、そのコードをダウンロード可能にすることができます。
構文のハイライトは不要だがダウンロードは可能にしたい場合は、''%%%%'' のように言語の名称としてハイフンマイナス (''-'') を使用してください。
===== RSS/ATOM フィードの取り込み =====
[[DokuWiki]]は外部のXMLフィードからのデータを統合できます。
XMLフィードの解析には [[http://simplepie.org/|SimplePie]] を使っています。
DokuWikiではSimplePieが解釈可能な全てのフォーマットが利用できます。
スペースで区切られた複数の引数で表示をカスタマイズできます:
^ パラメータ ^ 意 味 ^
| 数字 | 最大表示数。デフォルト8 |
| reverse | 表示順を逆にする。 |
| author | 作者を表示する。 |
| date | 日付を表示する。 |
| description | 概要を表示する。 含まれる全てのHTMLタグは無効になります。 |
| 数字[dhm] | 更新間隔。数字の後の文字の意味は d=日、h=時間、m=分。(例 12h = 12時間) |
更新間隔のデフォルトは4時間です。10分未満の値は10分として扱われます。
通常[[wiki:DokuWiki]]はページのキャッシュされたバージョンを提供しようとしますので、動的な外部の内容を含めるのは明らかに不適当です。
このパラメータによって、ページが最後に描画されてから//更新間隔//以上経っていたら[[wiki:DokuWiki]]はキャッシュを破棄して再描画をします。
デフォルトでは、フィードは日付順に新しいものから並べられます。
''reverse'' パラメータを使用して古い順に並べ替えたり、 あるいは ''nosort'' を使用してフィードをそのまま表示したりすることができます。
**例:**
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
===== 制御用のマクロ =====
いくつかの構文は、それ自身は出力されないものの、DokuWiki の動作に影響を及ぼします。以下のような制御用のマクロが利用可能です。
^ マクロ ^ 説明 |
| %%~~NOTOC~~%% | このマクロがページ上にあった場合、目次が生成されなくなります。 |
| %%~~NOCACHE~~%% | デフォルトでは、DokuWiki はすべての出力をキャッシュします。この動作は、場合によっては望まれないことがあります (%%%% タグが使用されている場合など)。このマクロを追加することにより、DokuWiki に毎回強制的にページを再描画させることができます。 |
===== 記法のプラグイン =====
DokuWiki の記法は、 [[doku>plugins|プラグイン]] を使って拡張することができます。
各プラグインの使用方法は、各プラグインの解説ページにあります。この DokuWiki では、次の記法プラグインが使用可能となっています。
~~INFO:syntaxplugins~~