ここでは、KonaWiki の Wiki 記法について紹介します。
Wiki 記法を使うと、見出しやリストなど文章を綺麗に整形して表示できます。
Wiki記法を代表的なものから１つずつ紹介していきます。
見出しを書くときは、行頭で「■」や「●」、「▲」の記号で書き始めます。
（※「□」「○」「△」でも同じ効果になります。）
ちなみに、これらの記号は、「しかく」や「まる」と書いて漢字変換できます。
■大見出し ●中見出し ▲小見出し
あるいは、PukiWiki や はてなダイアリーのように、行頭に「*」の記号から書き始めると見出しとして扱うことができます。
* 大見出し ** 中見出し *** 小見出し
【ヒント】見出しマークは、設定ファイルで変更することができます。
項目を列挙する時など、項目をリストで表示したい場合があります。
リストは、行頭で「・」から書き始めます。
▲来年の目標 ・マイペース ・しっかり日課をこなす ・早寝早起き
または「-」(ハイフン)で書き始めます。
* 今年の目標 - 頑張りすぎない - 継続こそ力なり - 睡眠をしっかりとる
リストは、記号「・」や「-」を重ねて書くことによりリストレベルを指定することもできます。
-レベル１ --レベル２ ---レベル３ ・レベル１ ・・レベル２ ・・・レベル３
また、番号つきリストを指定することもできます。番号つきリストでは、行頭に「+」(または、全角「＋」)からはじめます。
+ トマト + イチゴ + リンゴ
実際に表示したところ
レベルをつけることもできます。
+ 哺乳類 ++ イルカ ++ クジラ +++ シロナガスクジラ +++ マッコウクジラ ++ ウサギ + 爬虫類 ++ ヘビ ++ トカゲ
実際表示してみたところ
プログラムのソースコードなどを書くのに便利な記法があります。２つの方法が用意されています。はじめに、行頭を半角スペースで書き始める方法を紹介します。
KonaWiki 行頭を半角スペースではじめるとソースコードとして整形します。
<html><head>
<title> TEST </title>
</head><body> .. </body></html>
もう一つは、段落の頭を {{{ から書きはじめ }}}(改行) で終わるもので、ソースコードのブロックとして扱います。
{{{
<html><head>
<title> TEST </title>
</head><body> .. </body></html>
}}}
表を記述するには、段落の頭を「|」記号ではじめます。
|商品名 |値段 |せっけん|400円 |はみがき|300円
実際表示させてみたところ
| 商品名 | 値段 |
| せっけん | 400円 |
| はみがき | 300円 |
あるいは、CSVプラグインを使って以下のように記述することもできます。
{{{#csv
商品名, 値段
せっけん,400円
はみがき,300円
}}}
通常は使うことはありませんが、段落の頭で「>>>」からはじめると、
以下のような意味を付することができます。
>>>[+] プラスのマークがつきます。 >>>[-] マイナスのマークがつきます。
実際に表示させてみたところ
何かしら突っ込みをしたい場合には、段落の頭で「>」から書きはじめます。
> めがねをはずした本当のNさんは美しいのです > 知っていましたか？
実際表示させてみたところ
KonaWikiには、いろいろなプラグインが用意されています。プラグインを使うには、
行頭で「#」からはじめて、「#プラグイン名(引数)」の形式か、文の途中で「&プラグイン名(引数);」のように記述します。
最近更新されたエントリの一覧を表示します。 #recent 本文の文字数をカウントします。→ &count();
あるいは、全角で「♪プラグイン名～引数1～引数2～引数3...」の形式で指定することもできます。
感想をどうぞ: ♪コメント～記事の感想 記念に一言: ♪コメント～記念の一言
このソースコードのブロック記号の開始直後で {{{#name(args..) のように書くと、ソースコードを最後の引数としてプラグインを呼び出すことができます。
以下は、color プラグインの利用例です。
{{{#color(#ff0000)
赤色の文字でソースコードを表示します。
}}}
以下は、csv プラグインの利用例です。
{{{#csv
名前,年齢
まー,12
ちー,50
どな,23
}}}
名前 | 年齢 |
|---|---|
まー | 12 |
ちー | 50 |
どな | 23 |
プラグインについては、KonaWikiについて/標準プラグイン一覧をご覧ください。
行頭からはじめなくても、他のページへのリンクや、以下の「強調」、「URL」などインライン記号があると文中でも展開されます。
WIKIページの名前を以下のように記述すると、別のWIKIページへのリンクになります。
[[ページ名]]
ページのURLを指定して、リンクすることもできます。
[[タイトル:http://example.com]]
ページ名に別名をつけることができます。
[[タイトル:WIKIページ名]]
※このとき、ページに TODO というタグをつけておくと、リンクに色をつけて表示させることができます。
目次などリンクするWIKIページの情報を自動で表示させる場合、以下の書式のように記述することができます。
[[[ページ名]]]
これにより「ページ名＋付けられているタグ＋ページの一行目」という情報を表示させることができます。これは、プラグインの pageinfo を利用しても同じ意味になります。
以下の書式で書くと文字列を強調表示します。
- '' 強調したい文字列 '' - `` 強調したい文字列 `` - %% 強調したい文字列 %%
以下のように表示されます。
URLは自動的にリンクします。
行末に「~」の記号を書くと、強制的に改行します。