PukiWiki/Tips/Trackerの使い方のバックアップ(No.3)

Top > PukiWiki > Tips > Trackerの使い方

Trackerの使い方 †

Trackerとは簡単に言えば、自由度の高いbugtrackプラグインである。

Trackerの使い方はヘルプにあるが、テンプレートの書き方が非常に分かりずらい。ここではテンプレートの書き方を、ヘルプの説明では分からない部分を補足すべく説明する。なお、Trackerに関するちゃんとした解説が見つからないため、ここで書かれていることの大部分は推測である。

Trackerでは、4つのページを「:config/plugin/tracker」以下に作成する必要がある。作成するTrackerの定義名を「Sample」とすると、4つのページは次のような名前にする。

新しい定義を作成するときは、初めから用意されている「:config/plugin/tracker/default」や「:config/plugin/tracker/test」を参考にするとよい。以下の説明はこれらを参考にしないと意味不明だろう。

フォームで使用するフィールド（テキストボックスや、コンボボックスなど）を定義する。

「fields」の「項目名」はフィールドの名前になり、雛形（後で紹介する3つのページ）に埋め込む時にも使用される。「見出し」は、tracker_listで一覧表示した時のヘッダ（？）。「オプション」でtextやtextareaの大きさを指定。「デフォルト」はデフォルトの値。

タイプ「text」はテキストボックス、「textarea」はテキストエリアとなる。
タイプ「select」はドロップダウンリストとなる。リストに表示する項目は、同じ名前の見出しを作り、その下にテーブルを作る。テーブルの「見出し」が項目名、「セルの書式」はtracker_listで一覧表示した時の書式（？）。
タイプ「page」もテキストボックスだが、雛形に埋め込んだ時にリンクが付く。
タイプ「title」もテキストボックスだが、雛形に埋め込んだ時にWikiの書式が削除される？
タイプ「format」もテキストボックスだが、雛形に埋め込んだ時にその下の「format」項の書式が使われるようだ。例えば、
```
* format
|条件|セルの書式|文字書式|h
|IS NOT NULL|BGCOLOR(#ffccff):%s|[[URL>%s]]|
|NULL|BGCOLOR(#ccffcc):SIZE(10):%s|not specified.|
```
とすると、「URL」と表示されるリンクとなる。多分「セルの書式」が一覧での書式で、「文字書式」がページ内での書式だろう。（と思っていたら違った。「文字書式」が一覧でも使われている。）しかし、「条件=NULL」の時の書式は使われていないようだが...。
タイプ「file」はファイルのアップロードで使われるようだが、実際には使用できなかった。

書式の定義では、「%s」とした部分が、入力された値に置き換えられる。

「#tracker(ample)」で表示されるフォームの雛形。:config/plugin/tracker/Sample?で定義した項目を「[項目名]」のように埋め込む。独自に定義したもの以外に、次の2つが使える。

「#tracker_list(Sample)」で表示されるリストの項目の雛形。:config/plugin/tracker/Sample?で定義した項目を「[項目名]」のように埋め込む。独自に定義したもの以外に、次のものが使える。

また、[項目名1,項目名2]とすることにより、項目名2の書式を適用できるようになる。

作成されるページの雛形。:config/plugin/tracker/Sample?で定義した項目を「[項目名]」のように埋め込む。独自に定義したもの以外に、:config/plugin/tracker/Sample/list?で紹介した[_update]と[_page]以外が使用できる。

ページ情報
カテゴリ : PukiWiki 作成日 : 2006-07-25 (火) 01:26:06 作成者 : DOBON! 最終編集日 : 2006-07-25 (火) 01:39:37 最終編集者 : DOBON!