PukiWiki/1.4/Manual/Plugin/S-U - パンデイロ惑星

S
- search
- server
- setlinebreak
- showrss
- size
- source
T
- tb
- template
- topicpath
- touchgraph
- tracker
- tracker_list
U
- unfreeze
- update_entities

S

▲

search

種別: コマンド
重要度: ★★★★★
書式: ?cmd=search{
[&word=検索文字列]
[&type=OR]
}

概要

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

引数

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

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

▲

server

種別: ブロック型プラグイン
重要度: ★☆☆☆☆
書式: #server
概要: サーバーの情報(サーバー名、サーバーソフトウエア、サーバー管理者)を表示します。

▲

setlinebreak

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式

#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

種別

ブロック型プラグイン

重要度

★☆☆☆☆

書式

#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中の "< > &" などを一旦 "< > &" に戻すか？
SHOWRSS_VALUE_ESCAPE　SHOWRSS_VALUE_UNESCAPEの変換後"< > &"などを"< > &"にするか？

備考

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

▲

size

種別

インライン型プラグイン

重要度

★★★☆☆

書式

&size(
ピクセル数値
){
文字列
}

概要

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

引数

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

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

▲

source

種別: コマンド
重要度: ★☆☆☆☆
書式: ?cmd=source
&page=ページ名
概要: 指定したページの整形前のソースを表示します。
引数: ページ名にはソースを表示するページ名を指定します。ページ名はエンコードされている必要があります。

▲

T

▲

tb

種別

コマンド

重要度

★☆☆☆☆

書式

?plugin=tb
&tb_id=TrackBackID
&__mode=
view|
rss

概要

TrackBackの一覧を表示します。

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

引数

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

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

view －人間が見やすい形式で表示します。
rss － 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/ツアー]]

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

「ほげ/ふが/げほ」など、２～３階層以上の深いページでページの行き来をしやすくするために表示する
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

種別: コマンド
重要度: ★☆☆☆☆
書式: ?plugin=touchgraph
概要: TouchGraphWikiBrowser用のインデックスを作ります。

▲

tracker

種別

（コマンド）

ブロック型プラグイン

重要度

★★★★☆

書式

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

概要

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

入力項目が固定されているbugtrackプラグインと機能は似ていますが、入力項目を簡単に変更できる点が違います。ＦＡＱ，ＢＢＳ，書評，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(
[定義名]
[,[ベースページ名]
[,[ソート項目]
[,[ascending]
[,表示上限]
]]]
)

概要

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

引数

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

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

ソート項目は一覧表示のソートに使う項目を指定します。:config/plugin/tracker/定義名のページのfield項目内の項目から選択して下さい。省略時はページ名となります。

第４項目にはソート順を指定します。ascendingを指定すると昇順、それ以外は降順です。省略時は降順となります。

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

▲

U

▲

unfreeze

種別

コマンド

重要度

★★★☆☆

書式

?plugin=unfreeze
&page=ページ名

概要

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

引数

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

プラグイン内設定

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

備考

▲

update_entities

種別

コマンド

重要度

★☆☆☆☆

書式

?plugin=update_entities

概要

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

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

プラグイン内設定

W3C_XHTML_DTD_LOCATION　DTDの場所

備考

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