使用法

Top > Manual > Plugin > tag.inc.php > rev184
Table of Contents

書式

Tagging

Format

&tag(tag[,tag[,tag[,...]]]);

Example

&tag(PukiWiki,Plugin);
&tag(プラグイン);

Result

Tag: PukiWiki Plugin Tag: プラグイン

リンクは taglist プラグインへのリンクとなります。

注意: ^ と - は特別な意味を持つ文字なのでタグには使えません。ページリストの際に ^ は共通ページを(積集合 ∩ のイメージ)、- は差ページ(差集合のイメージ)をリストするのに使用します。


Tag Cloud

タグクラウドの表示には tagclould プラグインを使用します。

Format

#tagcloud([最大件数][,タグ])
  • 最大件数のデフォルトは 20。0 を指定すると全ての意味になります。
  • タグを指定するとそのタグの関連タグのみ表示します。

Example

#tagcloud(0,PukiWiki)

タグ付きページのリスト

タグ付きページのリストを表示するには taglist プラグインを使用します。

書式

#taglist(タグトークン)

Example

#taglist(Plugin-Old)

タグ1^タグ2 とすることで、共通ページを(積集合 ∩ のイメージ)、タグ1-タグ2 とすることで差ページ(差集合のイメージ)をリスト

Result

Configuration

タグクラウド CSS

タグクラウド機能を使用するなら以下の CSS をスキンに追加してください。

svn:plugin/tagcloud.css

FAQ

タグ付け時に何も表示してほしくない

Plugin/enull.inc.php を使用してください。

ページを削除してもタグは消えない?

pukiwiki のプラグインの仕組み上、ページ参照時にしか起動できないためページが削除されてしまうとタグを更新できません。 ページを削除する前に &tag(); としてタグの削除をしてください。 もしくは、アクション型プラグインとして index.php?cmd=tag のようにアクセスするとキャッシュをクリーンアップできます。

PukiWiki 本体改造で乗りきる方法はありますが、プラグインという性質上、本体改造を推奨したくはないのでとりあえず書きません*1

タグの置換はどうすれば

replaceplugin.inc.php を使用してみてください。

置換後、上と同様、アクション型プラグインとして tag プラグインを起動し、タグキャッシュをクリーンアップしてください。

ページをリネームしたら

同様です。

rename プラグイン改造で乗りきる方法はありますが、プラグインという性質上、他のプラグイン改造を推奨したくはないのでとりえず書きません*2

lsx プラグインの豊富な機能を使用したい

lsx.inc.php プラグインをインストール、tag.inc.php を開いて

-$conf['listcmd'] = get_script_uri() . '?cmd=taglist&tag=';
+$conf['listcmd'] = get_script_uri() . '?cmd=lsx&tag=';

のように変更します。ブロック型プラグインとしてページリストする場合も

#lsx(tag=タグトークン)

のように lsx プラグインを使用します。sort オプションなどが使用可能です。

将来的には lsx と taglist は共通のライブラリを利用して同様の機能を使用できるようになる予定です。

Compatibility Check

Please join us to check compatibilities.

Compatible

Selection Vote
PHP4 1
PHP5 1
1.3.7 0
1.4.3 0
1.4.4 0
1.4.5_1 0
1.4.6 0
1.4.7 0
1.4.5plus-eucjp 0
1.4.6plus-u1-eucjp 0
1.4.6plus-u2-eucjp 0
1.4.5plus-u2-i18n 0
1.4.6plus-u1-i18n 0
1.4.6plus-u2-i18n 0
1.4.7plus-i18n 0
1.4.7plus-u2-i18n 0

Incompatible

Selection Vote
PHP4 0
PHP5 0
1.3.7 0
1.4.3 0
1.4.4 0
1.4.5_1 0
1.4.6 0
1.4.7 0
1.4.5plus-eucjp 0
1.4.6plus-u1-eucjp 0
1.4.6plus-u2-eucjp 0
1.4.5plus-u2-i18n 0
1.4.6plus-u1-i18n 0
1.4.6plus-u2-i18n 1
1.4.7plus-i18n 0
1.4.7plus-u2-i18n 0

*1 PukiWiki がページ新規作成時、書き込み時、削除時にプラグインを作動させる仕組みを持っていれば何の苦労もいらないのです
*2 rename プラグインがページ名変更時に他のプラグインを作動させる仕組みを持っていれば何の苦労もいらないのです