![[PukiWiki]](image/pukiwiki.png "[PukiWiki]")
コマンド
★☆☆☆☆
?cmd=add&page=ページ名
既存のページに編集した内容を追加する。実行すると編集画面になる。
ページ名は省略できない。ページ名はエンコードされていなければならない。
インライン型プラグイン
★★★☆☆
&aname(アンカー名); #aname(アンカー名)
指定した位置にアンカー(リンクの飛び先)を設定する。
ブロック型プラグインとしても使用できる。
アンカー名は省略できない。
通常はインライン型プラグインとして使用する。
2つのブロック型プラグインに挟まれた部分にアンカー設定したい場合にインラインとしては記述できないため、ブロック型プラグインとしても使えるようにしてある。例外的措置。
なお、1.3.5まではブロック型プラグインだったが、1.4からインライン型プラグインになった。
ブロック型プラグイン
★★★☆☆
#article
指定した位置に簡易掲示板を設置する。
ブロック型プラグイン
★★★★★
#attach
指定した位置にファイル添付のための入力フォームを設置する。
コマンドラインから?plugin=attach&page=ページ名&pcmd=…としてattachの各機能を使用することは可能だが、ページ名はエンコードされていなければならない。手入力で実行することはまずない。
プラグインではあるが、デフォルトのskinのメニューの「添付」でコマンドのように呼び出しているため、デフォルトのskinを使う場合には必ず組み込んでおかなければならない。
ブロック型プラグイン
★☆☆☆☆
#back(表示文字列,表示位置,水平線の有無,戻り先)
指定した位置に戻り先へのリンクを設置する。
表示文字列は省略すると「戻る」になる。
表示位置は、left、center、rightを指定する。省略時はcenterになる。
水平線の有無は、0、1で指定する。省略すると1になる。
戻り先はURLで指定する。現状ではWikiNameやBracketNameを指定できない。省略すると直前のページになるが、利用者のブラウザの設定がJavaScript onでないと機能しない。
JavaScriptを使わない場合は、InterWikiName及びAliasでbackプラグインと同じことが簡単に実現できる。backプラグインでは戻り先をWikiNameやBracketNameで指定できないため、JavaScriptを使わないとPukiWiki内での移動には使いにくい。
backプラグインをインストールする場合は、スキンの<head>ブロック内に<meta>タグでJavaScriptのContent Script Typeを宣言しておかなければいけない。
コマンド
★★★★★
?cmd=backup&page=ページ名
指定したページのバックアップ一覧を表示する。
ページ名を省略すると、PukiWIki全体のバックアップ一覧を表示する。ページ名はエンコードされていなければならない。
ブロック型プラグイン
★☆☆☆☆ (一般サイト)
★★★★☆ (ソフト開発サイト)
#bugtrack(ページ名,種別1,種別2…)
指定した位置にbugtrackフォームを設置する。
ページ名はbugtrackで作成される記事の親階層となるページ名を指定する。bugtrackは、記事ごとに指定したページ名の子階層に番号を自動的に振ってページを作成していく。
種別は複数個指定することで選択肢となる。
ソフト開発サイトで重宝するプラグインだが、上記の言語ファイル設定で表示文字列を変更すれば、意見提案コーナーや書評投稿コーナーなど他の用途でも使える。
ブロック型プラグイン
★☆☆☆☆ (一般サイト)
★★★★☆ (ソフト開発サイト)
#bugtrack_list
指定した位置にbugtrack一覧を設置する。
通常はbugtrackプラグインと並べて使用する。
bugtrack_listプラグインの中からbugtrackプラグインを呼び出しているため、bugtrackプラグインがないと機能しない。
ブロック型プラグイン
★☆☆☆☆
#calendar(ページ名,年月) #calendar_edit(ページ名,年月) #calendar_read(ページ名,年月)
指定した位置にカレンダーを設置する。
ページ名を省略すると設置したページのページ名になる。ページ名はWikiNameまたはBracketNameで指定する。
年月日はyyyymmの形式で指定する。省略した場合は現在の年月になる。
calendar_editは編集用、calendar_readは表示専用。
より高機能なcalendar2プラグインがあるため、あえてcalendarプラグインを使う必要性はほとんどなくなった。
calendar_editプラグイン及びcalendar_readプラグインの中からcalendarプラグインを呼び出しているため、calendarプラグインがないと機能しない。
ブロック型プラグイン
★★★☆☆
#calendar_viewer(ページ名,[表示年月|表示件数|this],表示モード,年月日表示の区切り文字)
calendarプラグインまたはcalendar2プラグインで作成されたページを指定した位置に表示する。
ページ名はcalendarプラグインまたはcalendar2プラグインを設置しているページの名前を指定する。ページ名はWikiNameまたはBracketNameで指定する。
年月はyyyy-mmの形式で指定する。数字を指定すると表示する件数を意味する。thisを指定すると今月のページを一覧表示する。
表示モードはpast、future、viewを指定する。pastは今日以前のページを表示、futureは今日以降のページを表示、viewは過去から未来へ一覧表示。表示モードを省略するとpastになる。
年月日の区切り文字は-や/などを指定する。省略した場合は-になる。
calendarやcalendarプラグインでは今日の日付の記事がない場合、記事を表示しないため、午前0時になったとたんに記事が表示されなくなるという弱点があった。その弱点を補うために開発されたプラグイン。calendar_viewは、日付が変わっても最新の記事を表示することができる。カレンダーそのものの表示はcalendar2(off)で行なう。
（コマンド）
ブロック型プラグイン
★★★☆☆
#calendar2 #calendar2(off)
指定した位置にカレンダーを設置する。表示月のとなりに表示されたリンク(<< および >>)を選択することで前月／翌月分のカレンダーを表示できる。
当日分のページが作成されていた場合、カレンダーの右隣に当日分のページ内容を表示する。引数offを付けると当日分ページを表示する機能は抑制される。
calender_editで作成したページはページ名/yyyymmddとなり、calender2で作成したページはページ名/yyyy-mm-ddとなるため、注意が必要。
インライン型プラグイン
★★★★☆
&color(文字色){文章};
&color(文字色,背景色){文章};引数で指定したインライン要素(主に文章)の、文字色・背景色を指定する。
文字色，背景色の指定は6桁の16進数値(rrggbb)か、色名を指定する。
以下、W3C勧告書より抜粋した色名。
Aqua = "#00FFFF", Black = "#000000", Blue = "#0000FF", Fuchsia = "#FF00FF", Gray = "#808080", Green = "#008000", Lime = "#00FF00", Maroon = "#800000", Navy = "#000080", Olive = "#808000", Purple = "#800080", Red = "#FF0000", Silver = "#C0C0C0", Teal = "#008080", White = "#FFFFFF", Yellow = "#FFFF00"
コマンド
ブロック型プラグイン
★★★★★
#comment(引数)
引数へはabove,below,nodate,nonameのいずれかを指定する(順不同、半角カンマで区切って複数指定可、省略可)。
COMMENT_NOW_FORMATを変更して、newプラグインと併用するのがお勧め。
ブロック型プラグイン
インライン型プラグイン
★★★☆☆
#counter &counter(カウンタ表示対象);
カウンタ表示対象には today,yesterday,total いずれかを指定する。省略時やその他の文字列を指定した場合はtotalが指定されたとみなされる。
コマンド
★★☆☆☆
?cmd=deleted
削除されたページの一覧を表示する。
公開Wikiの管理者にとっては誤操作や悪意をもった編集によるページ削除をチェックするのに重宝する。
コマンド
★★★★★
?cmd=diff&page=ページ名
指定したページの現在の内容と最後のバックアップ状態との差分を表示する。ページ名はエンコードされていなければならない。
最後のバックアップ以外との差分を表示する場合はbackupを利用する。
コマンド
★★★★★
?cmd=edit&page=ページ名
指定したページを編集する。
ページ名はエンコードされていなければならない。
コマンド
★☆☆☆☆
?cmd=filelist
ページの一覧を各ページが記録されているファイル名と共に表示する。
主として管理者がメンテナンス用途に使用する。
コマンド
ブロック型プラグイン
★★★☆☆
?cmd=freeze&page=ページ名 #freeze
対象のページを凍結し、不用意に変更できないようにします。
コマンドとして使用された場合は、page=で指定したページを凍結し、ブロック型プラグインとして使用された場合は編集したページを凍結します。
ページ名はエンコードされている必要がある。
ブロック型プラグイン
★☆☆☆☆
#img(,clear)
refプラグインに統合されたため、基本的に使用することはない。
テキストの回り込み解除のために残っている。
ブロック型プラグイン
★★★☆☆
#include(ページ名)
記述した位置に引数で指定したページを表示する。
ブロック型プラグイン
★★☆☆☆
#includesubmenu(ページ名表示)
現在表示中のページによって、MenuBarに表示する内容を切り替える為に使用する。
コマンド
ブロック型プラグイン
★☆☆☆☆
#insert
記述した位置に複数行入力欄とボタンを表示する。
ボタンを押下すると入力欄に入力した内容をページに挿入する。
コマンド
★☆☆☆☆
?cmd=interwiki&page=ページ名
コマンド
★★☆☆☆（管理者）
?plugin=links
ページ間のキャッシュを更新します。通常使用する必要はありません。
メンテナンス作業などでページが記録されているファイルを直接操作した場合にキャッシュとページの記述内容の整合性がとれなくなるため、実行する必要があります。
実行の際に管理者パスワードを要求されます。
コマンド
★★★★☆
?cmd=list
ページの一覧を表示する
コマンド
ブロック型プラグイン
★★★☆☆
#lookup(ラベル,ボタン名,入力値)
記述した位置に入力欄とボタンと表示し、ボタンを押下するとラベルと入力値から生成されたＵＲＬへジャンプします。
ＵＲＬを生成するルールはInterWikiと同様です。無理にInterWikiの記述に直すと［[ラベル:入力欄に入力した値]］となります。
ブロック型プラグイン
★★☆☆☆
#ls([title])
記述したページより階層化されているページのページ名を一覧表示します。
引数にtitleを指定するとページ名に加えてタイトルを表示します。タイトルは各ページの一行目の内容を表示します。省略時はタイトルを表示しません。
より高機能なls2を使用する場合が多い。
コマンド
ブロック型プラグイン
★★★☆☆
#ls2 #ls2(パターン,パラメータ,linkの別名表示)
指定したパターンで始まるページ名を一覧表示します。
パターンには表示するページ名の共通部分を指定します。省略時は"記述したページ名/"となります。パターンを省略して以降のパラメータを指定する場合はカンマが必要です。
パラメータには表示方法のオプションを指定します。（順不同、半角カンマで区切って複数指定可、省略可）
linkの別名表示には、パラメータlinkを指定した際に表示される、 '...'で始まるページの一覧の代わりに表示する文字列を指定します。省略時は '...'で始まるページの一覧となります。
ls プラグインとの違いについて。
ページ名のソートにはnatcasesort()を使っているため、昇順の場合、半角英数字よりも漢字の方が先に表示されます。
コマンド
★☆☆☆☆
?plugin=map[パラメータ]
サイトマップの様にページ間のリンク関係を一覧表示します。
指定したページを起点に、リンクで辿れるページを全てツリー状に表示します。
パラメータには一覧表示方法のオプションを指定します。
reverse=trueを指定したときは、url=trueを指定してもurlは表示されません。
コマンド
★☆☆☆☆
?plugin=md5&md5=文字列
引数に指定した文字列に対するMD5値を表示します。
pukiwiki.ini.phpに指定するPukiWikiの管理者パスワードはパスワードのMD5値で指定しますが、このプラグインを利用すると楽に取得できます。
コマンド
ブロック型プラグイン
★☆☆☆☆
#memo
記述した位置に複数行入力欄とボタンを表示する。
ボタンを押下すると入力欄の記述内容を更新する。
insertプラグインやarticleプラグインと似ているが、入力した内容が入力欄の外へ出力されず、入力欄に留まる点が異なる。
個人用のメモ代わりにPukiWikiを利用している場合、未整理の情報を一時的に溜め込むのに重宝する。
ブロック型プラグイン
★★☆☆☆
#navi(目次ページ)
DocBook風ナビゲーションバーを表示する。
目次となるページに下階層のページが存在する時、それら全てのページ（の先頭と末尾）に記述する事で Prev, Home, Next というリンクを表示します。これによって下階層のページを順に参照するのに便利になります。
目次ページに順番に見て回るページの上階層にあたるページを指定します。
例えば hoge, hoge/1, hoge/2, hoge/3 というページが存在する場合、hoge/2に#navi(hoge)を記述するとhogeに移動するHomeというリンク、hoge/1に移動するPrevというリンク、hoge/3に移動するNextというリンクを表示します。
インライン型プラグイン
★★☆☆☆
&new(日時);
日時に指定した内容が規定の日付以内であった場合にNewと表示します。
標準では5日以内の場合に New を、１日以内の場合に New! を表示します。期間や表示する文字列のパターンは設置者によってカスタマイズ可能です。
日時はPHP関数:strtotimeが認識できる書式である必要があります。
commentプラグインと組み合わせて使用するのが一般的です。
コマンド
ブロック型プラグイン
★★★★★
?plugin=newpage[パラメータ] #newpage(ページ名初期値)
ページを新規作成するか、新規作成するページ名の入力欄を表示します。
パラメータには新規作成するページのオプションを指定します。ページ名はエンコードされている必要があります。（複数指定可、省略可）
ページ名初期値には新規作成するページ名を入力する入力欄に初期表示する文字列を指定します。
ブロック型プラグイン
★★★☆☆
#norelated
ページ下部に表示される関連ページのリンクを非表示にします。
ブロック型プラグイン
インライン型プラグイン
★★☆☆☆
#online &online;
現在PukiWikiを参照している、おおよそのユーザー数を表示します。
ユーザー数は、プラグインを呼び出された時点で記録されたＩＰアドレスとタイムスタンプのうち、５分以内(変更可能)にアクセスのあったアドレスの数です。
ユーザー数のカウントはページ単位でなく、設置されたPukiWiki毎に行っているため、MenuBarなど頻繁に呼び出される場所に記述するかスキンに埋め込むのが普通です。
コマンド
ブロック型プラグイン
★☆☆☆☆
#paint(幅,高さ)
Javaアプレットで描いた絵を、そのページに添付します。
ば科学的愛情で配布されているBBSPainter.jarを使用しています。
幅と高さに、デフォルトのキャンバスサイズを指定します。省略時は(80,60)となります（変更可能）
-pukiwikiのインストールディレクトリに上記BBSPainter.jarを入れるのを忘れないでください。このプラグインが何の役にも立たなくなります。
コマンド
ブロック型プラグイン
★★★☆☆
#pcomment(コメント記録ページ,表示件数,パラメータ)
別ページにコメントを記録して、参照ページに最新の数件だけを表示します。枝にコメントを付けることもできます。
コメント記録ページにはコメントを記録するページ名を指定します。省略すると、pcommentで指定された[ベースページ名/カレントページ名]にコメントが記録されます。指定したページが存在しなくても、最初のコメント記録時に作成されます。
参照先ページに表示するコメントの数を指定します。第1レベルの番号なしリストだけをカウントします。 省略すると、pcommentのデフォルト(通常10件。変更可能)が表示されます。 pageを省略してcountを指定するときは、パラメータの最初にカンマが必要です。
パラメータにはコメントの表示方法、入力方法を指定します。
更新が衝突したときは、予期せぬ場所にコメントが挿入されるのを防ぐため、リプライ先を指定して記入したコメントはaboveまたはbelowの設定にしたがって 一番前か一番後ろに追加されます。
コメント記入後に表示されるページのタイトルに「(#pcommentを書いたページ)を更新しました」と表示されますが、実際に更新されたのはコメントを記録するページです。
コメントを投稿しても、#pcommentが書かれたページは更新されないので、最終更新ページにはコメントを記録したページだけが更新として表示されます。
相対参照([ [../] ]など)は、書いたページと書き込まれたページのどちらかで、意図したとおりに変換されない可能性があります。
ブロック型プラグイン
★★☆☆☆
#popular([件数],[対象外ページ],[今日?フラグ])
よく参照される（人気のある）ページの上位数件を表示します。
件数には一覧の数を指定して下さい。省略時は10件(変更可能)です。
対象外ページには、表示対象外とするページを正規表現で指定します。例えば FrontPage や MenuBar などのページを一覧に表示させたくないときに使用します。
今日人気のページを表示させたい場合は「今日?フラグ」を true に設定して下さい。デフォルトは false (合計アクセス数)です。
プラグイン/counter のカウンター情報を利用しているので、#counter 記述のないページは表示されません。
コマンド
ブロック型プラグイン
★☆☆☆☆
#random(メッセージ)
ランダムなページを表示するプラグイン。
表示するページの候補は設置したページの下階層のページです。
メッセージにはリンクに表示する文字列を指定します。省略時は 'press here.' となります。（変更可）
ブラウザの再読み込み対策はしていません。リロードされるたびにランダムな表示を繰り返します。
コマンド
★★★★★
?cmd=read&page=ページ名
指定したページを表示する。該当ページが存在しない場合は編集状態で開き、ページ名がInterWikiであった場合は、その解決を行う。
plugin=やcmd=が指定されていない場合に内部で暗黙に呼び出されるため、利用者が意識する機会は少ない。
ページ名はエンコードされている必要がある。
ブロック型プラグイン
★★★★★
#recent(件数)
最近更新されたページのうち、最新の数件を表示します。
件数には表示件数を指定します。省略時は10件です。
ブロック型プラグイン
インライン型プラグイン
★★★★☆
#ref(ファイル名,ページ,パラメータ,タイトル]) &ref(ファイル名,ページ,パラメータ,タイトル]);
'#attach'でページに添付されたファイルを指定位置に展開します。
ページに添付したファイル名を指定します（省略時はエラーとなります）。 別ページ名/添付ファイル名とする事で別ページの添付ファイルも指定できます。
ファイルを添付したページをWikiNameかBracketNameで指定します。 このオプションは最初(添付ファイル名の次)に記述してください。 省略時は記述したページです。
ファイルの展開方法を指定できます。
aroundで行った回り込み指定を解除するには imgプラグインを ＃img(,clear) の様に使用して下さい。
コマンド
★★★☆☆
?plugin=rename&refer=ページ名
既存ページの名前を変更します。実行には管理者権限が必要です。
ページの本文のほか、指定されたページ名の差分、バックアップ、添付ファイル、カウンターを一気にリネームします。
ページ名には変更するページの名前を指定します。省略時はページ名の選択または正規表現置換用文字列入力画面が表示されます。
変換結果は：RenameLogページに実行結果を追記されます。
ページ内のリンクの書き換えは行ないません。yetlistなどを駆使して対処してください。
リネーム対象のページが凍結されているかどうかはチェックしていません。
関連ページにリネーム対象の文字列が複数含まれているとおかしくなります。
コマンド
★☆☆☆☆
?cmd=rss #rss
RecentChangesをRSS(RDF Site Summary)0.91に変換して出力します。
RSSはサイトの要約を提供するのに使われるXMLフォーマットです。
コマンド
★☆☆☆☆
?cmd=rss10
RecentChangesをRSS(RDF Site Summary)1.0に変換して出力します。
インライン型プラグイン
★☆☆☆☆
&ruby(ルビ){ルビをふる文字列};文字列にルビをふります。
XHTML 1.1のルビに対応したブラウザでないと、ルビとして表示されません。IE5.5/6では表示できます。Netscape 7/MozillaではXHTML Ruby Supportを組み込めば表示できます。
ルビに対応していないブラウザではルビをふる文字列の直後にルビが( )に入れられて表示されます。
コマンド
★★★★★
?cmd=search[パラメータ]
指定した文字列を含むページの検索を行います。
パラメータには検索条件を指定します。(複数指定可、順不同、省略可)
ブロック型プラグイン
★☆☆☆☆
#server
サーバーの情報(サーバー名、サーバーソフトウエア、サーバー管理者)を表示します。
ブロック型プラグイン
★☆☆☆☆
#showrss(RSSへのパス, テンプレート名, キャッシュ生存時間, 更新日表示フラグ)
指定されたRSSを取得し、一覧表示します。
ページの解釈毎にRSSの取得を行う為、頻繁に参照されるページでshowrssを使用される場合はキャッシュ機能を使うことをお勧めします。相手サイトの更新頻度に応じてキャッシュの生存時間を適宜設定して下さい。
RSSへのパスにはRSSへのファイルパスやURLを指定します。(省略不可)
テンプレート名には取得したRSSの表示方法を指定します。default, menubar, recentが指定できます。（省略時はdefault）
キャッシュ生存時間はキャッシュをクリアする期限（１時間単位）です。省略時、キャッシュ機能は無効となります。
更新日表示フラグはRSSを取得した日付を表示するかどうかを指定します。1を指定した場合のみ表示します。
インライン型プラグイン
★★★☆☆
&size(ピクセル数値){文字列}文字の大きさを指定します。
ピクセル数値には文字の大きさを指定します。
文字列は文字の大きさを変更する文字列を指定します。
コマンド
★☆☆☆☆
?cmd=source&page=ページ名
指定したページの整形前のソースを表示します。
ページ名はエンコードされている必要があります。
コマンド
★☆☆☆☆
?plugin=template&refer=テンプレートページ
既存のページをテンプレートとしてページを新規作成します。
テンプレートページには雛形とするページを指定します。(省略不可)
ページの新規作成時の雛形とするページの読込み機能とは、テンプレートプラグインが雛形とする範囲(行単位)に選択できるのに対して、ページの新規作成では全文をテキストエリアにコピーする点が異なります。
ページ名はエンコードされている必要があります。
コマンド
★☆☆☆☆
?plugin=touchgraph
TouchGraphWikiBrowser用のインデックスを作ります。
ブロック型プラグイン
★★☆☆☆
#tracker
詳細はしろくろのへや:tracker.inc.phpを参照してください。
コマンド
★★★☆☆
?plugin=unfreeze&page=ページ名
ページの凍結を解除します。
ページ名には解除するページ名を指定します。
ページ名はエンコードされている必要があります。
ブロック型プラグイン
インライン型プラグイン
★☆☆☆☆
#version &version;
インストールされているPukiWikiのバージョンを表示する。
コマンド
ブロック型プラグイン
★☆☆☆☆
?plugin=versionlist #versionlist
pukiwiki.phpのあるディレクトリとpluginのディレクトリ内のphpファイルのバージョンを表示する。
コマンド
ブロック型プラグイン
★★☆☆☆
#vote(選択肢１[0],選択肢２[0],選択肢３[投票数][0],[[WikiName]][投票数]…[0])
選択肢と投票ボタンが並んだフォームを表示します。
選択肢には文章の他、WikiName/BracketNameを使用できます。
各選択肢の投票数は容易に改竄できるため、厳密な投票には向きません。
コマンド
★★☆☆☆
?plugin=yetlist
まだ作られていないページを一覧表示する。
既存のページでWikiNameあるいはBracketNameで指定されているが、まだ作られていないページを一覧表示します。
自分以外の誰かがページを書くかもしれないという点は非常にWiki的ですが
