Wikidot構文についての覚え書き

はじめに

Wikidotは英語で書いてあるから、何が書いてあるかちんぷんかんぷんなのです。
特に構文です。これは痒いところに手が届きづらいです。一々Syntaxサイトを訳しながら書くのは極めて辛いです。
ので、私が読んだ部分を書き残しておくことにしました。非公式日本語訳Wikiに書くのは何か違うと思ったので。
恐惶謹言。

ここについて

• このページに書かれているWikidot構文（の一部）を訳しておきます。
• 筆者の英語力/Code力は極めて貧弱なので、誤訳や未訳が多々あります。指摘されたら修正します。
• 加筆修正は大歓迎です。そんな聖人の皆さんには、申し訳ないですがディスカッションに一言添えていただけると助かります。

構文リスト（未完成）

箇条書き/Lists（一部未訳）

Documentation » Wiki Syntax » Lists

箇条書き/Bulleted Lists

行頭にアスタリスクと半角スペース("* ")を入れることで、箇条書きにできます。アスタリスクの前にスペースを入れるとネスト構造になります。

* Bullet 1
* Bullet 2
 * Bullet 2.1

• Bullet 1
• Bullet 2
  • Bullet 2.1

箇条書きの下に文章を入れたい場合は、行末に半角スペースとアンダースコア（" _"）を入れて下さい。アンダースコア後に文字を入れないように。

* Bullet 1 _
 こんな感じで
* Bullet 2
 * Bullet 2.1 _こうすると反映されません

• Bullet 1
  こんな感じで
• Bullet 2
  • Bullet 2.1

番号付き箇条書き/Numbered Lists

似たような感じで、ハッシュと半角スペースで（"# "）番号付きの箇条書きを形成できます。

# Item 1
# Item 2
 # Item 2.1

1. Item 1
2. Item 2
   1. Item 2.1

箇条書きと同じ要領で、下に文章を追加することもできます。

# Item 1 _
 やり方は同じです。
# Item 2
 # Item 2.1 _こうすると反映されないのも同じです

1. Item 1
   やり方は同じです。
2. Item 2
   1. Item 2.1 _こうすると反映されないのも同じです…あれ？

箇条書き/Bulleted Listsと番号付き箇条書き/Numbered Listsは混ぜて使用できます。

拡張リスト/Advanced Lists

[[ul]] / [[ol]] と [[li]]タグを使って拡張形式のリストを作ることができます。特にBootstrapテーマを使用する時に便利です。
全ての[[ul]] / [[ol]] / [[li]]タグはid, class, data-,style の引数を含めることができます。またネスト構造も可能です。

[[ul]]
 [[li class="item1" data-toggle="data1"]]Item1[[/li]]
 [[li style="color: red;"]]Item 2
  [[ol]]
    [[li]]Item 2.1[[/li]]
    [[li]]Item 2.2[[/li]]
  [[/ol]]
 [[/li]]
[[/ul]]

• Item1
• Item 2
  
  1. Item 2.1
  2. Item 2.2

以下未訳;
Adding underscore to ul/ol element [[ul_/ol_ ]] will truncate whitespaces around it which prevents creation of random new lines and paragraphs. It's simplifices creation of complex HTML syntax like Bootstrap components

You can use user-defined ID arguments in advanced lists, which is extremely useful building sites using Bootstrap. Please note that every user-defined ID will have a "u-" prefix added in the output HTML for the security reasons.
To make your source more readable, you can add the "u-" prefix yourself. For example, these 2 bits of wiki syntax will output the same HTML:
"u-" prefix will be added to myAdvancedList automatically when the page is saved

[[ul id="myAdvancedList"]]

"u-" prefix will not be added to since it already exists

[[ul id="u-myAdvancedList"]]

HTML output from both examples

<ul id="u-myAdvancedList">

コード･ブロック/Code Blocks

Documentation » Wiki Syntax » Code Blocks

コード･ブロック/Code Blocks

[[code]] ... [[/code]]タグでコード･ブロックを生成することができます。

これがコードブロックです

[[include]]タグを除いて、コードブロック内のすべてのwiki構文はリテラルテキストとして扱われ、処理されません。
[[include]]タグの処理を避けたい場合は、1つの半角スペース（" "）をその前に挿入して下さい。

ページ内のコードブロックはそれぞれが一意のURLを持っています。これはコードブロックがCSSコードを含んでいる際に特に役立つでしょう。

http://scpjp-fansite.wikidot.com/wikidot-syntax-trans/code
http://scpjp-fansite.wikidot.com/wikidot-syntax-trans/code/2  -- second block

次に示す方法では、あなたのアカウントに対して_template¹を使用することなく、ページのソース自体に定義されたコードブロックを抽出することができます。
_templateと組み合わせたページのソースを形成しているコー​​ドブロックにアクセスするには、次のURLを使用します。

http://mysite.wikidot.com/category:page/code_  -- 末尾のアンダースコアに注意して下さい
http://mysite.wikidot.com/category:page/code_/2  -- second block

あなたがPHPタグを使用するときに、自動的に色付けされたPHPブロックを作成するには、[[code type="php"]]…[[/code]] タグを使用してコードを囲みます。²
色付けされたPHPコードを取得するには、<?php … ?>で囲む必要があります。

Wikidot.comはPEAR :: Text_Highlighterを使用しており、かなりの数のカラースキームをサポートしています。
以下はPEAR :: Text_Highlighterがサポートしている言語です;

php, html, cpp, css, diff, dtd, java, javascript, perl, python, ruby, xml.

[[code type="php"]]
<?php
/* comment */
for($i=0; $i<100; $i++){
echo "number".$i."\n";
}
?>
[[/code]]

<?php
/* comment */
for($i=0; $i<100; $i++){
echo "number".$i."\n";
}
?>

脚注

1. Templateページの作成が不要という意味か。

2. ここら辺、訳者がPHPを知らないのでサッパリ分かりません。