#nofollow
#navi(contents-page-name): No such page: PukiWiki/1.4/Manual/Plugin
- ---------------------------
L
lastmod
calendar、calendar_edit、calendar_read
- 種別
-
インライン型プラグイン
ブロック型プラグイン
- 重要度
★☆☆☆☆
- 書式
-
&lastmod(
[ページ名]
);
#calendar(
[{[ページ名],
[年月]}]
)
#calendar_edit(
[{[ページ名],
[年月]}]
)
#calendar_read(
[{[ページ名],
[年月]}]
)
- 概要
-
指定したページの最終更新日時を表示します。
指定した位置にカレンダーを設置します。カレンダー上でyyyy/mm/ddという日付を選択すると、ページ名/yyyymmddというページを編集/表示できます。
カレンダーの日付を選択した場合に該当するページを編集状態、表示状態のどちらで開くかが3つのプラグインの違いです。calendar_editとは編集状態で、calendar, calendar_readは表示状態で開きます。
- 引数
-
ページ名には最終更新日時を表示したいページ名を指定します。
省略時は設置したページとみなします。
links
- 種別
コマンド
重要度
★★☆☆☆(管理者)
書式
?plugin=links
概要
ページ間のキャッシュを更新します。通常使用する必要はありません。
メンテナンス作業などでページが記録されているファイルを直接操作した場合にキャッシュとページの記述内容の整合性がとれなくなるため、実行する必要があります。
ページ名はWikiNameまたはBracketNameで指定します。
ページ名を省略すると設置したページのページ名になります。
年月は表示するカレンダーの西暦と月をyyyymmの形式で指定します。省略した場合は現在の年月になります。
備考
実行の際に管理者パスワードを要求されます。
より高機能なcalendar2プラグインがあるため、あえてcalendarプラグインを使う必要性はほとんどなくなりました。
calendar_editプラグイン及びcalendar_readプラグインの中からcalendarプラグインを呼び出しているため、calendarプラグインがないと機能しません。
list
calendar_viewer
- 種別
-
コマンド
- 重要度
-
★★★★☆
- 書式
-
?cmd=list
- 概要
-
ページの一覧を表示します。
lookup
- 種別
(コマンド)
ブロック型プラグイン
重要度
★★★☆☆
書式
#lookup(
interwikiname
[,ボタン名
[,入力欄の初期値]]
#calendar_viewer(
ページ名,
yyyy-mm|
n|
x*y|
this
[,[past|future|view]
[,年月日表示の区切り文字]]
)
概要
記述した位置にテキスト入力欄とボタンを表示します。任意の文字列を入力してボタンを押すと、interwikinameと入力値から生成したURLへ移動します。これによって、検索エンジンにクエリを送信したり、番号をタイプするだけで該当するアーカイブにアクセスすることなどが可能になります。
URLの生成にはInterWikiを利用します。このプラグインが生成するURLは、以下のようなInterWikiと同じです。InterWikiNameのページに、あらかじめURLの生成に使用するInterWikiNameを設定しておく必要があります。
[[interwikiname:入力欄の値]]
入力欄が空欄(空文字列)のときは、ボタンを押しても動作しません。必ず何らかの文字列を入力する必要があります。
calendarプラグインまたはcalendar2プラグインで作成されたページを指定した位置に表示します。
- 引数
-
interwikiname: InterWikiNameに設定した値の一つを指定します。
ボタン名: ボタンに表示するキャプションを指定します。省略時は'lookup'です。
入力欄の初期値: 初期値を指定したい場合に記入します。省略時は空文字列になります。
- プラグイン内設定
- PLUGIN_LOOKUP_USAGE 引数未指定時に表示されるヘルプ
ls
- 種別
ブロック型プラグイン
重要度
★★☆☆☆
書式
#ls(
[title]
)
概要
記述したページより階層化されているページのページ名を一覧表示します。
引数
titleを指定した場合、ページ名に加えてタイトルを表示します。タイトルは各ページの一行目の内容を表示します。省略時はタイトルを表示しません。
ページ名はcalendarプラグインまたはcalendar2プラグインを設置しているページの名前を指定します。ページ名はWikiNameまたはBracketNameで指定します。
yyyy-mmを指定時、指定した年月のページを表示します。
数字を指定時、指定した件数分のページを表示します。
x*yを指定時、先頭より数えて x ページ目(先頭は0)から、y件づつ一覧表示します。x と yはいずれも数値です。
thisを指定時、今月のページを一覧表示します。
past、future、viewで表示するページの条件を指定します。省略/無指定時はpastとなります。
- past − 今日以前のページを表示します。
- future − 今日以降のページを表示します。
- view − 過去から未来へ一覧表示します。
年月日の区切り文字は-や/などを指定します。省略した場合は-になります。
備考
実際には、より高機能なls2を使用する機会が多いと思われます。
calendar2プラグインでは今日の日付の記事がない場合、記事を表示しないため、午前0時になったとたんに記事が表示されなくなるという弱点がありました。calendar_viewerはその弱点を補うために開発されたプラグインです。calendar_viewは、日付が変わっても最新の記事を表示することができます。カレンダーそのものの表示はcalendar2(off)で行ないます。
ls2
calendar2
- 種別
(コマンド)
ブロック型プラグイン
- 重要度
★★★☆☆
- 書式
-
#ls2(
[[パターン]
[,
{
[title],
[include],
[reverse],
[compact],
[link]
}
[,linkの別名表示]
]]
#calendar2(
[{[ページ名|*],
[yyyymm],
[off]}]
)
- 概要
-
指定したパターンで始まるページ名を一覧表示します。
指定した位置にカレンダーを設置します。表示月のとなりに表示されたリンク(<< および >>)を選択することで先月/次月分のカレンダーを表示できます。カレンダー上でyyyy/mm/ddという日付を選択すると、ページ名/yyyy-mm-ddというページを表示できます。当日分のページが作成されていた場合、カレンダーの右隣に当日分のページ内容を表示します。
- 引数
-
パターンには表示するページ名の共通部分を指定します。省略時は"設置したページ名/"となります。
title,include,reverse,compact,link で表示方法を指定します。
- title − ページに含まれる見出し(*,**,***)の一覧を併記します。
- include − 下位層のページが#includeを使用していた場合、includeしているページの一覧を表示します。
- reverse − ページの並び順を反転し、名前の降順に表示します。省略すると名前の昇順に表示されます。
- compact − 見出しレベルを調整します。
- link − #ls2を書いた位置に一覧を表示する代わりにリンクを表示します。このリンクを選択すると別画面にページの一覧を表示するようにします。
linkの別名表示には、パラメータlinkを指定した際に表示される文字列の代わりの文字列を指定します。省略時は '...'で始まるページの一覧となります。
- プラグイン内設定
- PLUGIN_LS2_ANCHOR_PREFIX 見出しアンカーの書式
- PLUGIN_LS2_ANCHOR_ORIGIN 見出しアンカーの開始番号
- PLUGIN_LS2_LIST_COMPACT compactオプション省略時、見出しレベルを調整するか
ページ名で表示するページの上位階層のページを指定できます。ページ名を省略すると設置したページのページとなります。ページ名に*を指定すると上位階層のページはなし(表示するページ名がyyyy-mm-dd)となります。
yyyymmで表示するカレンダーの西暦と月を指定できます。省略時は当日の年月となります。
offを指定時、当日分ページを表示する機能は抑制されます。省略時は当日分のページを表示します。
- 備考
-
ls プラグインとの違いについて。
- 階層化されたページの起点となるページが、lsでは記述したページ固定だが、ls2ではパラメータで指定できます。
- titleパラメータを指定した場合に、lsでは「ページの一行目」が表示されるが、ls2では「見出しの一覧」を表示します。
- include, link という表示オプションが追加されています。
ページ名のソートにはnatcasesort()を使っているため、昇順の場合、半角英数字よりも漢字の方が先に表示されます。
calender_editで作成したページはページ名/yyyymmddとなり、calender2で作成したページはページ名/yyyy-mm-ddとなるため、注意が必要です。
- ---------------------------
M
map
clear
- 種別
-
コマンド
- 重要度
-
★☆☆☆☆
- 書式
-
?plugin=map
[&refer=ページ名]
[&reverse=true]
- 概要
サイトマップの様にページ間のリンク関係を一覧表示します。
指定したページを起点に、リンクで辿れるページを全てツリー状に表示します。
引数
引数には一覧表示方法のオプションを指定します。
- &refer=ページ名 − 起点となるページを指定します。省略すると、サイトのトップページ(通常はFrontPage)が起点となります。
- &reverse=true − どこへリンクしているかではなく、どこからリンクされているかを一覧表示します。 どこからもリンクされていないページは、画面の後半にまとめて表示されます。
プラグイン内設定
- PLUGIN_MAP_SHOW_HIDDEN 表示対象外のページをリストアップするかどうか
md5
- 種別
コマンド
重要度
★☆☆☆☆
書式
?plugin=md5
&md5=文字列
概要
選択したパスワードの形式に応じて、pukiwiki.ini.php に保存する
パスワード用文字列を出力します。
パスワードのフォーマットは以下の8種類の中から選択できます。
DESあるいはMD5アルゴリズムを利用したPHP crypt() および LDAP crypt *1、
MD5 アルゴリズムを利用したPHP md5()、LDAP MD5、およびLDAP SMD5(シードあり)、
SHA-1 アルゴリズムを利用したPHP sha()、LDAP SHA、および LDAP SSHA(シードあり)
- 備考
PukiWiki内で利用するパスワードは、パスワード文字列そのものの代わりに、
実際のパスワードから導出された文字列(セキュリティハッシュ)を保存することが可能です。
これは悪意ある者にpukiwiki.ini.phpの中身を覗き見られた場合に、
パスワードが安易に漏洩しない事を目的としたものです。
SHA-1 アルゴリズムを利用するためには、PHP 4.3.0 以降を使用するか mhash エクステンションを導入する必要があります。
プラグイン名に反してMD5以外のパスワードフォーマットも選択可能です。
これは従来、パスワードから導出したMD5ハッシュ値を利用していた経緯によるものです。
md5のプラグインを呼び出すURLの中にパスワードを含める利用方法は互換性のため残っていますが、推奨されません。
このプラグインは PKWK_SAFE_MODE ないし PKWK_READONLY の設定で無効化されます。
memo
- 種別
(コマンド)
ブロック型プラグイン
重要度
★☆☆☆☆
書式
#memo
#clear
概要
記述した位置に複数行入力欄とボタンを表示します。
ボタンを押下すると入力欄の記述内容を更新します。
プラグイン内設定
- MEMO_COLS 編集欄の表示桁数
- MEMO_ROWS 編集欄の表示行数
refプラグインのaroundオプションで有効となったテキスト回り込み指定を解除します。
備考
insertプラグインやarticleプラグインと似ていますが、入力した内容が入力欄の外へ出力されず、入力欄に留まる点が異なります。
個人用のメモ代わりにPukiWikiを利用している場合、未整理の情報を一時的に溜め込むのに便利です。
imgプラグインのclearオプション指定時と処理内容は同等です。
menu
color
- 種別
-
ブロック型プラグイン
インライン型プラグイン
- 重要度
★★★★☆
- 書式
-
#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 を変更して下さい。
- ---------------------------
N
navi
- 種別
ブロック型プラグイン
重要度
★★☆☆☆
書式
#navi(
[目次ページ]
)
概要
DocBook風ナビゲーションバーを表示します。
目次となるページに下階層のページが存在する時、それら全てのページ(の先頭と末尾)に記述する事で Prev, Home, Next というリンクを表示します。これによって下階層のページを順に参照するのに便利になります。
引数
目次ページに順番に見て回るページの上階層にあたるページを指定します。
例えば hoge, hoge/1, hoge/2, hoge/3 というページが存在する場合、hoge/2に#navi(hoge)を記述するとhogeに移動するHomeというリンク、hoge/1に移動するPrevというリンク、hoge/3に移動するNextというリンクを表示します。
ページで最初に呼び出した場合はヘッダイメージのリンクを出力します。ページで2度目以降に呼び出された場合はフッタイメージのリンクを出力します。現在のページが目次ページである場合は対象となるページの一覧を表示します。
プラグイン内設定
- PLUGIN_NAVI_EXCLUSIVE_REGEX 除外するページを正規表現で指定する
- PLUGIN_NAVI_LINK_TAGS <link>タグを出力するかどうか
new
- 種別
インライン型プラグイン
重要度
★★☆☆☆
書式
書式1:
&new(
[nodate]
&color(
文字色
[,背景色]
){
日付文字列
文章
};
書式2:
&new(
[ページ名]
[,nolink]
);
概要
指定した日時が最近であった場合、最近更新された事を強調表示します。日時の指定は直接日付時刻を記述する方法(書式1)と、指定したページ(群)の最終更新日時を採用する方法(書式2)の2通りがあります。
標準では5日以内の場合に New を、1日以内の場合に New! を表示します。期間や表示する文字列のパターンは設置者によってカスタマイズ可能です。
引数で指定したインライン要素(主に文章)の、文字色・背景色を指定します。
引数
書式1:
日付文字列を指定した場合、その日時が規定の期間内であった場合に強調表示します。省略した場合はページの更新日時をチェックする記述であると見なされます。
- nodate − 日付文字列を表示しません。省略時は表示します。
書式2:
ページ名を指定した場合は、そのページの更新日時が規定の期間内であった場合に強調表示します。省略した場合は、プラグインを記述したそのページを指定したと見なします。
ページ名末尾が/であった場合、そのページ名で始まるページ群の中で最後の更新日時が規定の日付以内であった場合に強調表示します。
- nolink − ページ名を表示しません。省略時はページ名(ページ群で指定した場合は最後に更新されたページ名)を表示します。
プラグイン内設定
- PLUGIN_NEW_DATE_FORMAT 表示フォーマット
文字色には文章の文字色を6桁の16進数値(rrggbb)か、色名で指定します。
背景色には文章の背景色を6桁の16進数値(rrggbb)か、色名で指定します。
備考
日付文字列はPHP関数:strtotimeが認識できる書式である必要があります。
以下、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"
newpage
comment
- 種別
-
コマンド
(コマンド)
ブロック型プラグイン
- 重要度
★★★★★
- 書式
-
?plugin=newpage
&page=ページ名
&refer=関連ページ名
#newpage(
[ページ名初期値]
#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 コメントが投稿された場合、内容を送るメールアドレス
nofollow
contents
- 種別
-
ブロック型プラグイン
擬似ブロック型プラグイン
- 重要度
-
★☆☆☆☆
★★★☆☆
- 書式
-
#nofollow
#contents
- 概要
-
記述したページが凍結されている場合、ヘッダーに「NOFOLLOW」「NOINDEX」オプションを追加させます。
これらのオプションは検索エンジンに対し「このページを無視して欲しい」と主張します。実際にどうなるのかは検索エンジン次第です。
- 備考
-
人間や、上記のオプションを無視するプログラムには効果がありません。
設置したページ中の見出しの一覧を表示します。
norelated
counter
- 種別
ブロック型プラグイン
インライン型プラグイン
- 重要度
★★★☆☆
- 書式
-
#norelated
#counter
&counter(
[total|
yesterday|
total]
);
- 概要
-
ページ下部に表示される関連ページのリンクを非表示にします。
設置したページの参照回数を表示します。
- 引数
-
カウンタ表示方法として today,yesterday,total いずれかを指定します。省略時やその他の文字列を指定した場合はtotalが指定されたとみなします。ブロック型プラグインでは常にtotalが指定されたとみなします。
- total − そのページが参照された回数の総計を表示します。
- today − そのページが参照された回数(当日分)を表示します。
- yesterday − そのページが参照された回数(昨日分)を表示します。
- プラグイン内設定
- COUNTER_EXT ページ参照回数を保持するデータファイルの拡張子
- 備考
-
極端に多くのページからリンクされていて関連リンクの表示が目障りである場合などに利用します。
すべてのページで参照回数を表示したい場合は、MenuBarやスキンからcounterプラグインを呼び出してください。
#navi(contents-page-name): No such page: PukiWiki/1.4/Manual/Plugin