Top > 编写语法 > 插件 > 基本插件集

add Edit

種別

コマンド[命令]

重要度

★☆☆☆☆

書式
?cmd=add &page=ページ名
概要

実行すると編集画面が表示されます。更新ボタンを押すと、指定した既存ページの末尾に編集欄で入力した内容が追加されます。

引数

ページ名は省略できません。ページ名はエンコードされている必要があります。

edit?が編集画面に既存のページ内容を表示するのに対し、addは常に編集画面が空となります。不用意に既存の入力内容を変更する事がないため、単純に追記していくだけのページではaddを使うと便利です。

備考

もともとデフォルトのskinでメニューの「追加」として使われていましたが、editコマンド(編集)で事足りるため、デフォルトのskinではメニューから外されています。

aname Edit

種別

インライン型プラグイン

ブロック型プラグイン

重要度

★★★★☆

書式

&aname( アンカー名 [,{[super], [full], [noid]}, アンカー文字列] );

#aname( アンカー名 [,{[super], [full], [noid]}, アンカー文字列] )

概要

指定した位置にアンカー(リンクの飛び先)を設定します。

引数

アンカー名の値がアンカーのフラグメント指定子に使用されます。アンカー名は省略できません。アンカー名には半角英字（大文字／小文字）が使用可能です。

super,full,noid でアンカーの出力方式を指定します。

  • super − アンカー文字列を上付き表示します。省略時は上付き表示されません。
  • full − フラグメント指定子以外のURIを補ってアンカーを出力します。省略時はフラグメント指定子のみ出力されます。
  • noid − アンカーにフラグメント指定子を出力しません。

アンカー文字列が指定された場合、指定した文字列に対してアンカーが出力されます。アンカーの存在を利用者に明示したい場合に利用します。省略時は空文字に対するアンカーとなります。

備考

通常はインライン型プラグインとして使用します。2つのブロック型プラグインに挟まれた部分にアンカー設定したい場合にインラインプラグインとして記述できないため、ブロック型プラグインとしても使えるようにしてあります。

PukiWiki本体処理でanameプラグインを内部的に呼び出しているため、必ず組み込む必要があります。

article Edit

種別

（コマンド）[命令]

ブロック型プラグイン

重要度

★★★☆☆

書式
#article
概要

指定した位置に簡易掲示板を設置します。

プラグイン内設定

  • article_COLS　テキストエリアのカラム数
  • article_ROWS　テキストエリアの行数
  • NAME_COLS　名前テキストエリアのカラム数
  • SUBJECT_COLS　題名テキストエリアのカラム数
  • NAME_FORMAT　名前の挿入フォーマット
  • SUBJECT_FORMAT　題名の挿入フォーマット
  • ARTICLE_INS　入力内容を入力欄の前後どちらに挿入するか
  • ARTICLE_COMMENT　書き込みの下に一行コメントを入れるか
  • ARTICLE_AUTO_BR　改行を自動的変換するか
  • MAIL_AUTO_SEND　投稿内容のメール自動配信をするか
  • MAIL_FROM　投稿内容のメール送信時の送信者メールアドレス
  • MAIL_SUBJECT_PREFIX　投稿内容のメール送信時の題名
  • $_mailto　投稿内容のメール自動配信先アドレス

attach Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★★★★★

書式
#attach( [nolist] [,noform] )
概要

ページの添付ファイルの一覧を表示し、ファイル添付のための入力フォームを設置します。

引数

nolist, noform で表示内容を指定します。

  • nolist − ページの添付ファイルの一覧を表示しません。省略時は一覧を表示します。
  • noform − ファイル添付のための入力フォームを表示しません。省略時は入力フォームを表示します。
プラグイン内設定

  • MAX_FILESIZE　ファイルアップロードの上限
  • ATTACH_UPLOAD_ADMIN_ONLY　管理者だけが添付ファイルをアップロードできるようにするか
  • ATTACH_DELETE_ADMIN_ONLY　管理者だけが添付ファイルを削除できるようにするか
  • ATTACH_DELETE_ADMIN_NOBACKUP ATTACH_DELETE_ADMIN_ONLY=TRUEのとき、管理者が添付ファイルを削除するときは、バックアップを作らない
  • ATTACH_PASSWORD_REQUIRE　アップロード/削除時にパスワードを要求するか(ADMIN_ONLYが優先)
  • ATTACH_FILE_MODE アップロードされたファイルのアクセス権
  • FILE_ICON　アイコンイメージのファイル
  • ATTACH_CONFIG_PAGE_MIME　ダウンロード時のmime-typeを記述したページ
#navi(contents-page-name): No such page: PukiWiki/1.4/マニュアル/プラグイン

back Edit

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#back( [[表示文字列] [,[left| center| right] [,[0| 1] [,[戻り先] ]]]] )
概要

指定した位置に戻り先へのリンクを設置します。

引数

表示文字列は省略すると「戻る」になります。

left、center、rightで表示位置を指定します。省略時はcenterになります。

  • left − リンクを左寄せで表示します。
  • center − リンクを中央寄せで表示します。
  • right − リンクを右寄せで表示します。

0、1で水平線の有無を指定します。省略すると1になります。

  • 0 − 水平線を表示しません。
  • 1 − 水平線を表示します。

戻り先はURLで指定します。現状ではWikiNameやBracketNameを指定できません。省略すると直前に参照していたページが戻り先になりますが、利用者のブラウザの設定がJavaScript onでないと機能しません。

備考

JavaScriptを使わない場合は、InterWikiName及びAliasでbackプラグインと同じことが簡単に実現できます。backプラグインでは戻り先をWikiNameやBracketNameで指定できないため、JavaScriptを使わないとPukiWiki内での移動には使いにくいです。

backup Edit

種別

コマンド

重要度

★★★★★

書式
?cmd=backup [&page=ページ名]
概要

指定したページ、あるいは全体のバックアップ一覧を表示します。

引数

ページ名を省略すると、PukiWiki全体のバックアップ一覧を表示します。ページ名はエンコードされている必要があります。

br Edit

種別

インライン型プラグイン

重要度

★★☆☆☆

書式
&br;
概要

文章中で改行を行います。

段落やリスト、テーブル内など、行末の~による改行ではブロック要素を抜けてしまう個所で改行や空行の挿入するために用います。

bugtrack Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★☆☆☆☆ (一般サイト)

★★★★☆ (ソフト開発サイト)

書式
#bugtrack( [[ページ名] [,カテゴリー1…カテゴリーn]] )
概要

バグ追跡システムの一部分であるバグレポートの入力フォームを設置します。

引数

ページ名にはバグレポートとして作成されるページの親階層となるページ名を指定します。省略時は設置したページとなります。
通常、バグレポートには指定したページ名の子階層に自動的に番号が振られてページが作成されます。つまり"バグ報告ページ"と指定して設置した場合は、バグ報告ページ/1,バグ報告ページ/2,バグ報告ページ/3…のようにバグレポートのページが作成される事になります。

カテゴリーにはバグの対象となりうる要素を指定します。省略時は入力欄となります。

備考

ソフト開発サイトで重宝するプラグインです。もしバグ追跡以外の用途でバグレポートのように定型的な項目を持ったページを作成するフォームが欲しい場合，あるいはバグレポートの項目をカスタマイズしたい場合はtracker?プラグインを使用して下さい。

bugtrack_list Edit

種別

ブロック型プラグイン

重要度

★☆☆☆☆ (一般サイト)

★★★★☆ (ソフト開発サイト)

書式
#bugtrack_list( [ページ名] )
概要

バグ追跡システムの一部分であるバグレポートの一覧表示を行います。

引数

ページ名にはバグレポートとして作成されるページの親階層となるページ名を指定します。省略時は設置したページとなります。

calendar、calendar_edit、calendar_read Edit

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式

#calendar( [{[ページ名], [年月]}] )

#calendar_edit( [{[ページ名], [年月]}] )

#calendar_read( [{[ページ名], [年月]}] )

概要

指定した位置にカレンダーを設置します。カレンダー上でyyyy/mm/ddという日付を選択すると、ページ名/yyyymmddというページを編集／表示できます。

カレンダーの日付を選択した場合に該当するページを編集状態、表示状態のどちらで開くかが３つのプラグインの違いです。calendar_editとは編集状態で、calendar, calendar_readは表示状態で開きます。

引数

ページ名はWikiNameまたはBracketNameで指定します。 ページ名を省略すると設置したページのページ名になります。

年月は表示するカレンダーの西暦と月をyyyymmの形式で指定します。省略した場合は現在の年月になります。

備考

より高機能なcalendar2プラグインがあるため、あえてcalendarプラグインを使う必要性はほとんどなくなりました。

calendar_editプラグイン及びcalendar_readプラグインの中からcalendarプラグインを呼び出しているため、calendarプラグインがないと機能しません。

calendar_viewer Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★★★☆☆

書式
#calendar_viewer( ページ名, yyyy-mm| n| x*y| this [,[past|future|view] [,年月日表示の区切り文字]] )
概要

calendarプラグインまたはcalendar2プラグインで作成されたページを指定した位置に表示します。

引数

ページ名はcalendarプラグインまたはcalendar2プラグインを設置しているページの名前を指定します。ページ名はWikiNameまたはBracketNameで指定します。

yyyy-mmを指定時、指定した年月のページを表示します。

数字を指定時、指定した件数分のページを表示します。

x*yを指定時、先頭より数えて x ページ目(先頭は0)から、y件づつ一覧表示します。x と yはいずれも数値です。

thisを指定時、今月のページを一覧表示します。

past、future、viewで表示するページの条件を指定します。省略/無指定時はpastとなります。

  • past − 今日以前のページを表示します。
  • future − 今日以降のページを表示します。
  • view − 過去から未来へ一覧表示します。

年月日の区切り文字は-や/などを指定します。省略した場合は-になります。

備考

calendar2プラグインでは今日の日付の記事がない場合、記事を表示しないため、午前0時になったとたんに記事が表示されなくなるという弱点がありました。calendar_viewerはその弱点を補うために開発されたプラグインです。calendar_viewは、日付が変わっても最新の記事を表示することができます。カレンダーそのものの表示はcalendar2(off)で行ないます。

calendar2 Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★★★☆☆

書式
#calendar2( [{[ページ名|*], [yyyymm], [off]}] )
概要

指定した位置にカレンダーを設置します。表示月のとなりに表示されたリンク(<< および >>)を選択することで先月／次月分のカレンダーを表示できます。カレンダー上でyyyy/mm/ddという日付を選択すると、ページ名/yyyy-mm-ddというページを表示できます。当日分のページが作成されていた場合、カレンダーの右隣に当日分のページ内容を表示します。

引数

ページ名で表示するページの上位階層のページを指定できます。ページ名を省略すると設置したページのページとなります。ページ名に*を指定すると上位階層のページはなし（表示するページ名がyyyy-mm-dd）となります。

yyyymmで表示するカレンダーの西暦と月を指定できます。省略時は当日の年月となります。

offを指定時、当日分ページを表示する機能は抑制されます。省略時は当日分のページを表示します。

備考

calender_editで作成したページはページ名/yyyymmddとなり、calender2で作成したページはページ名/yyyy-mm-ddとなるため、注意が必要です。

clear Edit

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#clear
概要

refプラグインのaroundオプションで有効となったテキスト回り込み指定を解除します。

備考

imgプラグインのclearオプション指定時と処理内容は同等です。

color Edit

種別

インライン型プラグイン

重要度

★★★★☆

書式
&color( 文字色 [,背景色] ){ 文章 };
概要

引数で指定したインライン要素(主に文章)の、文字色・背景色を指定します。

引数

文字色には文章の文字色を6桁の16進数値(rrggbb)か、色名で指定します。

背景色には文章の背景色を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 Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★★★★★

書式
#comment( {[above], [below], [nodate], [noname]} )
概要

コメントの入力用の入力欄を表示します。

引数

コメントの挿入方法を引数で指定します。

  • above − 入力したコメントがコメント入力欄の上に追加します
  • below − 入力したコメントがコメント入力欄の下に追加します（省略時はaboveが指定されたとみなします）
  • nodate − コメント記入者名の入力欄を非表示とします（省略時は表示します）
  • noname − 挿入するコメントに、挿入時刻を付加しない（省略時は付加します）
プラグイン内設定

  • COMMENT_NAME_COLS　コメントの名前テキストエリアの表示幅
  • COMMENT_COLS　コメントのテキストエリアの表示幅
  • COMMENT_NAME_FORMAT　名前欄の挿入フォーマット
  • COMMENT_MSG_FORMAT　コメント欄の挿入フォーマット
  • COMMENT_NOW_FORMAT　時刻欄の挿入フォーマット
  • COMMENT_FORMAT　コメント内容全体の挿入フォーマット
  • COMMENT_INS　コメントを入力欄の前後どちらに挿入するか
  • COMMENT_MAIL　コメントが投稿された場合、内容を送るメールアドレス

contents Edit

種別

擬似ブロック型プラグイン

重要度

★★★☆☆

書式

#contents

概要

設置したページ中の見出しの一覧を表示します。

counter Edit

種別

ブロック型プラグイン

インライン型プラグイン

重要度

★★★☆☆

書式

#counter

&counter( [total| yesterday| total] );

概要
访问人数计数器
引数
  • total − 总访问人数
  • today − 今日访问人数
  • yesterday − 昨日访问人数

diff Edit

種別

コマンド

重要度

★★★★★

書式
?cmd=diff &page=ページ名
概要

指定したページの現在の内容と最後のバックアップ状態との差分を表示します。

引数

ページ名に変更差分を表示するページを指定します。ページ名はエンコードされていなければなりません。

edit Edit

種別

コマンド

重要度

★★★★★

書式
?cmd=edit &page=ページ名
概要

指定したページを編集します。

引数

ページ名に編集するページを指定します。ページ名はエンコードされていなければなりません。

filelist Edit

種別

コマンド

重要度

★☆☆☆☆

書式
?cmd=filelist
概要

ページの一覧を各ページが記録されているファイル名と共に表示します。

備考

主として管理者がメンテナンス用途に使用します。

freeze Edit

種別

コマンド

ブロック型プラグイン

重要度

★★★☆☆

書式
?cmd=freeze &page=ページ名

#freeze

概要

対象のページを凍結し、不用意に変更できないようにします。

引数

ページ名には凍結するページを指定します。ページ名はエンコードされている必要があります。ブロック型プラグインとして使用された場合は設置したページを凍結します。

hr Edit

種別

インライン型プラグイン

重要度

★★☆☆☆

書式
&hr;
概要

文中に水平線を挿入します。

備考

段落やリスト、テーブル内など、通常の水平線書式(----)ではブロックを抜けてしまう個所で水平線を挿入するために用います。リスト内など左右マージンが設定されている場合は、それを引き継ぎます。

img Edit

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#img( 画像URL[, right| r| left| l| clear| c,[ clear| c ]] )
概要

添付ファイル以外の画像を表示するために開発されましたが、該当機能がrefプラグインに統合されたため、基本的に使用することはありません。過去との互換性のために残っています。

引数

画像URLには表示する画像のURLを指定します。 画像にはjpeg(jpg), gif, png のみ指定可能です。

right,r,left,l,clear,c で画像の表示位置とテキストの回りこみを指定します。省略時は left が指定されたとみなします。

  • right,r − 画像を右寄せで表示します。
  • left,l − 画像を右寄せで表示します。
  • clear,c − テキストの回りこみを解除します。内部的には right,r,left,l 以外は全てclearが選択されたと見なされます。
プラグイン内設定

  • PLUGIN_IMG_CLEAR　clear指定時に出力するタグ

include Edit

種別

ブロック型プラグイン

重要度

★★★☆☆

書式
#include( ページ名 )
概要

記述した位置に指定したページを挿入して、複数のページをあたかも１つのページであるかのように表示します。

引数

ページ名には挿入するページを指定します。

プラグイン内設定

  • PLUGIN_INCLUDE_MAX　一度にインクルードできるページの最大数

includesubmenu Edit

種別

ブロック型プラグイン

重要度

★★☆☆☆

書式
#includesubmenu( [showpagename] )
概要

現在表示中のページによって、MenuBarに表示する内容を切り替える為に使用します。

表示中のページの下階層のSubMenuか、同階層にあるSubMenuページを挿入表示するプラグインです。

引数

showpagename を指定すると、挿入表示するページのページ名を表示します。省略時はページ名を非表示とします。

insert Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#insert
概要

記述した位置に複数行入力欄とボタンを表示します。

ボタンを押下すると入力欄に入力した内容をページに挿入します。

プラグイン内設定

  • INSERT_COLS　編集欄の表示幅
  • INSERT_ROWS　編集欄の表示行数
  • INSERT_INS　入力内容を入力欄の前後どちらに挿入するか

interwiki Edit

種別

コマンド

重要度

★☆☆☆☆

書式
?cmd=interwiki &page=InterWiki名
概要

InterWikiを記述した際にPukiWikiが内部的に呼び出します。使用者が意識して使用する機会はありません。

引数

InterWiki名にはジャンプ先をInterWiki形式で指定します。InterWiki名はエンコードされている必要があります。

links Edit

種別

コマンド

重要度

★★☆☆☆（管理者）

書式
?plugin=links
概要

ページ間のキャッシュを更新します。通常使用する必要はありません。

メンテナンス作業などでページが記録されているファイルを直接操作した場合にキャッシュとページの記述内容の整合性がとれなくなるため、実行する必要があります。

備考

実行の際に管理者パスワードを要求されます。

list Edit

種別

コマンド

重要度

★★★★☆

書式
?cmd=list
概要

ページの一覧を表示します。

lookup Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★★★☆☆

書式
#lookup( InterWikiName, ボタン名 [,初期値] )
概要

記述した位置に入力欄とボタンと表示し、ボタンを押下するとラベルと入力値から生成されたＵＲＬへジャンプします。

ＵＲＬを生成するルールはInterWikiと同様です。無理にInterWikiの記述に直すと［[InterWikiName:入力欄に入力した値]］となります。

引数

InterWikiNameにはＵＲＬの生成に使用するInterWikiNameを指定します。

ボタン名にはボタンに表示するキャプションを指定します。

初期値には入力欄の初期値を指定します。省略時は空欄です。

ls Edit

種別

ブロック型プラグイン

重要度

★★☆☆☆

書式
#ls( [title] )
概要

記述したページより階層化されているページのページ名を一覧表示します。

引数

titleを指定した場合、ページ名に加えてタイトルを表示します。タイトルは各ページの一行目の内容を表示します。省略時はタイトルを表示しません。

備考

実際には、より高機能なls2を使用する機会が多いと思われます。

ls2 Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★★★☆☆

書式
#ls2( [[パターン] [, { [title], [include], [reverse], [compact], [link] } [,linkの別名表示] ]] )
概要

指定したパターンで始まるページ名を一覧表示します。

引数

パターンには表示するページ名の共通部分を指定します。省略時は"設置したページ名/"となります。

title,include,reverse,compact,link で表示方法を指定します。

  • title − ページに含まれる見出し(*,**,***)の一覧を併記します。
  • include − 下位層のページが#includeを使用していた場合、includeしているページの一覧を表示します。
  • reverse − ページの並び順を反転し、名前の降順に表示します。省略すると名前の昇順に表示されます。
  • compact − 見出しレベルを調整します。
  • link − #ls2を書いた位置に一覧を表示する代わりにリンクを表示します。このリンクを選択すると別画面にページの一覧を表示するようにします。

linkの別名表示には、パラメータlinkを指定した際に表示される文字列の代わりの文字列を指定します。省略時は '...'で始まるページの一覧となります。

プラグイン内設定

  • LS2_CONTENT_HEAD　見出しアンカーの書式
  • LS2_ANCHOR_ORIGIN　見出しアンカーの開始番号
  • LS2_LIST_COMPACT　compactオプション省略時、見出しレベルを調整するか
備考

ls プラグインとの違いについて。

  • 階層化されたページの起点となるページが、lsでは記述したページ固定だが、ls2ではパラメータで指定できます。
  • titleパラメータを指定した場合に、lsでは「ページの一行目」が表示されるが、ls2では「見出しの一覧」を表示します。
  • include, link という表示オプションが追加されています。

ページ名のソートにはnatcasesort()を使っているため、昇順の場合、半角英数字よりも漢字の方が先に表示されます。

map Edit

種別

コマンド

重要度

★☆☆☆☆

書式
?plugin=map [&refer=ページ名] [&reverse=true]
概要

サイトマップの様にページ間のリンク関係を一覧表示します。

指定したページを起点に、リンクで辿れるページを全てツリー状に表示します。

引数

引数には一覧表示方法のオプションを指定します。

  • &refer=ページ名 − 起点となるページを指定します。省略すると、サイトのトップページ(通常はFrontPage)が起点となります。
  • &reverse=true − どこへリンクしているかではなく、どこからリンクされているかを一覧表示します。 どこからもリンクされていないページは、画面の後半にまとめて表示されます。

md5 Edit

種別

コマンド

重要度

★☆☆☆☆

書式
?plugin=md5 &md5=文字列
概要

引数に指定した文字列に対するMD5値を表示します。

引数

文字列にはMD5値を取得したい文字列を指定します。

備考

pukiwiki.ini.phpに指定するPukiWikiの管理者パスワードはパスワードのMD5値で指定しますが、このプラグインを利用すると楽に取得できます。

menu Edit

種別

ブロック型プラグイン

重要度

★★★★☆

書式
#menu( ページ名 )
概要

デフォルトのスキンにて、ページの左側にメニュー用のページ(MenuBar)を表示するために内部的に使用されています。

任意のページでブロック型プラグインとして使用すると、引数に指定したページをメニュー用ページに指定できます。
例えば通常はMenuBarを表示するサイトで、hogeというページだけはMenuBarの代わりにhogeMenuというページを表示したい場合、hogeというページに #menu(hogeMenu) と記述する事で実現できます。

ソース中のMENU_ENABLE_SUBMENU をTRUEとすると、表示中のページの上位階層のMenuBarか、同階層にあるMenuBarページをメニューとして表示するようになります。
例えば FrontPage, MenuBar, hoge, fuga, hoge/MenuBar, hoge/hoge というページが存在する場合は、FrontPage、fuga、MenuBar では MenuBar がメニューとして表示され、hoge, hoge/MenuBar, hoge/hogeでは hoge/MenuBar がメニューとして表示されます。

引数

メニュー用ページとして表示するページ名を指定します。

プラグイン内設定

  • MENU_ENABLE_SUBMENU　サブメニューを使用するか
  • MENU_SUBMENUBAR　サブメニューを使用する場合にメニューとして呼び出されるページ名。デフォルトは MenuBar。
備考

デフォルトのメニュー用ページをMenuBar以外のページとする場合は、pukiwiki.ini.php の $menubar を変更して下さい。

navi Edit

種別

ブロック型プラグイン

重要度

★★☆☆☆

書式
#navi( [目次ページ] )
概要

DocBook風ナビゲーションバーを表示します。

目次となるページに下階層のページが存在する時、それら全てのページ（の先頭と末尾）に記述する事で Prev, Home, Next というリンクを表示します。これによって下階層のページを順に参照するのに便利になります。

引数

目次ページに順番に見て回るページの上階層にあたるページを指定します。

例えば hoge, hoge/1, hoge/2, hoge/3 というページが存在する場合、hoge/2に#navi(hoge)を記述するとhogeに移動するHomeというリンク、hoge/1に移動するPrevというリンク、hoge/3に移動するNextというリンクを表示します。

ページで最初に呼び出した場合はヘッダイメージのリンクを出力します。ページで２度目以降に呼び出された場合はフッタイメージのリンクを出力します。現在のページが目次ページである場合は対象となるページの一覧を表示します。

プラグイン内設定

  • NAVI_EXCLUDE_PATTERN　除外するページを正規表現で指定する
  • NAVI_LINK_TAGS　<link>タグを出力するかどうか

new Edit

種別

インライン型プラグイン

重要度

★★☆☆☆

書式
書式1:
&new( [nodate] ){ 日付文字列 };
書式2:
&new( [ページ名] [,nolink] );
概要

指定した日時が最近であった場合、最近更新された事を強調表示します。日時の指定は直接日付時刻を記述する方法(書式1)と、指定したページ（群）の最終更新日時を採用する方法(書式2)の２通りがあります。

標準では5日以内の場合に New を、１日以内の場合に New! を表示します。期間や表示する文字列のパターンは設置者によってカスタマイズ可能です。

引数

書式1:

日付文字列を指定した場合、その日時が規定の期間内であった場合に強調表示します。省略した場合はページの更新日時をチェックする記述であると見なされます。

  • nodate − 日付文字列を表示しません。省略時は表示します。

書式2:

ページ名を指定した場合は、そのページの更新日時が規定の期間内であった場合に強調表示します。省略した場合は、プラグインを記述したそのページを指定したと見なします。

ページ名末尾が/であった場合、そのページ名で始まるページ群の中で最後の更新日時が規定の日付以内であった場合に強調表示します。

  • nolink − ページ名を表示しません。省略時はページ名（ページ群で指定した場合は最後に更新されたページ名）を表示します。
プラグイン内設定

  • NEW_MESSAGE　表示フォーマット
備考

日付文字列はPHP関数:strtotimeが認識できる書式である必要があります。

newpage Edit

種別

コマンド

ブロック型プラグイン

重要度

★★★★★

書式
?plugin=newpage &page=ページ名 &refer=関連ページ名

#newpage( [ページ名初期値] )

概要

ページを新規作成するか、新規作成するページ名の入力欄を表示します。

引数

コマンド:

パラメータには新規作成するページのオプションを指定します。

ページ名には新規作成するページ名を指定します。省略時は新規作成するページ名の入力するためのページを表示します。ページ名はエンコードされている必要があります。

関連ページ名にはリンク元のページ名を指定します。新規作成するページの先頭に、ここで指定したページへのリンクが自動的に埋め込まれます。ページ名はエンコードされている必要があります。

ブロック型プラグイン:

ページ名初期値には新規作成するページ名を入力する入力欄に初期表示する文字列を指定します。

norelated Edit

種別

ブロック型プラグイン

重要度

★★★☆☆

書式
#norelated
概要

ページ下部に表示される関連ページのリンクを非表示にします。

備考

極端に多くのページからリンクされていて関連リンクの表示が目障りである場合などに利用します。

online Edit

種別

ブロック型プラグイン

インライン型プラグイン

重要度

★★☆☆☆

書式

#online

&online;

概要

現在PukiWikiを参照している、おおよそのユーザー数を表示します。

ユーザー数は、プラグインを呼び出された時点で記録されたＩＰアドレスとタイムスタンプのうち、５分以内(変更可能)にアクセスのあったアドレスの数です。

プラグイン内設定

  • USR_LST　ユーザー情報を保存するファイル
  • TIMEOUT　タイムアウトの秒数
備考

ユーザー数のカウントはページ単位でなく、設置されたPukiWiki毎に行っているため、MenuBarなど頻繁に呼び出される場所に記述するかスキンに埋め込むのが普通です。

paint Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#paint( [幅] [,高さ] )
概要

Javaアプレットで描いた絵を、そのページに添付します。

ば科学的愛情で配布されているBBSPainter.jarを使用しています。

幅と高さに、デフォルトのキャンバスサイズを指定します。省略時は(80,60)となります（変更可能）

プラグイン内設定

  • PAINT_INSERT_INS − 入力内容を先頭/末尾のどちらに挿入するか
  • PAINT_DEFAULT_WIDTH − デフォルトの描画領域の幅
  • PAINT_DEFAULT_HEIGHT − デフォルトの描画領域の高さ
  • PAINT_MAX_WIDTH − 描画領域の幅の上限
  • PAINT_MAX_HEIGHT − 描画領域の高さの上限
  • PAINT_APPLET_WIDTH − アプレット領域の幅
  • PAINT_APPLET_HEIGHT − アプレット領域の高さ
  • PAINT_NAME_FORMAT −名前欄の挿入フォーマット
  • PAINT_MSG_FORMAT − コメント欄の挿入フォーマット
  • PAINT_NOW_FORMAT − 時刻欄の挿入フォーマット
  • PAINT_FORMAT − コメント内容全体の挿入フォーマット（メッセージあり）
  • PAINT_FORMAT_NOMSG − コメント内容全体の挿入フォーマット（メッセージなし）
備考

PukiWikiのインストールディレクトリに上記BBSPainter.jarを入れるのを忘れないでください。このプラグインが何の役にも立たなくなります。

pcomment Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★★★☆☆

書式
#pcomment({ [コメント記録ページ], [表示件数], [noname], [nodate], [above], [below], [reply] })
概要

別ページにコメントを記録して、pcommentを設置した場所に最新の数件だけを表示します。枝にコメントを付けることもできます。

引数

コメント記録ページにはコメントを記録するページ名を指定します。省略すると、pcommentプラグイン内のPCMT_PAGEで指定されたページにコメントが記録されます。デフォルトは[コメント/(設置したページ名)]です。指定したページが存在しなくても、最初のコメント記録時に作成されます。

表示件数は表示するコメントの数を指定します。第1レベルの番号なしリストだけをカウントします。省略すると、pcommentのデフォルト件数(通常10件。PCMT_NUM_COMMENTSで変更可能)が表示されます。
表示件数はコメント記録ページより後に指定して下さい。コメント記録ページを省略して表示件数を指定する場合は、コメント記録ページに空白を指定します。（例: #pcommment(,15)）

noname,nodate,above,below,reply でコメントの表示方法、入力方法を指定します。

  • noname − 名前の入力欄を表示しません。
  • nodate − 日付を挿入しません。
  • above − 挿入したコメントをフォームの上に表示します。コメントは上が古く、下に向かって新しい順に並びます。
  • below − 挿入したコメントをフォームの下に表示します。コメントは下が古く、上に向かって新しい順に並びます。
  • reply − コメントの頭にラジオボタンを表示します。あるコメントに対するリプライが、そのコメントのラジオボタンをチェックすることで可能になります。
プラグイン内設定

  • PCMT_PAGE　ページ名のデフォルト(%sに$vars['page']が入る)
  • PCMT_NUM_COMMENTS　表示するコメント数のデフォルト
  • PCMT_COLS_NAME　名前欄の表示桁数
  • PCMT_COLS_COMMENT　コメント欄の表示桁数
  • PCMT_INSERT_INS　入力内容を先頭/末尾のどちらに挿入するか
  • PCMT_NAME_FORMAT　名前欄の挿入フォーマット
  • PCMT_MSG_FORMAT　コメント欄の挿入フォーマット
  • PCMT_NOW_FORMAT　時刻欄の挿入フォーマット
  • PCMT_FORMAT　コメント内容全体の挿入フォーマット
  • PCMT_AUTO_LOG　自動過去ログ化を行う際の1ページあたりの件数(0で無効)
  • PCMT_TIMESTAMP　コメントページのタイムスタンプを更新せず、設置ページのタイムスタンプを更新するか
備考

更新が衝突したときは、予期せぬ場所にコメントが挿入されるのを防ぐため、リプライ先を指定して記入したコメントはaboveまたはbelowの設定にしたがって 一番前か一番後ろに追加されます。

コメント記入後に表示されるページのタイトルに「(#pcommentを書いたページ)を更新しました」と表示されますが、実際に更新されたのはコメントを記録するページです。

コメントを投稿しても、#pcommentが書かれたページは更新されないので、最終更新ページにはコメントを記録したページだけが更新として表示されます。

コメントとして相対参照([ [../] ]など)を用いた場合は、書いたページと書き込まれたページのどちらかで、意図したとおりに変換されない可能性があります。

自動過去ログ化機能はPCMT_AUTO_LOGの件数＋PCMT_NUM_COMMENTSの件数分のコメント投稿時に作動します。

popular Edit

種別

ブロック型プラグイン

重要度

★★☆☆☆

書式
#popular( [[件数] [,[対象外ページ] [,true|false] ]] )
概要

人気のある（参照回数の多い）ページの上位数件を表示します。

引数

件数には一覧の数を指定して下さい。省略時は10件です。

対象外ページには、表示対象外とするページを正規表現で指定します。例えば FrontPage や MenuBar などのページを一覧に表示させたくないときに使用します。

true, falseで、ページのカウント条件を指定します。省略時は false です。

  • true − 今日参照のあった回数順でページを表示します。
  • false − 通算の参照回数順でページを表示します。
備考

counter?プラグインのカウンター情報を利用しているので、counterプラグインを設置していないページはカウントの対象外となります。全てのページにcounterプラグインを設置するのは非効率であるため counterプラグインをMenubarやスキンに設置するのが一般的です。

paint Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#paint( [幅] [,高さ] )
概要

Javaアプレットで描いた絵を、そのページに添付します。

ば科学的愛情で配布されているBBSPainter.jarを使用しています。

幅と高さに、デフォルトのキャンバスサイズを指定します。省略時は(80,60)となります（変更可能）

プラグイン内設定

  • PAINT_INSERT_INS − 入力内容を先頭/末尾のどちらに挿入するか
  • PAINT_DEFAULT_WIDTH − デフォルトの描画領域の幅
  • PAINT_DEFAULT_HEIGHT − デフォルトの描画領域の高さ
  • PAINT_MAX_WIDTH − 描画領域の幅の上限
  • PAINT_MAX_HEIGHT − 描画領域の高さの上限
  • PAINT_APPLET_WIDTH − アプレット領域の幅
  • PAINT_APPLET_HEIGHT − アプレット領域の高さ
  • PAINT_NAME_FORMAT −名前欄の挿入フォーマット
  • PAINT_MSG_FORMAT − コメント欄の挿入フォーマット
  • PAINT_NOW_FORMAT − 時刻欄の挿入フォーマット
  • PAINT_FORMAT − コメント内容全体の挿入フォーマット（メッセージあり）
  • PAINT_FORMAT_NOMSG − コメント内容全体の挿入フォーマット（メッセージなし）
備考

PukiWikiのインストールディレクトリに上記BBSPainter.jarを入れるのを忘れないでください。このプラグインが何の役にも立たなくなります。

pcomment Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★★★☆☆

書式
#pcomment({ [コメント記録ページ], [表示件数], [noname], [nodate], [above], [below], [reply] })
概要

別ページにコメントを記録して、pcommentを設置した場所に最新の数件だけを表示します。枝にコメントを付けることもできます。

引数

コメント記録ページにはコメントを記録するページ名を指定します。省略すると、pcommentプラグイン内のPCMT_PAGEで指定されたページにコメントが記録されます。デフォルトは[コメント/(設置したページ名)]です。指定したページが存在しなくても、最初のコメント記録時に作成されます。

表示件数は表示するコメントの数を指定します。第1レベルの番号なしリストだけをカウントします。省略すると、pcommentのデフォルト件数(通常10件。PCMT_NUM_COMMENTSで変更可能)が表示されます。
表示件数はコメント記録ページより後に指定して下さい。コメント記録ページを省略して表示件数を指定する場合は、コメント記録ページに空白を指定します。（例: #pcommment(,15)）

noname,nodate,above,below,reply でコメントの表示方法、入力方法を指定します。

  • noname − 名前の入力欄を表示しません。
  • nodate − 日付を挿入しません。
  • above − 挿入したコメントをフォームの上に表示します。コメントは上が古く、下に向かって新しい順に並びます。
  • below − 挿入したコメントをフォームの下に表示します。コメントは下が古く、上に向かって新しい順に並びます。
  • reply − コメントの頭にラジオボタンを表示します。あるコメントに対するリプライが、そのコメントのラジオボタンをチェックすることで可能になります。
プラグイン内設定

  • PCMT_PAGE　ページ名のデフォルト(%sに$vars['page']が入る)
  • PCMT_NUM_COMMENTS　表示するコメント数のデフォルト
  • PCMT_COLS_NAME　名前欄の表示桁数
  • PCMT_COLS_COMMENT　コメント欄の表示桁数
  • PCMT_INSERT_INS　入力内容を先頭/末尾のどちらに挿入するか
  • PCMT_NAME_FORMAT　名前欄の挿入フォーマット
  • PCMT_MSG_FORMAT　コメント欄の挿入フォーマット
  • PCMT_NOW_FORMAT　時刻欄の挿入フォーマット
  • PCMT_FORMAT　コメント内容全体の挿入フォーマット
  • PCMT_AUTO_LOG　自動過去ログ化を行う際の1ページあたりの件数(0で無効)
  • PCMT_TIMESTAMP　コメントページのタイムスタンプを更新せず、設置ページのタイムスタンプを更新するか
備考

更新が衝突したときは、予期せぬ場所にコメントが挿入されるのを防ぐため、リプライ先を指定して記入したコメントはaboveまたはbelowの設定にしたがって 一番前か一番後ろに追加されます。

コメント記入後に表示されるページのタイトルに「(#pcommentを書いたページ)を更新しました」と表示されますが、実際に更新されたのはコメントを記録するページです。

コメントを投稿しても、#pcommentが書かれたページは更新されないので、最終更新ページにはコメントを記録したページだけが更新として表示されます。

コメントとして相対参照([ [../] ]など)を用いた場合は、書いたページと書き込まれたページのどちらかで、意図したとおりに変換されない可能性があります。

自動過去ログ化機能はPCMT_AUTO_LOGの件数＋PCMT_NUM_COMMENTSの件数分のコメント投稿時に作動します。

popular Edit

種別

ブロック型プラグイン

重要度

★★☆☆☆

書式
#popular( [[件数] [,[対象外ページ] [,true|false] ]] )
概要

人気のある（参照回数の多い）ページの上位数件を表示します。

引数

件数には一覧の数を指定して下さい。省略時は10件です。

対象外ページには、表示対象外とするページを正規表現で指定します。例えば FrontPage や MenuBar などのページを一覧に表示させたくないときに使用します。

true, falseで、ページのカウント条件を指定します。省略時は false です。

  • true − 今日参照のあった回数順でページを表示します。
  • false − 通算の参照回数順でページを表示します。
備考

counter?プラグインのカウンター情報を利用しているので、counterプラグインを設置していないページはカウントの対象外となります。全てのページにcounterプラグインを設置するのは非効率であるため counterプラグインをMenubarやスキンに設置するのが一般的です。

random Edit

種別

（コマンド）

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#random( [メッセージ] )
概要

ランダムなページへのリンクを表示するプラグイン。

表示するページの候補は設置したページの下階層のページです。

引数

メッセージにはリンクに表示する文字列を指定します。省略時は 'press here.' となります。

備考

ブラウザの再読み込み対策はしていません。リロードされるたびにランダムな表示を繰り返します。

read Edit

種別

コマンド

重要度

★★★★★

書式
?cmd=read &page=ページ名
概要

指定したページを表示します。該当ページが存在しない場合は編集状態で開き、ページ名がInterWikiであった場合は、その解決を行います。

plugin=やcmd=が指定されていない場合に内部で暗黙に呼び出されるため、利用者が意識する機会は少ないです。

引数

ページ名には表示したいページ名を指定します。ページ名はエンコードされている必要があります。

recent Edit

種別

ブロック型プラグイン

重要度

★★★★★

書式
#recent( [件数] )
概要

最近更新されたページのうち、最新の数件を表示します。

引数

件数には表示件数を指定します。省略時は10件です。

ref Edit

種別

ブロック型プラグイン

インライン型プラグイン

重要度

★★★★☆

書式

#ref( 添付ファイル名| ページ名/添付ファイル名| URL [,ページ名] {, [left|center|right], [wrap|nowrap], [around], [noicon], [noimg], [nolink], [zoom], [999x999], [999%] } [,タイトル] )

&ref( 添付ファイル名| ページ名/添付ファイル名| URL [,ページ名] {, [noicon], [noimg], [nolink], [zoom], [999x999], [999%] } [,タイトル] );

概要

'#attach'でページに添付されたファイルを指定位置に展開します。添付ファイルが画像の場合は画像を表示し、それ以外の場合はダウンロード用のリンクを表示します。

引数

添付ファイル名にはページに添付したファイル名を指定します（省略時はエラーとなります）。別ページ名/添付ファイル名とする事で別ページの添付ファイルも指定できます。

ページ名にはファイルを添付したページをWikiNameかBracketNameで指定します。このオプションは最初(添付ファイル名の次)に記述してください。省略時は設置したページです。

パラメータにはファイルの展開方法を指定できます。

  • left|center|right − 表示時の位置を指定します。省略時はleft(変更可)です。
  • wrap|nowrap − テーブルタグで囲む/囲まないの指定を行います。省略時はnowrap(変更可)です。
  • around − テキストの回り込みを可能とします。省略時は回り込みを行いません。
  • noicon − ファイルが画像以外の場合に表示されるアイコンを表示しません。省略時は表示します。
  • noimg − ファイルが画像の場合に画像を展開しないようにします。省略時は展開します。
  • nolink − 元ファイルへのリンクを張らないようにします。省略時はリンクします。
  • zoom − 縦横比を保持します。省略時はサイズ指定に従います。
  • 999x999 − サイズを指定します(幅x高さ)。省略時は拡大率あるいは対象画像のサイズに従います。
  • 999% − サイズを指定(拡大率)します。省略時は100%です、
  • タイトル − 上記以外のパラメータは画像の代替文字列、リンクのタイトル属性として使用されます。ページ名やパラメータに見える文字列を使用するときは、#ref(hoge.png,,zoom)のようにタイトルの前にカンマを余分に入れます。
プラグイン内設定

  • PLUGIN_REF_USAGE　引数未指定時に表示されるヘルプ
  • PLUGIN_REF_IMAGE　マッチ時に指定ファイルを画像とみなす正規表現
  • FILE_ICON　アイコンイメージのファイル
  • REF_DEFAULT_ALIGN　left,center,right省略時の表示位置
  • REF_WRAP_TABLE　wrap,nowrap省略時にテーブルタグで囲むか
  • REF_URL_GETIMAGESIZE　URL指定時に画像サイズを取得するか
備考

aroundで行った回り込み指定を解除するには clearプラグイン、あるいはimgプラグインを使用して下さい。

"ほげ"という別ページの添付ファイル"fuga.jpg"をインラインプラグイン形式で参照する場合、下記２通りの記述方法が存在します。

(1) &ref(ほげ/fuga.jpg);
(2) &ref(fuga.jpg,[[ほげ]]);

上記２通りの記述のうち、(2)の記述方式は旧バージョンと互換性を維持するために用意されたもので、推奨される記述方式は(1)です。
いずれの記述方法であっても一般的な動作は同じですが、いわゆるバナー画像のように表示した画像が別ページへのリンクとなるよう以下の指定をした場合、

(1)  [[&ref(ほげ/fuga.jpg,nolink,ウェブ名);>ウェブのURL]] 
(2)  [[&ref(fuga.jpg,[[ほげ]],nolink,ウェブ名);>ウェブのURL]]
(1)の記述方法は期待通りの動作をしますが、(2)の記述方法ではうまくリンクされません。

referer Edit

種別

コマンド

重要度

★★★☆☆

書式
?plugin=referer [&page=ページ名] [&sort= 0d|0a| 1d|1a| 2d|2a| 3 ]
概要

ページを照会した利用者の参照元URL(Referer)の一覧を表示します。

引数

ページ名にはRefererを表示するページ名を指定します。ページ名はエンコードされている必要があります。省略時はRefererが記録されているページの一覧を表示します。

sortでReferer一覧のソート順を指定します。

  • 0d − 最終更新日時(新着順)
  • 0a − 最終更新日時(日付順)
  • 1d − 初回登録日時(新着順)
  • 1a − 初回登録日時(日付順)
  • 2d − カウンタ(大きい順)
  • 2a − カウンタ(小さい順)
  • 3 − Referer
プラグイン内設定

  • CONFIG_REFERER　無視するURIを指定したページ
備考

pukiwiki.ini.php で、Refererを使用する設定($referer = 1を指定)が行われている必要があります。

related Edit

種別

擬似ブロック型プラグイン

重要度

★★★☆☆

書式

#related

概要

設置したページを参照しているページの一覧を表示します。

rename Edit

種別

コマンド

重要度

★★★☆☆

書式
?plugin=rename [&refer=ページ名]
概要

既存ページの名前を変更します。実行には管理者権限が必要です。

ページの本文のほか、指定されたページ名の差分、バックアップ、添付ファイル、カウンターを一気にリネームします。

引数

ページ名には変更するページの名前を指定します。省略時はページ名の選択または正規表現置換用文字列入力画面が表示されます。

実行結果は変換結果のページ（RENAME_LOGPAGE で指定。標準はRenameLog）に追記されます。

プラグイン内設定

  • RENAME_LOGPAGE　ページ名の変換結果を出力するページ名
備考

ページ内のリンクの書き換えは行ないません。yetlistなどを駆使して対処してください。

TrackBackやRefererの情報は更新されません。

リネーム対象のページが凍結されているかどうかはチェックしていません。

関連ページにリネーム対象の文字列が複数含まれているとおかしくなります。

  • たとえば、hogeおよびhoge/hogeという二つのページがあったときに、hogeページをfugaに(関連ページを含んで)リネームすると、hoge/hogeページの名前がfuga/fugaになってしまいます。

search Edit

種別

コマンド

重要度

★★★★★

書式
?cmd=search{ [&word=検索文字列] [&type=OR] }
概要

指定した文字列を含むページの検索を行います。

引数

パラメータには検索条件を指定します。

  • word − 検索する文字列を指定します。省略時は検索条件を入力するページを表示します。
  • type − 'OR' 指定時、OR検索を行います。省略時はAND検索をおこないます。

server Edit

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#server
概要

サーバーの情報(サーバー名、サーバーソフトウエア、サーバー管理者)を表示します。

setlinebreak Edit

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#setlinebreak( [on|off|default] )
概要

入力文章中の改行を改行とみなすかどうかの設定を行います。

PukiWikiが入力文章中の改行をどのように扱うかはpukiwiki.ini内の$line_breakの設定内容によって変わります（下記参照）。

入力文章$line_break=0;$line_break=1;
文章１
文章２		文章１文章２文章１
文章２

setlinebreakプラグインは該当ページの以降の行に関して、 $line_breakの設定に因らず改行をどのように扱うかを指定できるようになります。

引数

パラメータには以降の改行の扱いを指定します。 パラメータが省略された場合、改行とみなすかどうかについての設定を逆転させます。

  • on − 以降の文章で段落内の改行を改行とみなします($line_break=1と同様)。
  • off − 以降の文章で改行を無視します($line_break=0と同様)。 改行を行うためには行末にチルダを記述するか、 行中でbrプラグイン?を使用する必要があります。
  • default − 改行の扱いをそのサイトの$line_break設定に戻します。

showrss Edit

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#showrss( RSSへのパス [,[default|menubar|recent] [,[キャッシュ生存時間] [,1 ]]] )
概要

指定されたRSSを取得し、一覧表示します。

ページの解釈毎にRSSの取得を行う為、頻繁に参照されるページでshowrssを使用される場合はキャッシュ機能を使うことをお勧めします。相手サイトの更新頻度に応じてキャッシュの生存時間を適宜設定して下さい。

引数

RSSへのパスにはRSSへのファイルパスやURLを指定します。

テンプレート名には取得したRSSの表示方法を指定します。省略時はdefault となります。

  • default − 単純にページを列挙します。
  • menubar − ページ名の前に黒丸をつけます。MenuBarなど、横幅に制限にある場合に便利です。
  • recent − recentプラグインの出力のように、ページ名の前に黒丸をつけて更新日付が変わる毎に更新日付を出力します。

キャッシュ生存時間はキャッシュをクリアする期限（１時間単位）です。省略時、キャッシュ機能は無効となります。

第４引数はRSSを取得した日付を表示するかどうかを指定します。1を指定した場合は表示します。省略時は表示しません。

プラグイン内設定

  • SHOWRSS_VALUE_UNESCAPE　RSS中の "&lt; &gt; &amp;" などを 一旦 "< > &" に戻すか？
  • SHOWRSS_VALUE_ESCAPE　SHOWRSS_VALUE_UNESCAPEの変換後"< > &"などを"&lt; &gt; &amp;"にするか？
備考

動作させるためにはPHP の xml extension が必要です。

size Edit

種別

インライン型プラグイン

重要度

★★★☆☆

書式
&size( ピクセル数値 ){ 文字列 }
概要

文字の大きさを指定します。

引数

ピクセル数値には文字の大きさを指定します。

文字列は文字の大きさを変更する文字列を指定します。

source Edit

種別

コマンド

重要度

★☆☆☆☆

書式
?cmd=source &page=ページ名
概要

指定したページの整形前のソースを表示します。

引数

ページ名にはソースを表示するページ名を指定します。ページ名はエンコードされている必要があります。

template Edit

種別

コマンド

重要度

★★★★☆

書式
?plugin=template &refer=テンプレートページ
概要

既存のページをテンプレートとしてページを新規作成します。

ページの新規作成時の雛形とするページの読込み機能との差異は、テンプレートプラグインが雛形とする範囲(行単位)に選択できるのに対して、ページの新規作成で読み込むテンプレートは全文をテキストエリアにコピーする点にあります。

引数

テンプレートページには雛形とするページを指定します。ページ名はエンコードされている必要があります。

プラグイン内設定

  • MAX_LEN　雛形の開始／終了位置を指定する欄で表示される最大文字数

topicpath Edit

種別

インライン型プラグイン

ブロック型プラグイン

重要度

★☆☆☆☆

書式

&topicpath ;

#topicpath

概要

パンくずリスト(topicpath)と呼ばれる、ページの階層表現のユーザーインターフェースを提供するプラグイン。

パンくずリスト（Topic path）は現在参照しているウェブページの階層を表現するユーザーインターフェースです。例えばPukiWiki/ツアー?というページに#topicpathと書くと、以下の様な表記に置き換わります。

パンくずリスト（Topic path）は現在参照しているウェブページの階層を表現するユーザーインターフェースです。例えば「PukiWiki/ツアー」というページに#topicpathと書くと、以下の様な表記に置き換わります。

[[Top>FrontPage]]/[[PukiWiki>PukiWiki]]/[[ツアー>PukiWiki/ツアー]]

基本的には以下の２通りの使い方を想定しています。

  1. 「ほげ/ふが/げほ」など、２〜３階層以上の深いページでページの行き来をしやすくするために表示する
  2. skin/pukiwiki.skin.ja.php に組み込み、ページタイトル下のURLの代わりに表示する

    スキンに組み込む例（pukiwiki.skin.ja.php の30行目あたり）

    <?php if ($is_page) { ?>
<span class="small"><?php require_once(PLUGIN_DIR.'topicpath.inc.php'); echo plugin_topicpath_convert(); ?></span>
<?php } ?>
プラグイン内設定

  • PLUGIN_TOPICPATH_TOP_DISPLAY　defaultpageを一番最初に表示するかどうか。
  • PLUGIN_TOPICPATH_TOP_LABEL　$defaultpageに対するラベル
  • PLUGIN_TOPICPATH_TOP_SEPARATOR　階層を区切るセパレータ
  • PLUGIN_TOPICPATH_THIS_PAGE_DISPLAY　現在表示中のページに対するリンクを表示するかどうか
  • PLUGIN_TOPICPATH_THIS_PAGE_LINK　現在表示中のページに対してリンクするかどうか

touchgraph Edit

種別

コマンド

重要度

★☆☆☆☆

書式
?plugin=touchgraph
概要

TouchGraphWikiBrowser用のインデックスを作ります。

unfreeze Edit

種別

コマンド

重要度

★★★☆☆

書式
?plugin=unfreeze &page=ページ名
概要
解除锁定
引数

ページ名には解除するページ名を指定します。ページ名はエンコードされている必要があります。

versionlist Edit

種別

コマンド

ブロック型プラグイン

重要度

★☆☆☆☆

書式
?plugin=versionlist #versionlist
概要

pukiwiki.phpのあるディレクトリとpluginのディレクトリ内のphpファイルのバージョンを表示します。

yetlist Edit

種別

コマンド

重要度

★★☆☆☆

書式
?plugin=yetlist
概要

まだ作られていないページを一覧表示します。

まだ作られていないページとは、既存のページでWikiNameあるいはBracketNameで指定されていて、まだ作られていないページです。

備考

自分以外の誰かがページを書くかもしれないという点は非常にWiki的ですが、実際の運用面ではcommentに記述された一見さんの名前やWikiName同様のパラメータ名など、ページ化しにくいキーワードが大量に引っかかってしまいます。
Last-modified: Wed, 25 Jun 2008 18:46:02 HADT (803d)