*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!) |