整形ルール

テキスト整形のルール

• 通常は入力した文章がそのまま出力されます。
• HTMLのタグは効果がありません。
  書かれた文章はそのまま(「<font color="red">text</font>」といった形のまま)表示されます
• 段落と段落の区切りには空行をはさんで下さい。
  空行をはさまず、連続している複数の行は同じ段落と解釈されます (連結して表示されます)

これに加えて、特定のルールによるテキスト整形を行うことができます。以下では、プラグインについてはよく使われるものだけを簡略に説明しています。プラグインのオプションなど詳細な説明については http://rwiki.jp/top/Plugin を参照してください。

ブロック要素

• ブロック要素は、インライン要素と他のブロック要素を子要素にすることができます。ただし、段落、見出し、水平線、#から始まるブロック要素は他のブロック要素を子要素にすることはできません。

• 空行はトップレベルのブロック要素の区切りになります。空行が現われると、すべてのブロック要素は終了します。

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

• ブロック要素となるプラグインは#～の形式になっています。1

段落

 インライン要素

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

 ~ インライン要素

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

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

引用文

 > インライン要素

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

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

リスト構造

 - インライン要素

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

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

 + インライン要素

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

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

 : 定義語 | 説明文

行頭を : で始め、| 記号で区切ると、定義リストになります。定義リストは :、::、::: の3段階あります。定義リストの定義語、説明文は省略することができます。複数の連続した定義リストを記述し、2つ目以降の定義語を省略することで1つの定義語に対する複数の説明文を記述することができます。

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

整形済みテキスト

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

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

表組み

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

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

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

   LEFT:
   CENTER:
   RIGHT:
   BGCOLOR(色):
   COLOR(色):
   SIZE(サイズ):
   BGIMG(添付画像名):
   TOP:
   MIDDLE:
   BOTTOM:

  • 要素の表示位置及び背景色・文字色・文字サイズ(px単位)を指定します。デフォルトは左寄せになります。

    表組みの	各セルの要素の配置に	関するサンプル
    左寄せ (LEFT:)	センタリング (CENTER:)	右寄せ (RIGHT:)
    右寄せ (RIGHT:)	左寄せ (LEFT:)	センタリング (CENTER:)
    上寄せ (TOP:)	中央配置 (MIDDLE:)	下寄せ (BOTTOM:)

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

   LEFT:
   CENTER:
   RIGHT:
   BGCOLOR(色):
   COLOR(色):
   SIZE(サイズ):
   BGIMG(添付画像名):
   TOP:
   MIDDLE:
   BOTTOM:

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

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

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

CSV形式の表組み

 ,データ,データ,…

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

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

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

見出し

 * インライン要素

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

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

目次

 #contents

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

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

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

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

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

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

水平線

 ---------------------------------------------

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

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

 #hr

行頭で #hr を記述すると、区切り線になります。区切り線は上位のブロック要素の幅の60%の長さの水平線がセンタリングされて引かれます。

• 区切り線は、他のブロック要素の子要素になることができます。
• 区切り線は、他のブロック要素を子要素にすることはできません。

行間開け

 #br

行頭で #br を記述すると、ブロック要素間またはブロック要素内で行間を開けることができます2。

• 行間開けは、他のブロック要素の子要素になることができます。
• 行間開けは、他のブロック要素を子要素にすることはできません。

添付ファイル・画像の貼り付け

 #ref(添付ファイル名)
 #ref(ファイルのURL)

行頭で #ref を記述すると、添付ファイルまたは指定されたURLにあるファイルへのリンクを貼り付けることができます。ファイルが画像ファイルの場合は、その画像を表示します。

• #ref には、カンマで区切って下記のパラメタを指定できます。パラメタを省略した場合はデフォルト値となります。

   添付ファイルのページ

  • 添付ファイルが存在するページ名を指定します。デフォルトは現在のページです。
  • このパラメタを指定する場合は、添付ファイル名の次に記述します。

     left
     center
     right

  • ファイルへのリンク・画像を表示する位置を指定します。デフォルトではセンタリングされます。

     wrap
     nowrap

  • ファイルへのリンク・画像を枠で囲むかどうかを指定します。デフォルトは囲みません。

     around

  • テキストの回り込みを指定します。デフォルトでは回り込みを行ないません。

     nolink

  • デフォルトでは添付ファイルへのリンクが張られますが、nolinkを指定するとリンクを張りません。

     代替文字列

  • ファイル名の代わりに表示する文字列や画像の代替文字列を指定できます。指定しない場合は、ファイル名になります。
  • 代替文字列には文字列以外のインライン要素を含めることはできません。ページ名、文字列以外のインライン要素を記述しても文字列として扱われます。
  • このパラメタを指定する場合は、最後に記述します。

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

テキストの回り込みの解除

 #clear

行頭で #clear を記述すると、 #ref で指定したテキストの回り込みを解除します。 #clear を指定しなくても、記事の末尾でテキストの回り込みが自動的に解除されます。

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

フォーム

 #comment

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

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

 #pcomment

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

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

 #article

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

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

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

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

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

インライン要素

テキスト整形

リンク

ファイルの添付

&attachref(ファイル名);
&attachref(ファイルのURL);

行中で &attachref を記述すると、添付ファイルまたは指定されたURLにあるファイルへのリンクを貼り付けることができます。
ファイルが画像ファイルの場合は、その画像を表示します。
ファイルが存在しない場合、添付するURLが挿入されます。

• &attachref には、カンマで区切って下記のパラメタを指定できます。パラメタを省略した場合はデフォルト値となります。

   添付ファイルのページ

  • 添付ファイルが存在するページ名を指定します。デフォルトは現在のページです。
  • このパラメタを指定する場合は、添付ファイル名の次に記述します。

     nolink

  • デフォルトでは添付ファイルへのリンクが張られますが、nolink を指定するとリンクを張りません。

     代替文字列

  • ファイル名の代わりに表示する文字列や画像の代替文字列を指定できます。指定しない場合は、ファイル名になります。
  • 代替文字列には文字列以外のインライン要素を含めることはできません。ページ名、文字列以外のインライン要素を記述しても文字列として扱われます。
  • このパラメタを指定する場合は、最後に記述します。

コメント