テキスト整形のルール
通常は入力した文章がそのまま出力されます。
- HTMLのタグは効果がありません。書かれた文章はそのまま(「<font color="red">text</font>」といった形のまま)表示されます
- 段落と段落の区切りには空行をはさんで下さい。空行をはさまず、連続している複数の行は同じ段落と解釈されます (連結して表示されます)
これに加えて、特定のルールによるテキスト整形を行うことができます。以下では、プラグインについてはよく使われるものだけを簡略に説明しています。プラグインのオプションなど詳細な説明については PyukiWiki/プラグイン を参照してください。
基本ルール
- 連続した複数行は連結されます。
- 行末に~を書くと行末改行になります。
- 空行は段落の区切りとなります。
- 行頭がスペースで始まっていると、その段落は整形済みとして扱われます。
- HTMLのタグは書けません。すべて 表示できる文字に変換されます。
文字飾り
- シングルクォート2個ではさんだ部分は、ボールドになります。
- シングルクォート3個ではさんだ部分は、イタリックになります。
目次
#contents行頭で #contents を記述すると、見出しに基づいて目次を作成します。一般的に #contents はページの最初のほうに記述します。
左寄せ・センタリング・右寄せ
LEFT:インライン要素 CENTER:インライン要素 RIGHT:インライン要素行頭で LEFT:、 CENTER:、 RIGHT: を記述すると、インライン要素が左寄せ、センタリング、右寄せさ]れます。
文字サイズ
&size(サイズ){インライン要素}; SIZE(サイズ){インライン要素};行中に &size を書くとインライン要素の文字サイズを指定することができます。サイズはピクセル単位(px)で指定します。例えば20を指定すると、20ピクセルの文字の大きさになります。
- 文字サイズは、他のインライン要素の子要素になることができます。
- 文字サイズは、他のインライン要素を子要素にすることができます。
文字色
&color(文字色[,背景色]){インライン要素}; COLOR(文字色){インライン要素};行中に &color と書くとインライン要素の&color(crimson){文字色};と背景色を指定することができます。背景色は省略できます。
- 色の指定は、次のいずれかの形式で行ないます。
- 色キーワード?
- #16進数6桁
- #16進数3桁
見出し
- アスタリスク(*)を行頭に書くと、大見出しになります。
- アスタリスク2個(**)を行頭に書くと、中見出しになります。
- アスタリスク3個(***)を行頭に書くと、小見出しになります。
- アスタリスクは5個までつけることができます。
- 見出しがあると自動的に目次が作られます。
リスト構造、引用文、水平線
- マイナス(-)を行頭に書くと、番号なしリストになります。- -- --- の3レベルがあります。
- プラス(+)を行頭に書くと、番号付リストになります。+ ++ +++ の3レベルがあります。
- > を行頭に書くと、引用文が書けます。> >> >>> >>>> >>>>>の5レベルがあります。
- マイナス4個(----)を行頭に書くと、水平線になります。
- 行頭で #hr を記述すると、区切り線になります。区切り線は上位のブロック要素の幅の60%の長さの水平線がセンタリングされて引かれます。
行間空け
行頭で #br を記述すると、ブロック要素間またはブロック要素内で行間を開けることができます*1。
強制改行
要素中にと記述すると、要素内でも改行することができます。
ハイパーリンク
- http://pyukiwiki.sourceforge.jp/ のようなURLは自動的にリンクになります。
- PyukiWikiのように大文字小文字を混ぜた英文字列を書くと、PyukiWikiのページ名になります。*2
- 二重の大かっこ でくくった文字列を書くと、PyukiWikiのページ名になります。大かっこの中の先頭・最後にはスペースを含めてはいけません。日本語も使えます。
用語解説
- コロン(:)を行頭に書くと、用語と解説文が作れます。以下のようにします。
:用語1:いろいろ書いた解説文1 :用語2:いろいろ書いた解説文2 :用語3:いろいろ書いた解説文3
- 用語1
- いろいろ書いた解説文1
- 用語2
- いろいろ書いた解説文2
- 用語3
- いろいろ書いた解説文3
テーブル
- コンマ(,)を行頭に書くと、テーブル(表)が作れます。以下のようにします。
, Wikiの名前 , 作者 , URL ,Wiki,Ward Cunningham,http://www.c2.com/ ,PyukiWiki,Nekyo,http://pyukiwiki.sourceforge.jp/ ,YukiWiki,Hiroshi Yuki,http://www.hyuki.com/ ,WalWiki,Makio Tsukamoto,http://digit.que.ne.jp/
Wikiの名前 | 作者 | URL |
Wiki | Ward Cunningham | http://www.c2.com/ |
PyukiWiki? | Nekyo | http://pyukiwiki.sourceforge.jp/ |
YukiWiki? | Hiroshi Yuki | http://www.hyuki.com/ |
WalWiki? | Makio Tsukamoto | http://digit.que.ne.jp/ |
- | | で挟み込んでも、テーブル(表)が作れます。以下のようにします。
| Wikiの名前 | 作者 | URL |h |Wiki|Ward Cunningham|http://www.c2.com/| |PyukiWiki|Nekyo|http://pyukiwiki.sourceforge.jp/| |YukiWiki|Hiroshi Yuki|http://www.hyuki.com/| |WalWiki|Makio Tsukamoto|http://digit.que.ne.jp/|
Wikiの名前 | 作者 | URL |
Wiki | Ward Cunningham | http://www.c2.com/ |
PyukiWiki? | Nekyo | http://pyukiwiki.sourceforge.jp/ |
YukiWiki? | Hiroshi Yuki | http://www.hyuki.com/ |
WalWiki? | Makio Tsukamoto | http://digit.que.ne.jp/ |
- 各要素の先頭に下記の記述子を指定できます。
LEFT: CENTER: RIGHT: BGCOLOR(色): COLOR(色): SIZE(サイズ):
- 要素の表示位置及び背景色・文字色・文字サイズ(px単位)を指定します。デフォルトは左寄せになります。 -
表組みの | 各セルの要素の配置に | 関するサンプル |
左寄せ | センタリング | 右寄せ |
右寄せ | 左寄せ | センタリング |
- 行末にcを記述すると、書式指定行となります。書式指定行では、次の記述子が指定できます。
LEFT: CENTER: RIGHT: BGCOLOR(色): COLOR(色): SIZE(サイズ):
-
記述子の後ろに数値を記述すると、セル幅がpx単位で指定できます。
- 行末にhを記述すると、ヘッダ行(thead)になります。
- 行末にfを記述すると、フッタ行(tfoot)になります。
- セル内のインライン要素の先頭に~を付けると、ヘッダ(th)になります。
- セル内に > を単独で記述すると右のセルと連結します(colspan)。
-
セル内に ~ を単独で記述すると上のセルと連結します(rowspan)。
整形済みテキスト
行頭が半角空白で始まる行は整形済みテキストとなります。行の自動折り返しは行なわれません。
注釈
((インライン要素))行中でインライン要素を *3が作成され、行中に注釈へのリンクが貼られます。
- 注釈は、他のインライン要素の子要素になることができます。親要素は注釈文ではなく、注釈へのリンクに反映されます。
- 注釈は、他のインライン要素を子要素にすることができます。子要素は注釈文に反映されます。
上付、下付テキスト
- ^2つで包むと上付きになります。
2^^2^^=422=4 と表示されます。
- _2つで包むと下付きになります。
11001011__2__=0xa9110010112=0xa9 と表示されます。
YukiWiki, PukiWiki との互換性を重視される方は sub, sup プラグインが用意されていますので、そちらを参照して下さい。
2&sup(2);=422=4 と表示されます。
11001011&sub(2);=0xa9110010112=0xa9 と表示されます。
上付、下付テキスト
- ^2つで包むと上付きになります。
2^^2^^=422=4 と表示されます。
- _2つで包むと下付きになります。
11001011__2__=0xa9110010112=0xa9 と表示されます。
YukiWiki, PukiWiki との互換性を重視される方は sub, sup プラグインが用意されていますので、そちらを参照して下さい。
2&sup(2);=422=4 と表示されます。
11001011&sub(2);=0xa9110010112=0xa9 と表示されます。
バーベイタム機能
- --( と --) でくくられた行は書いたまま表示されますが、リンクや文字飾りは有効です(バーベイタム・ソフト)。
- ---( と ---) でくくられた行はリンクや文字飾りも無視されて書いたまま表示されます(バーベイタム・ハード)。
添付ファイル・画像の貼り付け
#ref(添付ファイル名) #ref(ファイルのURL)行頭で #ref を記述すると、添付ファイルまたは指定されたURLにあるファイルへのリンクを貼り付けることができます。ファイルが画像ファイルの場合は、その画像を表示します。
- #ref には、カンマで区切って下記のパラメタを指定できます。パラメタを省略した場合はデフォルト値となります。
添付ファイルのページ
- 添付ファイルが存在するページ名を指定します。デフォルトは現在のページです。
- このパラメタを指定する場合は、添付ファイル名の次に記述します。 -
left center right
- ファイルへのリンク・画像を表示する位置を指定します。デフォルトではセンタリングされます。 -
wrap nowrap
- ファイルへのリンク・画像を枠で囲むかどうかを指定します。デフォルトは囲みません。 -
around
- テキストの回り込みを指定します。デフォルトでは回り込みを行ないません。 -
nolink
- デフォルトでは添付ファイルへのリンクが張られますが、nolinkを指定するとリンクを張りません。 -
代替文字列
- ファイル名の代わりに表示する文字列や画像の代替文字列を指定できます。指定しない場合は、ファイル名になります。
- 代替文字列には文字列以外のインライン要素を含めることはできません。ページ名、文字列以外のインライン要素を記述しても文字列として扱われます。
- このパラメタを指定する場合は、最後に記述します。
テキストの回り込みの解除
#clear行頭で #clear を記述すると、 #ref で指定したテキストの回り込みを解除します。 #clear を指定しなくても、記事の末尾でテキストの回り込みが自動的に解除されます。
フォーム
#comment行頭で #comment を記述すると、コメントを挿入するためのフォームが埋め込まれます。
#article行頭で#articleを記述すると、簡易掲示板のフォームが埋め込まれます。
#vote(選択肢1,選択肢2,...)行頭で #vote を記述すると、簡易投票フォームが埋め込まれます。
- 選択肢は文字列、ページ名、InterWiki?、リンクを含めることができます。その他のインライン要素を含めることができません。
ルビ構造
&ruby(ルビ){インライン要素};行中で &ruby を書くとインライン要素に対するルビをふることができます。ルビに対応していないブラウザではルビが本文中に ( と ) に囲まれて表示されます。
- ルビ構造のルビにはインライン要素を記述します。ただし、ルビの特性上、期待通りの表示になるとは限りません。
- 注釈内や文字サイズを小さくしている部分での使用は、ルビが判読できなくなるので避けてください。
アンカーの設定
&aname(アンカー名); &aname(アンカー名){インライン要素};行中で &aname を記述するとリンクのアンカーを設定することができます。リンクの飛び先にしたい位置に記述します。
- アンカー名は、半角アルファベットから始まる半角アルファベット・数字・ハイフン・アンダースコアからなる文字列を指定します。
- アンカー名の中には、全角文字や半角空白文字、半角記号を含めることはできません。
カウンタ表示
&counter; &counter(オプション);行中で &counter を記述するとそのページにアクセスした人の数を表示することができます。
- &counter には次のオプションを指定できます。オプションを省略した場合はtotalが指定されたものとみなされます。
today
- 今日のアクセス数を表示します。 -
yesterday
- 昨日のアクセス数を表示します。 -
total
- アクセス総数を表示します。
オンライン表示
&online;行中で &online を記述すると現在アクセス中の人数を表示することができます。
WikiName
WikiName行中で、1つ以上の大文字→1つ以上の小文字→1つ以上の大文字→1つ以上の小文字の組合わせからなる半角//文字列はWikiNameになります。
- WikiNameの中には、全角文字や半角空白文字、記号、数字を含めることはできません。
- WikiNameは、PukiWiki?内のページ名になります。すでに存在するページであればそのページへのリンクが自動的に貼られます。存在しない場合はWikiNameの後ろに?が自動的に付き、そのページを新規作成するためのリンクが貼られます。
ページ名
[[ぷきうぃき]]行中で と で囲まれた文字列はページ名になります。
- ページ名の中には、全角文字、記号、数字、半角空白文字を含めることができます。
- ページ名の中には、"#&<> を含めることはできません。
- すでに存在するページであればそのページへのリンクが自動的に貼られます。存在しない場合はページ名の後ろに?が自動的に付き、そのページを新規作成するためのリンクが貼られます。
[[ページ名#アンカー名]]
- ページ名にアンカー名をつけることもできます。
InterWiki?
[[InterWikiName:ページ名]]行中のページ名形式の文字列の中で、: で2つの文字列を区切るとInterWiki?になります。:の前にはInterWikiNameのページで定義したInterWikiNameを、: の後ろにはページ名を記述します。
[[InterWikiName:ページ名#アンカー名]]
- ページ名の後ろにアンカー名をつけることもできます。
- InterWikiNameの中には、全角文字を含めることができます。
- InterWikiNameの中には、半角空白文字を含めるができます。
- InterWiki?は、他のインライン要素の子要素になることができます。
- InterWiki?は、他のインライン要素を子要素にはできません。
リンク
[[リンク名:URL]]行中のInterWikiNameの形式の文字列の中で、: の前に任意のリンク名を、: の後ろにURLを記述すると、そのリンク名でURLに対するリンクを貼ることができます。
- リンク名には、全角文字や半角空白文字を含めることができます。メールアドレスを指定する場合は、mailto:を書かずにアドレスだけを記述します。
http://www.example.com/ https://www.example.com/ ftp://ftp.example.com/ news://news.example.com/ <foo (at) example (dot) com>
- 行中に直接、URLを記述した場合は自動的にそのURLに対するリンクが貼られます。
- 記述したURLが画像ファイルである場合は、その画像を表示します。
エイリアス
[[エイリアス名>ページ名]]行中のページ名形式の文字列の中で、> で2つの文字列を区切るとエイリアスになります。 > の前にはエイリアス名を、> の後ろにはページ名を記述します。
エイリアスはPukiWiki?内のページ名とは別のエイリアス名で、指定したページへのリンクを貼ります。
[[エイリアス名>ページ名#アンカー名]] [[エイリアス名>#アンカー名]]
- ページ名にアンカー名を付け加えてアンカーへのリンクを貼ることができます。ページ名とアンカー名の間には#をつけます。カレントページのアンカーへリンクを貼る場合はページ名を省略することができます。
[[エイリアス名>http://www.example.com/]] [[エイリアス名>https://www.example.com/]] [[エイリアス名>ftp://ftp.example.com/]] [[エイリアス名>news://news.example.com/]] [[エイリアス名><foo (at) example (dot) com>]] [[エイリアス名>InterWikiName:ページ名]] [[エイリアス名>InterWikiName:ページ名#アンカー名]]
- エイリアスをURLやInterWiki?と組み合わせることもできます。
[[エイリアス名:http://www.example.com/]] [[エイリアス名:https://www.example.com/]] [[エイリアス名:ftp://ftp.example.com/]] [[エイリアス名:news://news.example.com/]] [[エイリアス名:<foo (at) example (dot) com>]]
- URLを指定する場合は、>の代わりに:も使用できます。
- エイリアス名の中には、全角文字を含めることができます。
- エイリアス名の中には、半角空白文字を含めることができます。
- 階層化されたページでは、ページ名を相対指定することができます。
- エイリアスは、他のインライン要素の子要素になることができます。
- エイリアスは、他のインライン要素を子要素にできます。
タブコード
行中で と書くと、タブコードに置換されます。
通常、フォーム内ではキーボードからタブコードを直接入力できない*4ので、タブコードを入力したい位置に を記述すると、保存時にタブコードに置換します。
- タブコードは、記事が書き込まれるときに置換されて記録されます。
- タブコードは、他のインライン要素の子要素になることができます。
- タブコードは、他のインライン要素を子要素にはできません。
ページ名置換文字
整形ルール 整形ルール行中で 整形ルール 及び 整形ルール と書くと、編集中のページ名に置換されます。ページ名が階層化されたページで「hogehoge/hoge」となっている場合、 整形ルール は「hoge」に、 整形ルール は「hogehoge/hoge」に置換されます。階層化されていないページでは、 整形ルール も 整形ルール も同じになります。
- ページ名置換文字は、記事が書き込まれるときに置換されて記録されます。
- ページ名置換文字は、他のインライン要素の子要素になることができます。
- ページ名置換文字は、他のインライン要素を子要素にはできません。
日時置換文字
& date; & time; & now;
- 行中で &date; と書くと、更新時の日付に置換されます
- 行中で &time; と書くと、更新時の時刻に置換されます
- 行中で &now; と書くと、更新時の日時に置換されます
- &date;、 &time;、 &now;は、記事が書き込まれるときに置換されて記録されます。
&date(); &time(); &now();
- 行中で &date(); と書くと、表示時の日付に置換されて出力されます。
- 行中で &time(); と書くと、表示時の時刻に置換されて出力されます。
- 行中で &now(); と書くと、表示時の日時に置換されて出力されます。
文字参照文字
文字参照は、SGMLで定義されている文字参照文字(©や®など)のほか、下記の独自の文字参照文字が使用できます。&heart; ⌣ &bigsmile; &huh; &oh; &wink; &sad; &worried;
- 行中で&heart;と書くと、ハートマーク に置換されて出力されます。
- 行中で⌣と書くと、 に置換されて出力されます。
- 行中で&bigsmile;と書くと、 に置換されて出力されます。
- 行中で&huh;と書くと、 に置換されて出力されます。
- 行中で&oh;と書くと、 に置換されて出力されます。
- 行中で&lwink;と書くと、 に置換されて出力されます。
- 行中で&sad;と書くと、 に置換されて出力されます。
- 文字参照文字は、表示されるときに置換されます。
- 文字参照文字は、他のインライン要素の子要素になることができます。
- 文字参照文字は、他のインライン要素を子要素にはできません。
数値参照文字
進数; 進数;行中で と ; の間に10進数を、 と ;の間に16進数を書くと、Unicodeを数値参照して表示します。キーボードから直接入力できない文字やUnicode時のみJIS第3水準・第4水準の文字などの表示に使用します。*5
- 数値参照文字は、表示されるときに置換されます。
- 数値参照文字は、他のインライン要素の子要素になることができます。
- 数値参照文字は、他のインライン要素を子要素にはできません。
- 16進数は半角小文字で指定する必要があります(XHTML 1.0 第2版から小文字に限定されました)。
コメント行 †
// コメント行頭で // を指定すると、コメント行になります。コメント行は出力されない行です。
- コメント行は、他の要素と無関係に行単位でどの位置にも記述できます。
- コメント行は、前後の他の要素に何ら影響を及ぼしません。