整形ルール

記事の整形ルール †

本文 †

本文はリスト構造ではなく、なるべく段落を使うようにして下さい。

空行で挟まれた部分が段落となります。段落中の改行は無視されます。

行末に ~ と入力すると強制改行できますが、改段落した方が読みやすいと思われます。

引用 †

文献を引用する場合、書名、著者名を明記して下さい。書式は

>引用文
>>書名
>>>著者／訳者名、出版社

引用文

書名

著者／訳者名、出版社

記事へのコメント †

本文とのコメントの違いを解りやすくするため注釈やメモフォーム(#memo)を使った方がいいかもしれません。

その他 †

整形ルールの提案、疑問、苦情は連絡ページ?へ。

PukiWikiで利用できる書式 †

通常は入力した文字がそのまま出力されますが、以下のルールに従ってテキスト整形を行うことができます。

• 空行は最上位のブロック要素の区切りを示します。
• HTMLのタグは書けません。

ブロック要素 †

• ブロック要素は、インライン要素と他のブロック要素を子要素にすることができます。ただし、段落、見出し、水平線、#から始まるブロック要素は他のブロック要素を子要素にすることはできません。
• 空行はトップレベルのブロック要素の区切りになります。空行が現われると、すべてのブロック要素は終了します。
• ブロック要素は、他のブロック要素の子要素になることができます。
  • リスト構造と引用文は他のブロック要素を子要素にすることができます。子要素のブロック要素は親要素のレベルに従ってインデントされて表示されます。空行が現われるとブロック要素は終了します。
  • リスト構造と引用文のネストには3段階のレベルがありますが、リスト構造のレベルと引用文のレベルは独立しています。従って、リスト構造を引用文の子要素にする場合や引用文をリスト構造の子要素にする場合は、レベルを1段階増やさずに記述します。リスト構造を他のリスト構造の子要素にする場合や引用文を他の引用文の子要素にする場合は、レベルを1段階増やして記述します。
  • 他のブロック要素の子要素となっている引用文から脱出するとき、親のブロック要素を継続したい場合は行頭に<、<<、<<<を記述します。<で第1レベルの引用文から、<<で第2レベルの引用文から、<<<で第3レベルの引用文から脱出します。空行を記述すると引用文だけでなく親のブロック要素からも脱出します。
• ブロック要素となる拡張書式*1は#〜の形式になっています。

段落 †

インライン要素

他のブロック要素を明示しない限り、段落となります。

~インライン要素

行頭で~を指定した場合も段落になります。行頭書式の文字(~、-、+、:、>、|、#、//)を通常の文字として段落の先頭に書きたい場合は、行頭に~を記述して書くことができます。

• 段落の先頭は1文字分字下げされます。但し、番号なしリスト構造、番号付きリスト構造、引用文内の段落では字下げされません。定義リスト内の段落の先頭は1文字分字下げされます。
• 段落は、新たなブロック要素が現われるまで継続します。
• 段落は、他のブロック要素の子要素になることができます。
• 段落は、他のブロック要素を子要素にすることはできません。

引用文 †

>インライン要素

行頭で>を指定すると、引用文になります。引用文は >、>>、>>> の3レベルあります。

• 引用文の中は、ブロック要素を明示しない限り、段落となります。
• 引用文は、空行が現われるまで継続します。
• 引用文内の段落は、新たな引用文またはブロック要素が現われるまで継続します。
• 引用文は、他のブロック要素の子要素になることができます。他の引用文の子要素にする場合は、レベルを1段増やして記述します。リスト構造の子要素にする場合はレベルを1段増やさずに記述します。
• 引用文は、他のブロック要素を子要素にすることができます。引用文の子要素となるリスト構造はレベルを1段増やさずに記述します。
• リスト構造内の引用文から脱出する場合で、リスト構造を継続する場合は、<、<<、<<<を行頭に記述します。

リスト構造 †

-インライン要素

行頭で - を指定すると、番号なしリストになります。番号なしリストは -、--、--- の3レベルあります。

• 番号なしリストは、他のブロック要素の子要素になることができます。他のリスト構造の子要素にする場合は、レベルを1段増やして記述します。引用文の子要素にする場合は、レベルを増やさずに記述します。
• -の直後に ~を記述すると段落を子要素にすることができます。
• 番号なしリストは、リストの先頭がインライン要素または段落である場合に限り、リストの次の行に他のブロック要素を記述することで、他のブロック要素を子要素にすることができます。

+インライン要素

行頭で + を指定すると、番号付きリストになります。番号付きリストは +、++、+++ の3レベルあります。

• 番号付きリストは、他のブロック要素の子要素になることができます。他のリスト構造の子要素にする場合は、レベルを1段増やして記述します。引用文の子要素にする場合は、レベルを増やさずに記述します。
• +の直後に ~を記述すると段落を子要素にすることができます。
• 番号付きリストは、リストの先頭がインライン要素または段落である場合に限り、リストの次の行に他のブロック要素を記述することで、他のブロック要素を子要素にすることができます。

:定義語|説明文

行頭を : で始め、| 記号で区切ると、定義リストになります。定義リストは :、::、::: の3段階あります。

定義リストの定義語、説明文は省略することができます。複数の連続した定義リストを記述し、2つ目以降の定義語を省略することで1つの定義語に対する複数の説明文を記述することができます。

• 行中に | がないと定義リストにはなりません。
• 定義語・説明文は、インライン要素のみ記述することができます。
• 定義リストは、他のブロック要素の子要素になることができます。他のリスト構造の子要素にする場合は、レベルを1段増やして記述します。引用文の子要素にする場合は、レベルを増やさずに記述します。
• |の直後に ~を記述すると段落を子要素にすることができます。
• 定義リストは、定義リストの次の行に他のブロック要素を記述することで、他のブロック要素を子要素にすることができます。

整形済みテキスト †

行頭が半角空白で始まる行は整形済みテキストとなります。行の自動折り返しは行なわれません。

• 整形済みテキストは、他のブロック要素の子要素になることができます。
• 整形済みテキストは、他のブロック要素を子要素にすることができません。
• 整形済みテキストは、すべての子要素を文字列として扱います。

表組み †

|インライン要素|インライン要素|

行頭から | でインライン要素を区切ることで表組みになります。

• 各要素の先頭に下記の記述子を指定できます。

LEFT:
CENTER:
RIGHT:

• 要素の表示位置を指定します。デフォルトは左寄せされます。

• 行末にcを記述すると、書式指定行となります。書式指定行では、次の記述子が指定できます。

LEFT:
CENTER:
RIGHT:

• 記述子の後ろに数値を記述すると、セル幅がpx単位で指定できます。

• 行末にhを記述すると、ヘッダ行(thead)になります。
• 行末にfを記述すると、フッタ行(tfoot)になります。
• セル内のインライン要素の先頭に~を付けると、ヘッダ(th)になります。
• セル内に>を単独で記述すると右のセルと連結します(colspan)。
• セル内に~を単独で記述すると上のセルと連結します(rowapn)。

• 表組みは、他のブロック要素の子要素になることができます。
• 表組みは、他のブロック要素を子要素にすることができません。

CSV形式の表組み †

,インライン要素,インライン要素,…

行頭でカンマ(.)を記述し、インライン要素をカンマ区切りで記述すると表組みになります。

• インライン要素はダブルクォーテーション(")で囲むことができます。ダブルクォーテーションで囲むことで、カンマ(,)を含むインライン要素を記述できます。
• ダブルクォーテーション(")で囲んだインライン要素の中で、ダブルクォーテーションを2つ("")続けることで、ダブルクォーテーション(")を含むインライン要素を記述できます。
• インライン要素の代わりにイコールを2つ(==)記述すると、colspanを意味します。
• インライン要素の左に1つ以上の半角空白文字を記述すると右寄せに、インライン要素の左右に1つ以上の半角空白文字を記述するとセンタリングになります。

• 表組みは、他のブロック要素の子要素になることができます。
• 表組みは、他のブロック要素を子要素にすることができません。

見出し †

*インライン要素

行頭で * を記述すると、見出しになります。見出しは *、**、*** の3段階あります。

• 見出しは、他のブロック要素の子要素になることはできません。見出しが現われると他のブロック要素は終了します。
• 見出しは、他のブロック要素を子要素にすることはできません。

目次 †

#contents

行頭で#contensを記述すると、見出しに基づいて目次を作成します。一般的に#contentsはページの最初のほうに記述します。

• 目次は、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
• 目次は、他のブロック要素を子要素にすることはできません。

左寄せ・センタリング・右寄せ †

LEFT:インライン要素
CENTER:インライン要素
RIGHT:インライン要素

行頭でLEFT:、CENTER:、RIGHT:を記述すると、インライン要素が左寄せ、センタリング、右寄せされます。

• LEFT:、CENTER:、RIGHT:は、他のブロック要素の子要素になることができます。
• LEFT:、CENTER:、RIGHT:は、他のブロック要素を子要素にすることができません。

水平線 †

----

行頭で4つの - を書くと水平線になります。

• 水平線は、他のブロック要素の子要素になることはできません。水平線が現われると他のブロック要素は終了します。
• 水平線は、他のブロック要素を子要素にすることはできません。

フォーム †

#comment

行頭で#commentを記述すると、コメントを挿入するためのフォームが埋め込まれます。

• #commentは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
• #commentは、他のブロック要素を子要素にすることはできません。

#pcomment

行頭で#pcommentを記述すると、コメントを挿入するためのフォームが埋め込まれます。#commentとは異なり、コメントは別ページに記録されます。また、コメントに対するレスポンスを階層状に表示します。

• #pcommentは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
• #pcommentは、他のブロック要素を子要素にすることはできません。

#article

行頭で#articleを記述すると、簡易掲示板のフォームが埋め込まれます。

• #articleは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
• #articleは、他のブロック要素を子要素にすることはできません。

#vote(選択肢1,選択肢2,...)

行頭で#voteを記述すると、簡易投票フォームが埋め込まれます。

• 選択肢は文字列、WikiName、BracketName、InterWiki、リンクを含めることができます。その他のインライン要素を含めることができません。
• #voteは、他のブロック要素の子要素になることができますが、トップレベルに設置することを前提に左マージンを設定してありますので、他のブロック要素の子要素にはしないでください。
• #voteは、他のブロック要素を子要素にすることはできません。

インライン要素 †

• インライン要素は、必ずブロック要素の子要素になっています。
  • 行頭書式でブロック要素を明示しない場合は、段落の子要素となります。
  • 行頭書式でブロック要素を明示した場合は、指定したブロック要素の子要素になります。
• インライン要素は、インライン要素を子要素にすることができます。
• インライン要素はブロック要素を子要素にすることはできません。
• インライン要素となる拡張書式*2は&〜の形式になっています。

文字列 †

文字列

文字列はインライン要素です。

• 文字列は、他のインライン要素の子要素になることができます。
• 文字列は、他のインライン要素を子要素にすることができません。

改行 †

インライン要素~

行末に~を書くと行末改行になります。行末改行はブロック要素内での改行になります。

• 行末改行の次の行の行頭書式は無効になり、文字列として扱われます。
• 行末改行は、他のインライン要素の子要素になることはできません。
• 行末改行は、他のインライン要素を子要素にすることはできません。
• 行末改行は、定義リストの定義語、表組みの要素、#で始まるブロック要素のパラメタの中では使用できません。

&br;

行中に&br;を書くと行中改行になります。行末の ~と違い、定義リストの定義語や表組みの要素、#で始まるブロック要素のパラメタの中でも使用できます。

• 行中改行は、他のインライン要素の子要素になることができます。
• 行中改行は、他のインライン要素を子要素にすることはできません。

強調 †

''インライン要素''

行中のインライン要素を '' ではさむと、インライン要素が強調(太字)表示になります。

• 強調(太字)は、他のインライン要素の子要素になることができます。
• 強調(太字)は、他のインライン要素を子要素にすることができます。

'''インライン要素'''

行中のインライン要素を ''' ではさむと、インライン要素が強調(斜体)表示になります。

• 強調(斜体)は、他のインライン要素の子要素になることができます。
• 強調(斜体)は、他のインライン要素を子要素にすることができます。

文字サイズ †

&size(サイズ){インライン要素};

行中に&sizeを書くとインライン要素の文字サイズを指定することができます。サイズはピクセル単位(px)で指定します。

• 文字サイズは、他のインライン要素の子要素になることができます。
• 文字サイズは、他のインライン要素を子要素にすることができます。

文字色 †

&color(色){インライン要素};

行中に&colorを書くとインライン要素の文字色を指定することができます。

• 色の指定は、次のいずれかの形式で行ないます。
  • 色キーワード?
  • #16進数6桁
  • #16進数3桁
• 文字色は、他のインライン要素の子要素になることができます。
• 文字色は、他のインライン要素を子要素にすることができます。

取消線 †

%%インライン要素%%

行中のインライン要素を%%ではさむと、インライン要素に取消線が付きます。

• 取消線は、他のインライン要素の子要素になることができます。
• 取消線は、他のインライン要素を子要素にすることができます。

注釈 †

((インライン要素))

行中でインライン要素を((と))ではさむと、注釈が作成され、行中に注釈へのリンクが貼られます。注釈文の中では注釈を使用できません(ネストはできません)。

• 注釈は、他のインライン要素の子要素になることができます。親要素は注釈文ではなく、注釈へのリンクに反映されます。
• 注釈は、他のインライン要素を子要素にすることができます。子要素は注釈文に反映されます。

アンカーの設定 †

&aname(アンカー名);

行中で&anameを記述するとリンクのアンカーを設定することができます。リンクの飛び先にしたい位置に記述します。

• アンカー名は、半角アルファベットから始まる半角アルファベット・数字・ハイフン・アンダースコアからなる文字列を指定します。
• アンカー名の中には、全角文字や半角空白文字、半角記号を含めることはできません。
• アンカー設定は、他のインライン要素の子要素になることができます。
• アンカー設定は、他のインライン要素を子要素にはできません。

WikiName †

WikiName

行中で、1つの大文字→1つ以上の小文字→1つの大文字→1つ以上の小文字の組み合わせからなる半角文字列はWikiNameになります。

• WikiNameの中には、全角文字や半角空白文字、記号、数字を含めることはできません。
• WikiNameは、PukiWiki内のページ名になります。すでに存在するページであればそのページへのリンクが自動的に貼られます。存在しない場合はWikiNameの後ろに?が自動的に付き、そのページを新規作成するためのリンクが貼られます。
• WikiNameは、他のインライン要素の子要素になることができます。
• WikiNameは、他のインライン要素を子要素にはできません。

BracketName †

[[れいみぃ]]

行中で[[と]]で囲まれた文字列はBracketNameになります。

• BracketNameの中には、全角文字、記号、数字、半角空白文字を含めることができます。
• BracketNameの中には、"#&<>を含めることはできません。
• BracketNameは、PukiWiki内のページ名になります。すでに存在するページであればそのページへのリンクが自動的に貼られます。存在しない場合はWikiNameの後ろに?が自動的に付き、そのページを新規作成するためのリンクが貼られます。
• BracketNameは、他のインライン要素の子要素になることができます。
• BracketNameは、他のインライン要素を子要素にはできません。

エイリアス †

[[エイリアス名>ページ名]]

行中のBracketNameの形式の文字列の中で、>で2つの文字列を区切るとエイリアスになります。>の前にはエイリアス名を、>の後ろにはWikiNameまたは[[と]]を取り去ったBracketNameを記述します。

エイリアスはPukiWiki内のページ名とは別のエイリアス名で、指定したページへのリンクを貼ります。

ページ名にアンカー名を付け加えてアンカーへのリンクを貼ることができます。ページ名とアンカー名の間には#をつけます。カレントページのアンカーへリンクを貼る場合はページ名を省略することができます。

[[エイリアス名>ページ名#アンカー名]]
[[エイリアス名>#アンカー名]]

• エイリアス名の中には、全角文字を含めることができます。
• エイリアス名の中には、半角空白文字を含めることができます。
• 階層化されたページでは、ページ名を相対指定することができます。
• エイリアスは、他のインライン要素の子要素になることができます。
• エイリアスは、他のインライン要素を子要素にできます。

文字参照文字 †

©

行中で&copy;と書くと、著作権マーク © に置換されて出力されます。

®

行中で&reg;と書くと、登録商標マーク ® に置換されて出力されます。

™

行中で&trade;と書くと、商標マーク ™ に置換されて出力されます。

 

行中で&nbsp;と書くと、非改行空白文字 に置換されて出力されます。主に表組みのセル幅の調整に使用します。

• 文字参照文字は、表示されるときに置換されます。
• 文字参照文字は、他のインライン要素の子要素になることができます。
• 文字参照文字は、他のインライン要素を子要素にはできません。

その他 †

コメント行 †

// コメント

行頭で // を指定すると、コメント行になります。コメント行は出力されない行です。

• コメント行は、他の要素と無関係に行単位でどの位置にも記述できます。
• コメント行は、前後の他の要素に何ら影響を及ぼしません。