wiki-syntax
差分
このページの2つのバージョン間の差分を表示します。
両方とも前のリビジョン前のリビジョン | |||
wiki-syntax [2017/05/12 07:48] – hayashi | wiki-syntax [2017/05/12 07:48] (現在) – hayashi | ||
---|---|---|---|
行 1: | 行 1: | ||
+ | ====== DokuWiki整形記法 ====== | ||
+ | 文章の整形を行うには、シンプルなマークアップ記法を用います。 | ||
+ | [[doku> | ||
+ | 画面の上部か下部にある //編集// ボタンをクリックすると、ページのソースを見ることができます。 | ||
+ | このページでは、編集にあたって利用できる記法をすべて説明します。 | ||
+ | ためしに編集をしてみたい場合には、 [[playground: | ||
+ | 主な記法は、[[doku> | ||
+ | |||
+ | ===== 基本的なテキスト整形 ===== | ||
+ | |||
+ | 文字飾りとして **太字**、 // | ||
+ | もちろん **__//'' | ||
+ | |||
+ | 文字飾りとして **太字**、 // | ||
+ | もちろん **__//'' | ||
+ | |||
+ | さらに < | ||
+ | |||
+ | さらに < | ||
+ | |||
+ | < | ||
+ | |||
+ | < | ||
+ | |||
+ | 空行をおくと、**段落** となります。 | ||
+ | 段落内で **強制的に改行** するには、バックスラッシュ(日本語環境では円記号¥) | ||
+ | を 2 つ連ねた後に空白文字を置くか改行します。 | ||
+ | |||
+ | この文は改行\\ を含んでいます。2 連バックスラッシュが | ||
+ | 改行として処理されるのは、空白文字が続く\\ か行の最後\\ | ||
+ | にある場合だけで、\\それ以外はそのまま表示されます。 | ||
+ | |||
+ | この文は改行\\ を含んでいます。2 連バックスラッシュが | ||
+ | 改行として処理されるのは、空白文字が続く\\ か行の最後\\ | ||
+ | にある場合だけで、\\それ以外はそのまま表示されます。 | ||
+ | |||
+ | 強制改行は、どうしても必要な場合だけ使ってください。 | ||
+ | |||
+ | ===== リンク ===== | ||
+ | |||
+ | リンクの記述には様々な方法があります。 | ||
+ | |||
+ | ==== 外部リンク ==== | ||
+ | |||
+ | http:// | ||
+ | 外部リンクとして自動的に認識されます。表題を指定して、 | ||
+ | [[http:// | ||
+ | メールアドレスも、不等号で括ると、 < | ||
+ | |||
+ | http:// | ||
+ | 外部リンクとして自動的に認識されます。表題を指定して、 | ||
+ | [[http:// | ||
+ | メールアドレスも、不等号で括ると、 < | ||
+ | |||
+ | ==== 内部リンク ==== | ||
+ | |||
+ | この DokuWiki 内のページへのリンクには 2 連角カッコを使います。ページ名そのままで | ||
+ | [[doku> | ||
+ | |||
+ | この DokuWiki 内のページへのリンクには 2 連角カッコを使います。ページ名そのままで | ||
+ | [[pagename]] とするか、[[pagename|表題]] を指定します。 | ||
+ | |||
+ | [[ja: | ||
+ | |||
+ | ページ名をコロンで区切ると [[some: | ||
+ | |||
+ | ページ名をコロンで区切ると [[some: | ||
+ | |||
+ | 詳細は [[doku> | ||
+ | |||
+ | ページ中の特定のセクションにリンクすることも可能です。ハッシュ記号(# | ||
+ | [[syntax# | ||
+ | |||
+ | [[syntax# | ||
+ | |||
+ | 注: | ||
+ | |||
+ | * [[syntax|既存のページ]] へのリンクと [[存在しないページ]] へのリンクとは表示が異なります。 | ||
+ | * デフォルト設定では [[wp> | ||
+ | * セクションの見出しが変更されると、そこへのリンク名も変化します。セクションへのリンクは多用しないほうが良いでしょう。 | ||
+ | |||
+ | ==== Interwiki ==== | ||
+ | |||
+ | [[doku> | ||
+ | InterWikiは、他の Wiki に手軽にリンクを張るための方法です。たとえば、 | ||
+ | [[wp> | ||
+ | |||
+ | [[doku> | ||
+ | InterWikiは、他の Wiki に手軽にリンクを張るための方法です。たとえば、 | ||
+ | [[wp> | ||
+ | |||
+ | ==== Windows共有フォルダ ==== | ||
+ | |||
+ | Windows 共有フォルダも [[\\server\share|this]] のように使えます。 | ||
+ | ただし、[[wp> | ||
+ | |||
+ | Windows 共有フォルダも [[\\server\share|this]] のように使えます。 | ||
+ | |||
+ | 注: | ||
+ | |||
+ | * セキュリティ上、Windows 共有フォルダを直接ブラウズできるのは、デフォルトでは Microsoft Internet Explorer(の「ローカルゾーン」)のみに限られます。 | ||
+ | * Mozilla や Firefox では [[http:// | ||
+ | |||
+ | ==== 画像にリンク ==== | ||
+ | |||
+ | リンク記法と [[# | ||
+ | 次のように、画像に内外部へのリンクをつけることができます。 | ||
+ | |||
+ | | ||
+ | |||
+ | [[http:// | ||
+ | |||
+ | 注: リンクの表題については、この画像以外の整形記法は使えません。 | ||
+ | [[# | ||
+ | (画像のサイズ変更や、内外部イメージ、URL 指定や interwiki リンクなど)。 | ||
+ | |||
+ | ===== 脚注 ===== | ||
+ | |||
+ | 脚注 ((これが脚注です)) には、2 連の丸カッコを用います。 | ||
+ | |||
+ | 脚注 ((これが脚注です)) には、2 連の丸カッコを用います。 | ||
+ | |||
+ | |||
+ | |||
+ | ===== セクション見出し ===== | ||
+ | |||
+ | 最大 5 つのレベルまでの見出しを使って、文章の構造化を行えます。 | ||
+ | 3 つ以上の見出しを記述すると、目次が自動的に生成されます。 | ||
+ | 文書中に ''< | ||
+ | 目次の生成を止めることができます。 | ||
+ | |||
+ | ==== 第 3 見出し ==== | ||
+ | === 第 4 見出し === | ||
+ | == 第 5 見出し == | ||
+ | |||
+ | ==== 第 3 見出し ==== | ||
+ | === 第 4 見出し === | ||
+ | == 第 5 見出し == | ||
+ | |||
+ | ===== 水平線 ===== | ||
+ | |||
+ | ダッシュ (-) を四つ以上続けると、水平線が書けます。 | ||
+ | |||
+ | ---- | ||
+ | |||
+ | |||
+ | ===== 画像やその他のファイル ===== | ||
+ | |||
+ | 波カッコを使って、[[doku> | ||
+ | |||
+ | 実サイズ: | ||
+ | |||
+ | 幅を変更: | ||
+ | |||
+ | 幅と高さを変更((画像のアスペクト比と指定された幅と高さの比が異なる場合は、リサイズされる前に新しいアスペクト比に切り抜かれます。)): | ||
+ | |||
+ | 外部イメージのサイズを変更: | ||
+ | |||
+ | 実サイズ: | ||
+ | 幅を変更: | ||
+ | 幅と高さを変更: | ||
+ | 外部イメージのサイズを変更: | ||
+ | |||
+ | 左右にスペース文字を記述すると、配置位置を指定できます。 | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{wiki: | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{ wiki: | ||
+ | {{wiki: | ||
+ | {{ wiki: | ||
+ | |||
+ | さらに、タイトルも指定できます(ほとんどのブラウザで、ツールチップで表示されます)。 | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | {{ wiki: | ||
+ | |||
+ | 画像 ('' | ||
+ | |||
+ | 画像を他のページへのリンクとするには、上記の [[# | ||
+ | |||
+ | ===== リスト ===== | ||
+ | |||
+ | リスト(番号付き・番号無し)を利用できます。行頭にスペースを 2 つ連ねた後に、'' | ||
+ | |||
+ | * リストです | ||
+ | * 2番目の要素です | ||
+ | * 入れ子にもできます | ||
+ | * 次の要素です | ||
+ | |||
+ | - 番号付きリストです | ||
+ | - 次の要素です | ||
+ | - 入れ子にするにはインデントを深くします | ||
+ | - 以上です | ||
+ | |||
+ | < | ||
+ | * リストです | ||
+ | * 2番目の要素です | ||
+ | * 入れ子にもできます | ||
+ | * 次の要素です | ||
+ | |||
+ | - 番号付きリストです | ||
+ | - 次の要素です | ||
+ | - 入れ子にするにはインデントを深くします | ||
+ | - 以上です | ||
+ | </ | ||
+ | |||
+ | [[doku> | ||
+ | |||
+ | ===== テキストの変換 ===== | ||
+ | |||
+ | DokuWiki は特定の文字や文字列を、画像や他のテキスト、HTML などに変換することができます。 | ||
+ | |||
+ | テキストから画像への変換機能は、主にスマイリーで使用されます。テキストから HTML への変換機能は記号の変換に使用されますが、他の HTML に変換するように設定することもできます。 | ||
+ | |||
+ | ==== テキストから画像への変換 ==== | ||
+ | |||
+ | DokuWiki は一般的に使用されている[[wp> | ||
+ | |||
+ | * 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 ' | ||
+ | |||
+ | < | ||
+ | -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) | ||
+ | "He thought ' | ||
+ | </ | ||
+ | |||
+ | 同様にして、どのような HTML でも[[doku> | ||
+ | |||
+ | パターンファイル設定による変換には、3 つの例外があります。掛け算記号 (640x480)、' | ||
+ | |||
+ | ===== 引用 ===== | ||
+ | |||
+ | ある文が、返信であったり、コメントであるということを表現したい場合もあります。その場合、次の記法を使います。 | ||
+ | |||
+ | やった方が良いと思うけど。 | ||
+ | | ||
+ | > いや、やるべきではない! | ||
+ | | ||
+ | >> まあ、やるべきでしょうね。 | ||
+ | | ||
+ | > ほんとに? | ||
+ | | ||
+ | >> 本気です! | ||
+ | | ||
+ | >>> | ||
+ | |||
+ | やった方が良いと思うけど。 | ||
+ | |||
+ | > いや、やるべきではない! | ||
+ | |||
+ | >> まあ、やるべきでしょうね。 | ||
+ | |||
+ | > ほんとに? | ||
+ | |||
+ | >> 本気です! | ||
+ | |||
+ | >>> | ||
+ | |||
+ | |||
+ | ===== 表 ===== | ||
+ | |||
+ | 簡単な記法で表を作成できます。 | ||
+ | |||
+ | ^ 見出し 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 | 行の結合 | ||
+ | | 行 2 列 1 | ::: | 行 2 列 3 | | ||
+ | | 行 3 列 1 | ::: | 行 2 列 3 | | ||
+ | |||
+ | これらのセルに '':::'' | ||
+ | |||
+ | ^ 見出し 1 ^ 見出し 2 ^ 見出し 3 ^ | ||
+ | | 行 1 列 1 | 行の結合 | ||
+ | | 行 2 列 1 | ::: | 行 2 列 3 | | ||
+ | | 行 3 列 1 | ::: | 行 2 列 3 | | ||
+ | |||
+ | 表の内容の配置を指定できます。2個以上のスペースをテキストの反対側に置きます。 | ||
+ | つまり、右揃えにするには左側に2個のスペースを、左揃えにするには右側に2個のスペースを置きます。 | ||
+ | 中央揃えにするにはテキストの両側に2個以上のスペースを置きます。 | ||
+ | |||
+ | ^ 配置を指定した表 | ||
+ | | 右| 中央 | ||
+ | |左 | 右| 中央 | ||
+ | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
+ | |||
+ | 上記のソースは次のようになります。 | ||
+ | |||
+ | ^ 配置を指定した表 | ||
+ | | 右| 中央 | ||
+ | |左 | 右| 中央 | ||
+ | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | | ||
+ | |||
+ | |||
+ | ===== 整形の無効化 ===== | ||
+ | |||
+ | もし入力した通りに (何も整形せずに) 表示する必要がある場合は、'' | ||
+ | |||
+ | < | ||
+ | このテキストには http:// | ||
+ | </ | ||
+ | 同様に %%// | ||
+ | |||
+ | < | ||
+ | このテキストには http:// | ||
+ | </ | ||
+ | 同様に %%// | ||
+ | |||
+ | ===== コードブロック ===== | ||
+ | |||
+ | 2 つ以上の半角スペースでインデントするか、'' | ||
+ | |||
+ | このテキストは 2 つの半角スペースによってインデントされています。 | ||
+ | |||
+ | < | ||
+ | 整形済みのコードです。スペースの数が次のように保持されます。例、 | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | 同様ですが、ファイルの内容を示すときに使います。 | ||
+ | </ | ||
+ | |||
+ | 上記のブロックは以下のようなソースから作成されています。 | ||
+ | |||
+ | このテキストは 2 つの半角スペースによってインデントされています。 | ||
+ | |||
+ | < | ||
+ | 整形済みのコードです。スペースの数が次のように保持されます。例、 | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | 同様ですが、ファイルの内容を示すときに使います。 | ||
+ | </ | ||
+ | |||
+ | |||
+ | ===== 整形の無効化 ===== | ||
+ | |||
+ | もし入力した通りに (何も整形せずに) 表示する必要がある場合は、'' | ||
+ | |||
+ | < | ||
+ | このテキストには http:// | ||
+ | </ | ||
+ | 同様に %%// | ||
+ | |||
+ | < | ||
+ | このテキストには http:// | ||
+ | </ | ||
+ | 同様に %%// | ||
+ | |||
+ | ===== コードブロック ===== | ||
+ | |||
+ | 2 つ以上の半角スペースでインデントするか、'' | ||
+ | |||
+ | このテキストは 2 つの半角スペースによってインデントされています。 | ||
+ | |||
+ | < | ||
+ | 整形済みのコードです。スペースの数が次のように保持されます。例、 | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | 同様ですが、ファイルの内容を示すときに使います。 | ||
+ | </ | ||
+ | |||
+ | 上記のブロックは以下のようなソースから作成されています。 | ||
+ | |||
+ | このテキストは 2 つの半角スペースによってインデントされています。 | ||
+ | |||
+ | < | ||
+ | 整形済みのコードです。スペースの数が次のように保持されます。例、 | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | 同様ですが、ファイルの内容を示すときに使います。 | ||
+ | </ | ||
+ | |||
+ | ==== 構文のハイライト ==== | ||
+ | |||
+ | ソースコードの構文をハイライト表示して、読みやすくすることができます。[[http:// | ||
+ | |||
+ | <code java> | ||
+ | /** | ||
+ | * The HelloWorldApp class implements an application that | ||
+ | * simply displays "Hello World!" | ||
+ | */ | ||
+ | class HelloWorldApp { | ||
+ | public static void main(String[] args) { | ||
+ | System.out.println(" | ||
+ | } | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | 現在のところ、次の言語がサポートされています。// | ||
+ | |||
+ | ==== ダウンロード可能なコードブロック ==== | ||
+ | |||
+ | 前述の '' | ||
+ | |||
+ | < | ||
+ | <file php myexample.php> | ||
+ | <?php echo "hello world!"; | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | <file php myexample.php> | ||
+ | <?php echo "hello world!"; | ||
+ | </ | ||
+ | |||
+ | 構文のハイライトは不要だがダウンロードは可能にしたい場合は、'' | ||
+ | |||
+ | ===== HTML や PHP の埋込み ===== | ||
+ | |||
+ | '' | ||
+ | |||
+ | HTML の例: | ||
+ | |||
+ | < | ||
+ | < | ||
+ | これは <span style=" | ||
+ | </ | ||
+ | < | ||
+ | <p style=" | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | < | ||
+ | これは <span style=" | ||
+ | </ | ||
+ | < | ||
+ | <p style=" | ||
+ | </ | ||
+ | |||
+ | |||
+ | PHP の例: | ||
+ | |||
+ | < | ||
+ | <php> | ||
+ | echo 'PHP によって生成されたロゴ:'; | ||
+ | echo '< | ||
+ | echo '(HTML インライン要素を生成)'; | ||
+ | </ | ||
+ | <PHP> | ||
+ | echo '< | ||
+ | echo '< | ||
+ | echo '</ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | **注**: HTML と PHP の埋込みはデフォルトの設定では無効になっています。無効のままですと、コードは実行されずにそのまま表示されます。 | ||
+ | |||
+ | ===== RSS/ATOM フィードの取り込み ===== | ||
+ | [[DokuWiki]]は外部のXMLフィードからのデータを統合できます。XMLフィードの解析には [[http:// | ||
+ | ^ パラメータ | ||
+ | | 数字 | ||
+ | | reverse | ||
+ | | author | ||
+ | | date | 日付を表示する。 | | ||
+ | | description | 概要を表示する。 含まれる全てのHTMLタグは無効になります。 | | ||
+ | | 数字[dhm] | ||
+ | |||
+ | 更新間隔のデフォルトは4時間です。10分未満の値は10分として扱われます。通常[[DokuWiki]]はページのキャッシュされたバージョンを提供しようとしますので、動的な外部の内容を含めるのは明らかに不適当です。このパラメータによって、ページが最後に描画されてから// | ||
+ | |||
+ | **例:** | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | {{rss> | ||
+ | |||
+ | ===== 制御用のマクロ ===== | ||
+ | |||
+ | いくつかの構文は、それ自身は出力されないものの、DokuWiki の動作に影響を及ぼします。以下のような制御用のマクロが利用可能です。 | ||
+ | |||
+ | ^ マクロ | ||
+ | | %%~~NOTOC~~%% | ||
+ | | %%~~NOCACHE~~%% | デフォルトでは、DokuWiki はすべての出力をキャッシュします。この動作は、場合によっては望まれないことがあります (%%< | ||
+ | |||
+ | ===== 記法のプラグイン ===== | ||
+ | |||
+ | DokuWiki の記法は、 [[doku> | ||
+ | |||
+ | ~~INFO: |