はじめに

WikiはCMSの一つで、誰でも(基本的に)全てのページを編集できるという割と無茶なシステムです。「新規」で新たにページを作り、「編集」ですでにあるページを編集します。整形ルールは「ヘルプ」にありますが、分かりづらいかもしれないので、簡易なチュートリアルをここに書いておきます。「ヘルプ」が分かりづらい場合に利用してください。このページを別ウィンドウ(別タブ)で開いて、実際に砂場?や自分の名前で新規に作ったページを編集しつつ、適宜参照してください(手を動かさないと覚えない)。

Wikiの全てのルールを覚える必要はありません。このページでも細かい部分にはあまり触れず、よく使いそうな記法だけを説明します。最初は自分が使う記法のみを覚え、他の人の面白い書き方を見つけたら、そのページの編集画面を開いてソースを見たり、ヘルプを参照するなどして、必要な時に覚えていけばいいと思います。

目次

とりあえず書いてみる

ただ文章をどべっと書くなら細かい知識は要りません。「新規」もしくは「編集」で現れる編集画面へ無心に打ち込み、「プレビュー」ボタンで表示を確認、「ページの更新」で結果を反映させてください。連続する複数の行は同じ段落と解釈され、空行を挟むと段落の切り替えになります。HTMLのタグは使えません。

整形済みテキスト

整形済み〜ん   ←空白文字もそのまま反映〜ん

文章の行頭に半角スペースを書くと、整形済みテキスト(それ以上Wikiが整形しないテキスト)が書けます。ただどべっと書いた場合、半角スペースや改行が詰めて表示されますが、整形済みテキストではどちらも反映されるようになります。自分で改行しない限り折り返しがされないという事でもあるので、注意しないと文章がひどく横長になるかもしれません。複数行を整形済みにする場合、全ての行頭に半角スペースを置いてください。整形済みテキスト内ではWikiの記法によるその他の効果は適用されません。たとえば下の「リンクを作成」で説明するブラケットも、整形済みテキスト内ではそのまま表示されます。

[[ぶらけっとねーむ]]

HTMLでいうPREタグです。コピペの時に使うと楽です。

リンクを作成

Wiki内のページへのリンクを作るのは簡単です。ブラケット([[と]])でページ名を囲むと、そのページへのリンクになります。Wiki内に存在しないページ名をブラケットで囲むと「?」が表示され、そのページを新規作成するためのリンクになります。以下は

[[いがらし]]
[[存在しないページ]]

を書いた場合の例です。

ふざけて「存在しないページ」というページを作るとキレたいがらしにぶっ飛ばされます。注意してください。

Wiki外へのリンクを作る場合、URLをそのまま書けばそのURLがリンクとして表示されます。URL以外の文字列をリンク名にしたい場合、[[適当な文字列:URL]]を使います。

http://www.nagasakipu.ac.jp/
[[カニカニ大学:http://www.nagasakipu.ac.jp/]]

Wiki内のページへのリンクで、上の「カニカニ大学」のように別のリンク名を使いたい場合、[[リンク名>ページ名]]という書き方をします。

[[コーラ魔人>いがらし]]

いがらし」のように、ページ名によってはブラケットを使わなくても、文中にページ名を書くだけでリンクになる場合がありますが、確実にリンクを作りたい場合はブラケットを使ってください。

見出し

行頭にアスタリスク「*」を置くと、見出しになります。「*」で大見出し、「**」で中見出し、「***」で小見出しと、3つのレベルに分けて使えます。このページの編集画面を開くと分かりますが、目次は手書きでページ内の見出しをリストしているのではなく、#contentsプラグインによってWikiにリストさせています。ページ内に見出しが増えれば目次の内容も自動的に増えますし、見出しの文が変われば目次の内容も自動で変わるので、ページのメンテナンスが楽になります。要点を見出しで目立たせるのは文章自体の読みやすさにもつながるので、効果的に利用してください。以下は

**中見出し
***小見出し
****

と書いた場合の表示例です。

中見出し

小見出し

*

↑レベルは3つまでなので、「*」を4つ並べても「小見出し+*」になる

リストと表

箇条書き(リスト)

番号なし

行頭に「-」を置くと、箇条書きができます(順序なしリスト)。見出しと同様3つまでのレベルがあり、それぞれ「-」、「--」、「---」を使います。以下は順序なしリストの例です。

-あんパン
-食パン
-カレーパン
--ジャム
--バター
--チーズ
---だだんだん?
----
  • あんパン
  • 食パン
  • カレーパン
    • ジャム
    • バター
    • チーズ
      • だだんだん?

↑4つ続けるとリストではなく別の意味となる(行頭に「----」で水平線の表示)。

番号付き

行頭に「+」で番号付きの箇条書きができます(順序付きリスト)。これも3つまでのレベルがあり、それぞれ「+」、「++」、「+++」を使います。以下は順序付きリストの例です。

+ひとつ人世の生き血をすすり
+ふたつ不埒な悪行三昧
+みっつ見ないで汚れたおいらを
++よごれっちまったかなしみに
++きょうもこゆきの
+++次なんだったか忘れた
+++わすれっちまったかなしみに……(←ボケて誤魔化す)
  1. ひとつ人世の生き血をすすり
  2. ふたつ不埒な悪行三昧
  3. みっつ見ないで汚れたおいらを
    1. よごれっちまったかなしみに
    2. きょうもこゆきの
      1. 次なんだったか忘れた
      2. わすれっちまったかなしみに……(←ボケて誤魔化す)

定義リスト

行頭に置いたコロン「:」と縦棒「|」でキーワードを挟み、続けて説明文を書くことで定義リストになります。 以下は

:いがらし|チキン野郎

と書いた時の例です。

いがらし
チキン野郎

「|」で文章を挟むと表が作れます。以下は

|名前|客観的特徴|
|いがらし|だめなひと|
|KaNPa.|もっとだめなひと?|

の例です。

名前客観的特徴
いがらしだめなひと
KaNPa.もっとだめなひと?

「|」のかわりにカンマ「,」を使っても同じことができます(CSV形式)。その場合行末のカンマは要りません。

文の装飾

強調・斜体

行中で文字列を2つのアポストロフィ「''」で挟むと強調表示になります。3つのアポストロフィ「'''」で挟むと斜体になります。

''強調表示''
'''斜体'''
  • 強調表示
  • 斜体

文字のサイズと色

行中で&size(文字サイズ){サイズを変える文字列};とすると文字のサイズを指定できます。文字サイズは半角数字で、ピクセル単位で指定します。最後のセミコロンまで忘れず書いてください。

&size(20){20pxの文字列};
  • 20pxの文字列

行中で&color(文字色、背景色){色を変える文字列};とすると文字背景の色を指定できます。背景色は省略できます。色の指定は「色キーワード」「#16進数3桁(RGB)」「#16進数6桁(RRGGBB)」の3つの方法が使えます。最後のセミコロンまで忘れず書いてください。

&color(blue){青い血の少年};
&color(white,green){くりーむそーだ};
&color(#00f){あーおいちの少年};
&color(#ffffff,#00ff00){くりーむそーだ};
&color(#ffffff,#00ff00){&size(20){でっかいくりーむそーだ};};
&color(black){セミコロンが足りない、片手落ち}
  • 青い血の少年
  • くりーむそーだ
  • あーおいちの少年
  • くりーむそーだ
  • でっかいくりーむそーだ
  • &color(black){セミコロンが足りない、片手落ち}

その他

プラグイン

既に述べた#contentsのように、PukiWikiはプラグインと呼ばれる便利な機能を持っています。文字の色、サイズを変える&sizeや&colorも実はプラグインの一つです。プラグインの一覧や詳しい使い方はプラグインマニュアルにありますが、一応ここでよく使うプラグインの名前を幾つか挙げておきます。

#aname(&aname)アンカーの作成
#contents見出しを解析して目次を自動生成
#comment一言コメント用のフォームを設置
#vote投票フォームの設置
#ls(ls2)階層化されたページ*1の一覧表示

インライン要素とブロック要素

PukiWikiの文字列や段落、リスト、表、といった各要素には、インライン要素とブロック要素という区別があります。ブロック要素の中にインライン要素を書くことは出来ますが、インライン要素の中にブロック要素を書くことはできません。ブロック要素を別のブロック要素の中に書くことは、出来る場合と出来ない場合があります。

例えば文字列は全てインライン要素であり、&size()や&color()の結果も、ブラケットで囲んだリンクもインライン要素です。これらはリストや表、見出しなどの、ブロック要素の中に書くことができます。親(中に書かれる方)と子(中に入る方)のどちらもブロック要素である場合、たとえばリストの中に表を入れる、ということはできますが、表の中にリストを入れるとか、見出しの中に表を入れるということはできません。詳細な情報はヘルプの整形ルールに載っています。

インライン要素とブロック要素、親要素と子要素、といった関係は一見複雑なようですが、慣れてくると直感的に理解できるようになります。HTMLやCSSの経験があるとより分かりやすいかもしれません。

FAQ

ページを削除したい!
編集画面で全ての内容を削除し、「ページの更新」ボタンを押すと削除になります。
メニューバーの内容を変えたいんだけど?
MenuBarのページを編集してください。
俺のページだけ別のメニューバーを表示させたい!
#includesubmenuというプラグインがあります。

書き方以外

「ページの変更点」や「バックアップ」と現在との差分を見ると、自分が見てない間にどこが変わったのかが分かります。


*1 「既存のページ名/新規ページ名」という風にスラッシュで区切ってページを新規作成すると、指定した既存のページを親とする階層化されたページが作れる

トップ   編集 凍結解除 ページの変更点 バックアップ 添付 複製 名前変更 リロード   新規 ページ一覧 単語検索 最近更新されたページ   ヘルプ   最終更新のRSS
Last-modified: 2009-07-09 (木) 14:26:06 (3330d)