PukiWiki/Tips/Trackerの使い方の変更点

Top > PukiWiki > Tips > Trackerの使い方
追加された行はこの色です。
削除された行はこの色です。
PukiWiki/Tips/Trackerの使い方へ行く。
PukiWiki/Tips/Trackerの使い方の差分を削除
*Trackerの使い方 [#n6290995]

Trackerとは簡単に言えば、自由度の高い[[bugtrackプラグイン>PukiWiki/Tips/バグレポート入力フォームを表示する]]である。

Trackerの使い方は[[ヘルプ>http://wiki.dobon.net/index.php?cmd=read&page=PukiWiki%2F1.4%2FManual%2FPlugin%2FS-U#rf5296e2]]にあるが、テンプレートの書き方が非常に分かりずらい。ここではテンプレートの書き方を、ヘルプの説明では分からない部分を補足すべく説明する。なお、Trackerに関するちゃんとした解説が見つからないため、ここで書かれていることの大部分は推測である。
Trackerの使い方は[[ヘルプ>https://wiki.dobon.net/index.php?cmd=read&page=PukiWiki%2F1.4%2FManual%2FPlugin%2FS-U#rf5296e2]]にあるが、テンプレートの書き方が非常に分かりずらい。ここではテンプレートの書き方を、ヘルプの説明では分からない部分を補足すべく説明する。なお、Trackerに関するちゃんとした解説が見つからないため、ここで書かれていることの大部分は推測である。

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

-[[:config/plugin/tracker/Sample]]
-[[:config/plugin/tracker/Sample/form]]
-[[:config/plugin/tracker/Sample/list]]
-[[:config/plugin/tracker/Sample/page]]

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

**[[:config/plugin/tracker/Sample]] [#n8d6cb71]

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

「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」とした部分が、入力された値に置き換えられる。

**[[:config/plugin/tracker/Sample/form]] [#m5559c6c]

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

-[_name]：ページの名前。省略可。
-[_submit]：「追加」ボタン。

**[[:config/plugin/tracker/Sample/list]] [#f85c786b]

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

-[_page]：ページの名前。リンクつき。
-[_refer]：#trackerを置いたページ。リンクつき。
-[_name]：[[:config/plugin/tracker/Sample/form]]で指定された文字列。
-[_real]：[_page]から[_refer]を取ったもの。
-[_date]：投稿日時。
-[_base]：#tracker_list(Sample)の第2引数。または[_refer]。
-[_update]：ページの最終更新日時。 
-[_past]：最終更新日時からの経過。

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

**[[:config/plugin/tracker/Sample/page]] [#m4d43227]

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

//これより下は編集しないでください
#pageinfo([[:Category/PukiWiki]],2006-07-25 (火) 01:26:06,DOBON!,2006-07-25 (火) 01:39:37,DOBON!)
▲ ▼
DoboWiki
