S

search

種別

コマンド

ブロック型プラグイン

重要度

★★★★★

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

#search

概要

検索文字列の入力フォームを表示し、 指定した文字列を含むページの検索を行います。

引数

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

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

  • PLUGIN_SEARCH_DISABLE_GET_ACCESS GETメソッドによる検索を禁止する(DoS攻撃、SPAMbot、ワーム対策)
  • PLUGIN_SEARCH_MAX_LENGTH 検索する文字列として指定可能な最大文字数 (同)

server

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式
#server
概要

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

setlinebreak

種別

ブロック型プラグイン

重要度

★☆☆☆☆

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

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

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

入力文章$line_break=0;$line_break=1;
文章1
文章2
文章1文章2文章1
文章2

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

引数

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

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

showrss

種別

ブロック型プラグイン

重要度

★☆☆☆☆

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

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

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

引数

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

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

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

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

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

備考

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

size

種別

インライン型プラグイン

重要度

★★★☆☆

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

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

引数

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

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

プラグイン内設定

  • PLUGIN_SIZE_MAX 引数として指定可能な最大文字サイズ
  • PLUGIN_SIZE_MIN 引数として指定可能な最小文字サイズ
  • PLUGIN_SIZE_USAGE 引数未指定時に表示されるヘルプ

source

種別

コマンド

重要度

★☆☆☆☆

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

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

引数

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


T

tb

種別

コマンド

重要度

★☆☆☆☆

書式
?plugin=tb &tb_id=TrackBackID &__mode= view| rss
概要

TrackBack?の一覧を表示します。

POSTされた場合は他サイトからのTrackBack?に反応します。

引数

&tb_idには表示対象ページのTrackBackIDを指定します。

&__modeには一覧表示方法を指定します。

  • view − 人間が見やすい形式で表示します。
  • rss − RSS形式で表示します。
プラグイン内設定

  • PLUGIN_TB_LANGUAGE TrackBack?のRSSで出力する言語
備考

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

template

種別

コマンド

重要度

★★★★☆

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

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

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

引数

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

プラグイン内設定

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

topicpath

種別

インライン型プラグイン

ブロック型プラグイン

重要度

★☆☆☆☆

書式

&topicpath ;

#topicpath

概要

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

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

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

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

  1. 「ほげ/ふが/げほ」など、2〜3階層以上の深いページでページの行き来をしやすくするために表示する
  2. スキンに組み込み、ページタイトル下のURLの代わりに全てのページで表示する
プラグイン内設定

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

スキンに組み込む場合は、pukiwiki.skin.php の SKIN_DEFAULT_DISABLE_TOPICPATH に 1を指定して下さい。

touchgraph

種別

コマンド

重要度

★☆☆☆☆

書式
?plugin=touchgraph
概要

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

tracker

種別

(コマンド)

ブロック型プラグイン

重要度

★★★★☆

書式

#tracker( [定義名] [,ベースページ名] )

概要

bugtrackプラグインのように、定型的な項目をもったページを作るための入力フォームを表示します。

入力項目が固定されているbugtrackプラグインと機能は似ていますが、入力項目を簡単に変更できる点が違います。FAQ,BBS,書評,TODOリストなど使い道はアイディア次第です。

入力項目の定義は:config/plugin/tracker/ 以下に所定の書式でページを作成することで設定できます。bugtrackプラグイン互換の入力項目定義が:config/plugin/tracker/default に用意されているので参考にして下さい。

引数

定義名はtrackerのプラグイン定義名を指定します。省略時は定義名defaultが指定されたとみなします。

ベースページ名はフォームから作成されるページの親階層となるページ名を指定します。省略時は設置したページとなります。

プラグイン内設定

  • TRACKER_LIST_EXCLUDE_PATTERN tracker_listで表示しないページ名を正規表現で指定する
  • TRACKER_LIST_SHOW_ERROR_PAGE 項目の取り出しに失敗したページを一覧に表示するか

tracker_list

種別

(コマンド)

ブロック型プラグイン

重要度

★★★★☆

書式
#tracker_list( [定義名] [,[ベースページ名] [,[[ソート項目] :[ソート順]] [,表示上限] ]]] )
概要

trackerプラグインで作成したページを一覧表示します。

引数

定義名はtrackerプラグインで指定した定義名と同じものを指定します。省略時は定義名defaultが指定されたとみなします。

ベースページ名はtrackerプラグインで指定したベースページ名と同じものを指定します。trackerプラグインでベースページ名を指定していない場合はtrackerプラグインを設置したページを指定します。省略時は設置したページとなります。

第3項目には一覧表示のソートに使う項目およびソート順を指定します。ソート項目は:config/plugin/tracker/定義名のページのfield項目内の項目から選択して下さい。省略時はページ名となります。ソート順は、ASC、DESC、SORT_ASC、SORT_DESCをコロン(:)の後に指定してください。また、セミコロン(;)で区切ることにより、複数のソート項目、ソート順を指定可能です。

表示上限は一覧表示するページ数の上限を指定します。省略時は全て表示されます。


U

unfreeze

種別

コマンド

重要度

★★★☆☆

書式
?plugin=unfreeze &page=ページ名
概要

ページの凍結を解除します。

引数

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

プラグイン内設定

  • PLUGIN_UNFREEZE_EDIT 凍結解除時にページの編集フォームを表示するか

update_entities

種別

コマンド

重要度

★☆☆☆☆

書式
?plugin=update_entities
概要

CACHE_DIR/entities.dat を生成します。

entities.datはHTMLの実体参照を判定するために用いられるテーブルを格納したファイルです。普通、利用者や管理者が意識する機会はありません。

プラグイン内設定

  • W3C_XHTML_DTD_LOCATION DTDの場所
備考

配布ファイルに生成済のentities.datが付属するため、通常使用する機会はありません。