ブロック型プラグイン
★☆☆☆☆
#aname(アンカー名)
指定した位置にアンカー(リンクの飛び先)を設定する。
アンカー名は省略できない。
ブロック型プラグイン
★☆☆☆☆ :
#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を宣言しておかなければいけない。
ブロック型プラグイン
★☆☆☆☆ (一般サイト)
★★★★☆ (ソフト開発サイト)
#bugtrack(ページ名,種別1,種別2…)
指定した位置にbugtrackフォームを設置する。
ページ名はbugtrackで作成される記事の親階層となるページ名を指定する。bugtrackは、記事ごとに指定したページ名の子階層に番号を自動的に振ってページを作成していく。
種別は複数個指定することで選択肢となる。
ソフト開発サイトで重宝するプラグインだが、上記の言語ファイル設定で表示文字列を変更すれば、意見提案コーナーや書評投稿コーナーなど他の用途でも使える。
ブロック型プラグイン
★☆☆☆☆ (一般サイト)
★★★★☆ (ソフト開発サイト)
#bugtrack_list
指定した位置にbugtrack一覧を設置する。
通常はbugtrackプラグインと並べて使用する。
bugtrack_listプラグインの中からbugtrackプラグインを呼び出しているため、bagtrackプラグインがないと機能しない。
ブロック型プラグイン
★☆☆☆☆
#calendar(ページ名,年月) #calendar_edit(ページ名,年月) #calendar_read(ページ名,年月)
指定した位置にカレンダーを設置する。
ページ名を省略すると設置したページのページ名になる。ページ名はWikiNameまたはBracketNameで指定する。
年月日はyyyymmの形式で指定する。省略した場合は現在の年月になる。
calendar_editは編集用、calendar_readは表示専用。
より高機能なcalendar2プラグインがあるため、あえてcalendarプラグインを使う必要性はほとんどなくなった。
calendar_editプラグイン及びcalendar_readプラグインの中からcalendarプラグインを呼び出しているため、calendarプラグインがないと機能しない。
ブロック型プラグイン
★★★☆☆
#calendar_viewer(ページ名,年月,表示モード,年月日表示の区切り文字)
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となるため、注意が必要。
コマンド
ブロック型プラグイン
★★★★★
#comment(引数)
引数へはabove,below,nodate,nonameのいずれかを指定する(順不同、半角カンマで区切って複数指定可、省略可)。
ブロック型プラグイン
★★★☆☆
#counter
today、yesterday、totalのカウンタを表示する。
ブロック型プラグイン
★☆☆☆☆
#img(,clear)
refプラグインに統合されたため、基本的に使用することはない。
テキストの回り込み解除のために残っている。
ブロック型プラグイン
★★★☆☆
#include(ページ名)
記述した位置に引数で指定したページを表示する。
ブロック型プラグイン
★★☆☆☆
#includesubmenu(ページ名表示)
現在表示中のページによって、MenuBarに表示する内容を切り替える為に使用する。
表示中のページの下階層のSubMenuか、同階層にあるSubMenuページをインクルードするプラグイン。
コマンド
ブロック型プラグイン
★☆☆☆☆
#insert
記述した位置に複数行入力欄とボタンを表示する。
ボタンを押下すると入力欄に入力した内容をページに挿入する。
コマンド
ブロック型プラグイン
★★★☆☆
#lookup(ラベル,ボタン名,入力値)
記述した位置に入力欄とボタンと表示し、ボタンを押下するとラベルと入力値から生成されたURLへジャンプします。
URLを生成するルールはInterWikiと同様です。無理にInterWikiの記述に直すと[[ラベル:入力欄に入力した値]]となります。
ブロック型プラグイン
★★☆☆☆
#ls([title])
記述したページより階層化されているページのページ名を一覧表示します。
引数にtitleを指定するとページ名に加えてタイトルを表示します。タイトルは各ページの一行目の内容を表示します。省略時はタイトルを表示しません。
より高機能なls2を使用する場合が多い。
コマンド
ブロック型プラグイン
★★★☆☆
#ls2 #ls2(パターン,パラメータ,linkの別名表示)
指定したパターンで始まるページ名を一覧表示します。
パターンには表示するページ名の共通部分を指定します。省略時は"記述したページ名/"となります。パターンを省略して以降のパラメータを指定する場合はカンマが必要です。
パラメータには表示方法のオプションを指定します。(順不同、半角カンマで区切って複数指定可、省略可)
linkの別名表示には、パラメータlinkを指定した際に表示される、 '...'で始まるページの一覧の代わりに表示する文字列を指定します。省略時は '...'で始まるページの一覧となります。
ls プラグインとの違いについて。
ページ名のソートにはnatcasesort()を使っているため、昇順の場合、半角英数字よりも漢字の方が先に表示されます。
コマンド
★☆☆☆☆
?plugin=map[パラメータ]
サイトマップの様にページ間のリンク関係を一覧表示します。
指定したページを起点に、リンクで辿れるページを全てツリー状に表示します。
パラメータには一覧表示方法のオプションを指定します。
--&refer=ページ名 - 起点となるページを指定します。省略すると、サイトのトップページ(通常はFrontPage)が起点となります。
--&reverse=true - どこへリンクしているかではなく、どこからリンクされているかを一覧表示します。 どこからもリンクされていないページは、画面の後半にまとめて表示されます。
--&url=true - WikiName/BracketName/InterWikiNameに加えて、 ページに記入されているurl(http/https/ftp/mailto)を表示します。
reverse=trueを指定したときは、url=trueを指定してもurlは表示されません。
コマンド
ブロック型プラグイン
★☆☆☆☆
#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というリンクを表示します。
コマンド
ブロック型プラグイン
★★★★★
?plugin=newpage #newpage
新規作成するページ名の入力欄を表示します。
ブロック型プラグイン
★★☆☆☆
#online
現在PukiWikiを参照している、おおよそのユーザー数を表示します。
ユーザー数は、プラグインを呼び出された時点で記録されたIPアドレスとタイムスタンプのうち、5分以内(変更可能)にアクセスのあったアドレスの数です。
ユーザー数のカウントはページ単位でなく、設置されたPukiWiki毎に行っているため、MenuBarなど頻繁に呼び出される場所に記述するかスキンに埋め込むのが普通です。
コマンド
ブロック型プラグイン
★☆☆☆☆
#paint(幅,高さ)
Javaアプレットで描いた絵を、そのページに添付します。
ば科学的愛情で配布されているBBSPainter.jarを使用しています。
幅と高さに、デフォルトのキャンバスサイズを指定します。省略時は(80,60)となります(変更可能)
-pukiwikiのインストールディレクトリに上記BBSPainter.jarを入れるのを忘れないでください。このプラグインが何の役にも立たなくなります。
コマンド
ブロック型プラグイン
★★★☆☆
#pcomment(コメント記録ページ,表示件数,パラメータ)
別ページにコメントを記録して、参照ページに最新の数件だけを表示します。枝にコメントを付けることもできます。
コメント記録ページにはコメントを記録するページ名を指定します。省略すると、pcommentで指定された[ベースページ名/カレントページ名]にコメントが記録されます。指定したページが存在しなくても、最初のコメント記録時に作成されます。
参照先ページに表示するコメントの数を指定します。第1レベルの番号なしリストだけをカウントします。 省略すると、pcommentのデフォルト(通常10件。変更可能)が表示されます。 pageを省略してcountを指定するときは、パラメータの最初にカンマが必要です。
パラメータにはコメントの表示方法、入力方法を指定します。
更新が衝突したときは、予期せぬ場所にコメントが挿入されるのを防ぐため、リプライ先を指定して記入したコメントはaboveまたはbelowの設定にしたがって 一番前か一番後ろに追加されます。
コメント記入後に表示されるページのタイトルに「(#pcommentを書いたページ)を更新しました」と表示されますが、実際に更新されたのはコメントを記録するページです。
コメントを投稿しても、#pcommentが書かれたページは更新されないので、最終更新ページにはコメントを記録したページだけが更新として表示されます。
相対参照([ [../] ]など)は、書いたページと書き込まれたページのどちらかで、意図したとおりに変換されない可能性があります。
コマンド
ブロック型プラグイン
★☆☆☆☆
#random(メッセージ)
ランダムなページを表示するプラグイン。
表示するページの候補は設置したページの下階層のページです。
メッセージにはリンクに表示する文字列を指定します。省略時は 'press here.' となります。(変更可)
ブラウザの再読み込み対策はしていません。リロードされるたびにランダムな表示を繰り返します。
ブロック型プラグイン
★★★★★
#recent(件数)
最近更新されたページのうち、最新の数件を表示します。
件数には表示件数を指定します。省略時は10件です。
ブロック型プラグイン
★★★★☆
#ref(ファイル名,ページ,パラメータ,タイトル])
'#attach'でページに添付されたファイルを指定位置に展開します。
ファイル名にはページに添付したファイル名を指定します(省略時はエラーとなります)。別ページ名/添付ファイル名とする事で別ページの添付ファイルも指定できます。
ページにはファイルを添付したページをWikiNameかBracketNameで指定します。このオプションは最初(添付ファイル名の次)に記述してください。省略時は記述したページです。
パラメータにはファイルの展開方法を指定できます。
--left|center|right - 表示時の位置を指定します。省略時はleft(変更可)です。
--wrap|nowrap - テーブルタグで囲む/囲まないの指定を行います。省略時はnowrap(変更可)です。
--around - テキストの回り込みを可能とします。省略時は回り込みを行いません。
--noicon - ファイルが画像以外の場合に表示されるアイコンを表示しません。省略時は表示します。
--noimg - ファイルが画像の場合に画像を展開しないようにします。省略時は展開します。
--nolink - 元ファイルへのリンクを張らないようにします。省略時はリンクします。
--zoom - 縦横比を保持します。省略時はサイズ指定に従います。
--999x999 - サイズを指定します(幅x高さ)。省略時は拡大率あるいは対象画像のサイズに従います。
--999% - サイズを指定(拡大率)します。省略時は100%です、
--上記以外 - 上記以外のパラメータは画像の代替文字列、リンクのタイトル属性として使用されます。ページ名やパラメータに見える文字列を使用するときは、#ref(hoge.png,,zoom)のようにタイトルの前にカンマを余分に入れます。
aroundで行った回り込み指定を解除するには imgプラグインを #img(,clear) の様に使用して下さい。
コマンド
★★★☆☆
?plugin=rename&refer=ページ名
既存ページの名前を変更します。実行には管理者権限が必要です。
ページの本文のほか、指定されたページ名の差分、バックアップ、添付ファイル、カウンターを一気にリネームします。
ページ名には変更するページの名前を指定します。省略時はページ名の選択または正規表現置換用文字列入力画面が表示されます。
変換結果はRenameLogページに実行結果を追記されます。
ページ内のリンクの書き換えは行ないません。yetlistなどを駆使して対処してください。
リネーム対象のページが凍結されているかどうかはチェックしていません。
関連ページにリネーム対象の文字列が複数含まれているとおかしくなります。
ブロック型プラグイン
★☆☆☆☆
#server
サーバーの情報(サーバー名、サーバーソフトウエア、サーバー管理者)を表示します。
ブロック型プラグイン
★☆☆☆☆
#showrss(RSSへのパス, テンプレート名, キャッシュ生存時間, 更新日表示フラグ)
指定されたRSSを取得し、一覧表示します。
ページの解釈毎にRSSの取得を行う為、頻繁に参照されるページでshowrssを使用される場合はキャッシュ機能を使うことをお勧めします。相手サイトの更新頻度に応じてキャッシュの生存時間を適宜設定して下さい。
RSSへのパスにはRSSへのファイルパスやURLを指定します。(省略不可)
テンプレート名には取得したRSSの表示方法を指定します。default, menubar, recentが指定できます。(省略時はdefault)
キャッシュ生存時間はキャッシュをクリアする期限(1時間単位)です。省略時、キャッシュ機能は無効となります。
更新日表示フラグはRSSを取得した日付を表示するかどうかを指定します。1を指定した場合のみ表示します。
コマンド
★☆☆☆☆
?cmd=source&page=ページ名
指定したページの整形前のソースを表示します。
ページ名はエンコードされている必要があります。
コマンド
★☆☆☆☆
?plugin=template&refer=テンプレートページ
既存のページをテンプレートとしてページを新規作成します。
テンプレートページには雛形とするページを指定します。(省略不可)
ページの新規作成時の雛形とするページの読込み機能とは、テンプレートプラグインが雛形とする範囲(行単位)に選択できるのに対して、ページの新規作成では全文をテキストエリアにコピーする点が異なります。
ページ名はエンコードされている必要があります。
ブロック型プラグイン
★☆☆☆☆
#version
インストールされているPukiWikiのバージョンを表示する。
コマンド
ブロック型プラグイン
★☆☆☆☆
?plugin=versionlist #versionlist
pukiwiki.phpのあるディレクトリとpluginのディレクトリ内のphpファイルのバージョンを表示する。
コマンド
ブロック型プラグイン
★★☆☆☆
#vote(選択肢1,選択肢2,選択肢3[投票数],[[WikiName]][投票数]…)
選択肢と投票ボタンが並んだフォームを表示します。
選択肢には文章の他、WikiName/BracketNameを使用できます。
各選択肢の投票数は容易に改竄できるため、厳密な投票には向きません。
コマンド
★★☆☆☆
?plugin=yetlist
まだ作られていないページを一覧表示する。
既存のページでWikiNameあるいはBracketNameで指定されているが、まだ作られていないページを一覧表示します。
自分以外の誰かがページを書くかもしれないという点は非常にWiki的ですが、実際の運用面ではcommentに記述された一見さんの名前やWikiName同様のパラメータ名など、ページ化しにくいキーワードが大量に引っかかってしまいます。