この Wiki で編集していただく上で、役に立つプラグインをまとめます。
(コマンド)
インライン型プラグイン
ブロック型プラグイン
★☆☆☆☆
&amazon( ASIN番号 );
#amazon
#amazon(, clear )
#amazon( ASIN番号, [left|right], [タイトル|image|delimage|deltitle|delete] )
アマゾン(http://www.amazon.co.jp)が提供する商品のイメージと、商品名を表示します。
アマゾンのアソシエイト ID(紹介文などを書くことで副収入がもらえるかもしれない仕組み)に対応しています*1。 ASIN を入力するだけで、予め作成した定型作品紹介フォーマットを自動生成することができます。
全ての引数を省略すると、ブックレビュー作成フォームが現れます。「書評」というページにこれを置くと「書評/ASIN番号」という子ページを作ります。
left,right,clear で商品のイメージとタイトルの出力方式を指定します。
著作権が関連する為、アマゾンのアソシエイトプログラムを確認の上ご利用下さい。
イメージなしの場合に使用する画像が別途必要です。デフォルトは image/noimage.jpg を使用します。
ASIN は書籍の場合 ISBN と全く同じです。書籍以外の場合は、アマゾンのサイトで対象を表示した際の写真のプロパティで判断します。例えば下のような場合だと、最後の 01 を含め、B000002G6J.01 とします。B000002G6J とすると、デフォルトの 09 が適用されてしまい、画像なしとなります(画像だけでなくタイトルも呼ぶのであれば 10 桁で Ok)。
http://images-jp.amazon.com/images/P/B000002G6J.01.LZZZZZZZ.jpg
ブロック型プラグイン
インライン型プラグイン
★★★★☆
#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で指定します。このオプションは最初(添付ファイル名の次)に記述してください。省略時は設置したページです。
パラメータにはファイルの展開方法を指定できます。
aroundで行った回り込み指定を解除するには clearプラグイン、あるいはimgプラグインを使用して下さい。
"ほげ"という別ページの添付ファイル"fuga.jpg"をインラインプラグイン形式で参照する場合、下記2通りの記述方法が存在します。
(1) &ref(ほげ/fuga.jpg); (2) &ref(fuga.jpg,[[ほげ]]);
上記2通りの記述のうち、(2)の記述方式は旧バージョンと互換性を維持するために用意されたもので、推奨される記述方式は(1)です。
いずれの記述方法であっても一般的な動作は同じですが、いわゆるバナー画像のように表示した画像が別ページへのリンクとなるよう以下の指定をした場合、
(1) [[&ref(ほげ/fuga.jpg,nolink,ウェブ名);>ウェブのURL]] (2) [[&ref(fuga.jpg,[[ほげ]],nolink,ウェブ名);>ウェブのURL]](1)の記述方法は期待通りの動作をしますが、(2)の記述方法ではうまくリンクされません。
インライン型プラグイン
★☆☆☆☆
文字列にルビをふります。
ルビには表示するルビを指定します。
対象文字列にはルビがふられる文字列を指定します。
XHTML 1.1のルビに対応したブラウザでないと、ルビとして表示されません。IE5.5/6では表示できます。Netscape 7/MozillaではXHTML Ruby Supportを組み込めば表示できます。
ルビに対応していないブラウザではルビをふる文字列の直後にルビが( )に入れられて表示されます。
ブロック型プラグイン
★☆☆☆☆
入力文章中の改行を改行とみなすかどうかの設定を行います。
PukiWikiが入力文章中の改行をどのように扱うかはpukiwiki.ini内の$line_breakの設定内容によって変わります*2(下記参照)。
入力文章 | $line_break=0; | $line_break=1; |
文章1 文章2 | 文章1文章2 | 文章1 文章2 |
setlinebreakプラグインは該当ページの以降の行に関して、 $line_breakの設定に因らず改行をどのように扱うかを指定できるようになります。
パラメータには以降の改行の扱いを指定します。 パラメータが省略された場合、改行とみなすかどうかについての設定を逆転させます。
ブロック型プラグイン
★☆☆☆☆
指定されたRSSを取得し、一覧表示します。
ページの解釈毎にRSSの取得を行う為、頻繁に参照されるページでshowrssを使用される場合はキャッシュ機能を使うことをお勧めします。相手サイトの更新頻度に応じてキャッシュの生存時間を適宜設定して下さい。
RSSへのパスにはRSSへのファイルパスやURLを指定します。
テンプレート名には取得したRSSの表示方法を指定します。省略時はdefault となります。
キャッシュ生存時間はキャッシュをクリアする期限(1時間単位)です。省略時、キャッシュ機能は無効となります。
第4引数はRSSを取得した日付を表示するかどうかを指定します。1を指定した場合は表示します。省略時は表示しません。
動作させるためにはPHP の xml extension が必要です。