チケットでブログ - TickTackBlogプラグイン

1. 概要

チケットに入力したブログを、タイムラインといっしょに表示するプラグインです。
名前は、TicketTrackingWebLogの略です。タイムラインに分刻みで表示されるので、時計のチクタクと掛けてます。

ちょっとかわったブログとして使うのもよいですが、作業メモをちょこちょこと入力するのをお勧めします。
ブログがタイムラインイベントと共に表示されるので、自分がなにをしたか後で見直すことができます。

[[Image(20060501001mini.png)]]

画面は２ペイン型にしてみました。Tracにはめずらしいですが、ブログでは一般的なので。

Trac0.9.xとTrac0.10.0に対応しています。

[[VisitCounter(TracDoc/TickTackBlogPlugin)]]

2. 主な機能

• ブログの表示
  特定の分類(Type)を指定したチケットをブログのように表示します。
  
  
• タイムライン表示
  タイムラインを代替する機能。Wikiの作成やリポジトリへのチェックインといったタイムラインに表示できるアイテムは全て表示可能です（設定により非表示も可能）。
  
  
• RSS
  Tracのタイムラインと異なり、ブログの登録のみRSSに出力します。
  
  

3. セットアップ

3.1 ダウンロード

以下からダウンロードしてください。
・[[Download2(TickTackBlogPlugin Version 0.1,TickTackBlogPlugin0.1,ticktackblogplugin,76)]]

3.2 インストールとセットアップ

TickTackBlogPluginのインストールを行います。[[FootNote(Tracのプラグインに共通する説明は、[wiki:TracPlugins TracPlugins]を参照してください。)]]

(1) eggの設置

zipを解凍してください。
解凍して出来たフォルダ配下のsrcディレクトリに移動してください。
以下のコマンドを実行して下さい:

$ python setup.py bdist_egg

distフォルダが作成されます。
その中にある*.eggファイルを、TracEnvのplugins ディレクトリにコピーしてください。

(2) Trac.iniの設定

TickTackBlogPluginを使用可能にするには、Trac.iniの[components]カテゴリに以下を加えてください。
（pluginフォルダに置いた場合には不要)

[componets]
ticktackblog.* = enabled

ここまでで、TickTackBlogPluginのインストールは終了です。メインメニューに「TickTackBlog」というメニューが追加されていると思います。
ただし、まだ設定をしてないので、メニューを押してもブログは表示されません。
引き続き、ブログを表示するための設定を行ってください。

(3) Trac.iniの設定

TracAdminスクリプトまたは、TracWebAdminを使用して、チケットの分類(Type)に「blog」を追加してください。
これで、チケットの分類(Type)を「blog」にしたチケットが、TickTackBlogに表示されます。[[FootNote(「blog」はTrac.iniに設定することで別の文字に変更可能です)]]
ためしに何かブログ（チケットのこと）を登録して、メニューバーのTickTackBlogをクリックしてみてください。(￣▽￣)Ｖ　

4. 使用方法

メニューにある「TickTackBlog」をクリックしてください。あとは適当にさわればわかります。ヾ(・＿・；） オイオイ

5. カスタマイズ

5.1 Trac.ini

Trac.iniの[ticktackblog]セクションを記載することで、TickTackBlogの動作をカスタマイズすることが出来ます。
ちなみに、このサイトでは以下の指定を行っています。

[ticktackblog]
filter = ticket,ticket_comments,changeset,milestone,mailarchive
defaultauthor = weekbuild
tickettype = ブログ
title = ブログ

[ticktackblog]

tickettype	ブログとして扱うチケットの分類(Type)を１つ指定します。（デフォルト：blog)
defaultauthor	デフォルトで表示するユーザIDを指定します。（デフォルト：everyone) 現在は日付クリック時のURLがかわる以外は特になにも起こりません。
title	メニューバーに表示するタイトルを指定します。(デフォルト：!TickTackBlog)
defaultdays	一覧に表記表示する日数を指定します。(デフォルト：5)
filter	タイムラインとして表示するイベントを指定します。 この項目がない場合は全てのイベントを表示します。（デフォルト） 表示したいタイムラインのフィルタ名を','(カンマ)区切りで指定してください。 ちなみに、以下にフィルタ名を挙げます。左がフィルタ名です。 !wiki:Wiki ページの更新 ticket:チケットの登録、ステータス変更 ticket_comments:チケットのコメント[[FootNote(TickTackBlogPluginに添付のタイムラインイベントです。ticketを指定しただけでは表示されないコメントも表示できます。#71参照)]] ticket_details:チケットの詳細[[FootNote(ticket_detailsは、trac.iniの別の個所にも指定しないと表示されません。なお、ticket_detailsはticket_commentと出力するイベントが重複します。どちらかを指定してください。)]] changeset:リポジトリへのチェックイン milestone:マイルストーン mailarchive:メールの受信（MailArchivePlugin使用時のみ）

 

4.2 サイドバーの表示

特定のWikiページを登録しておくことで、TickTackBlogプラグインのサイドバー（右側のカレンダーの下）にコンテンツを表示できます。
Wikiのページ名は、上記(4.1)で指定した"[defaultauthorに指定したID]/TickTackWikiSide"にしてください。

例：
everyone/TickTackWikiSide

4.3 Templateを書き換える。

(注意)：以下はClearSilverTemplateの知識がないと難しいです。

他のブログのように、簡単にレイアウトを変えることは出来ませんが、Templateファイルを直接編集することでレイアウトを変更可能です。[[FootNote(現在はまだユーザごとにTemplateを分けることは出来ません。1TracEnvにつき1Templateです)]]
ソースからticktackblog.csを取り出してTracEnvのTemplatesフォルダに置いてください。
で、そのファイルを適当に書き換えてください。もちろん、動作保証などありません。

5. 開発中のソースについて

開発中の最新版は、[[Download2(ここ,TickTackBlogPluginDev,ticktackblogplugin,)]]から取得できます。
開発中のもののため動かない可能性もあります。

6. ご意見・ご要望

ご意見・ご要望は[/trac/newticket?component=TickTackBlogPlugin こちら] から登録してください。
これまでに登録されたものは[query:?component=TickTackBlogPlugin こちら] を参照してください。


[[FootNote]]