こんにちは。先日リリースした fulmo(フルモ)の新機能を2分で説明した動画をアップロードしましたのでご紹介します。
fulmo(フルモ)の新機能で注目して頂きたい点は、
これまでは、不具合報告専用のチケット登録ツールでしたが、シンプルで実用的な画像編集機能が追加されました。
ブラウザアプリケーション開発者やドキュメント作成者、テスターなどの幅広い人たちに使って頂くためのアプリケーションにバージョンアップしています。ぜひご利用ください。
fulmo の紹介とインストールについては、こちらをご覧ください。
3月も終わりに近づきまだ肌寒さもあるものの陽射しは少しずつ春を感じさせるものになりつつありますね。
さて今回は「Trac で添付ファイルの中身を参照するのにいちいちページ遷移しないといけないのがめんどくさい」という話を聞いて、それを少しだけ解消するプラグインを作ってみたのでそれの紹介です。
いきなりですが、さっそくインストールしましょう。easy_install に http://trac-hacks.org/svn/overlayviewplugin/0.12 を渡せばさくっとインストールできます。svn コマンドがない環境では、これではインストールできないと思います。その場合には手動でエクスポートを行い、エクスポートしたディレクトリを easy_install に渡すようにしてください。
C:>easy_install -Z http://trac-hacks.org/svn/overlayviewplugin/0.12 Downloading http://trac-hacks.org/svn/overlayviewplugin/0.12 Doing subversion checkout from http://trac-hacks.org/svn/overlayviewplugin/0.12 to c:\docume~1\admini~1.ope\locals~1\temp\easy_install-x_lmas\0.12 Processing 0.12 Running setup.py -q bdist_egg --dist-dir c:\docume~1\admini~1.ope\locals~1\temp\easy_install-x_lmas\0.12\egg-dist-tmp-ubt6k_ zip_safe flag not set; analyzing archive contents... overlayview 0.12.0.1 is already the active version in easy-install.pth Installed c:\traclight\python\lib\site-packages\overlayview-0.12.0.1-py2.6.egg Processing dependencies for overlayview==0.12.0.1 Finished processing dependencies for overlayview==0.12.0.1
有効にしたい Trac プロジェクトの conf/trac.ini か inherit-file で共有している trac.ini でこのプラグインを有効にします。
# trac.ini [components] tracoverlayview.* = enabled
この後、Trac を動作させている Web サーバを再起動させます。
まずは、添付ファイルがあるチケットや Wiki ページへ行ってみましょう。そのページにある添付ファイル一覧からリンクをクリックすると、lightbox 風のビューでそのファイルを参照できるようになります。
また、画像以外の添付ファイルやタイムラインでの添付ファイルリンクでも同じように遷移せずにその場で参照できるようになります (ちょっと解りにくいですがロケーションバーの URL が /timeline です)。
こんな感じで添付ファイルの参照が少しだけ楽になるかと思います。こうしてほしいとか、ここおかしいんだけど、などありましたら trac-hacks のチケットかここのコメント欄にお願いします。それでは。
いましがた TracLightning 3.1.3 をリリースしました。3.1.2 をリリースしてからかなり時間が経ってしまいました。
今回のリリースはメンテナンスを主眼としているため新しい機能などはありません。ちいさなバグをいくつか修正したことと、本バージョンから各 Trac プラグインの egg ファイルを展開した状態でインストールようにしました。
egg ファイルを展開するのは、少しでもパフォーマンスを稼ぐ意味 (それと最初のレスポンスを早くする) で行なっています。その際のチケットは チケット #26414: TracLightningのチューニング方法について にあります。このチケットでは TracLightning に取り込んでいない Trac のチューニング方法もあげていますので興味のある方はご覧下さい。
次回のリリースは 3.2 で Apache と Subversion をバージョンアップして Apache 2.2.x 最新版、Subversion 1.6.x 最新版にする予定です。動作する Subversion 1.7 系の Python バインディングが確保できれば、両方を同梱するかも知れません。
TracLightning や Trac そのもの、同梱しているモジュールのバグを見つけたり TracLightning に対する要望などありましたら TracLightning プロジェクトページまでお願いします。
余談ですが、現時点 (2011-10-24) で Windows 上で動作する Subversion 1.7.x の Python バインディングは CollabNet Subversion Edge 2.1 のみで Trac を Windows で動かすには Subversion Edge 2.1 を使うしかありません。ただし同梱されている Python は 2.7 です。また Apache, mod_wsgi の上で動作するかは未確認です。tracd での動作は確認しています。もう一つの http://souceforge.net/projects/win32svn にある Python バインディングには問題があり動作しません (詳しくは Trac Project #10416 参照)。
Trac と Subversion 1.7.x との組合せの問題は http://trac.edgewall.org/query?keywords=svn17 に上がっています。もし、これ以外に問題を発見したらぜひ教えてください。
それでわ。
こんにちわ。いつのまにか十月になっていて朝夕は寒くて、あまり体調がよくないおおまえです。今日は blockdiag というツールを TracLightning から使えるようにする手順を書きたいと思います。
blockdiag というのは http://blockdiag.com/ja/ によると『blockdiag シリーズはシンプルなテキストからブロック図などの画像を生成する画像生成ツール群です。』だそうです。graphviz 風のテキストからブロック図が生成できるツールで graphviz が好きな人はきっと blockdiag も好きなはずです ;)
この blockdiag を Trac から扱えるようにしたプラグインがあり、今回はこのプラグインをインストールして使えるようにします。
インストール作業は easy_install コマンドが主体になるので、コマンドプロンプトを起動しておきます。「スタートメニュー」>「Trac」>「コマンドプロンプト」を使って起動してください。
次に blockdiag が画像を描画するのに使用している Python Imaging Library (PIL) を easy_install コマンドでインストールします。 ここで最新版である 1.1.7 ではなく、1.1.6 をインストールします。
C:> easy_install PIL==1.1.6
なぜ PIL-1.1.6 をインストールするかというと、PIL-1.1.7 のライブラリが VC++ 2008 のデバッグ用 DLL にリンクしているために VC++ 2008 をインストールしていない環境では動作しないという問題があり、これを回避するためにこのようなことをしています。
ちなみに PIL は「Microsoft Visual C++ 2008 SP1 再頒布可能パッケージ」 (x86, x64) が必要なので、インストールしていない場合にはここで一緒にインストールしておきましょう。
同じく easy_install を使って簡単にインストールできます。
C:> easy_install blockdiag C:> easy_install seqdiag C:> easy_install actdiag C:> easy_install nwdiag
ちゃんとインストールできていれば、blockdiag コマンドが使えるはずなので確かめておきます。その他のコマンドも確かめておきましょう。
C:> blockdiag -h
Usage: blockdiag-script.py [options] infile
Options:
--version show program's version number and exit
-h, --help show this help message and exit
-a, --antialias Pass diagram image to anti-alias filter
-c FILE, --config=FILE
read configurations from FILE
-o FILE write diagram to FILE
-f FONT, --font=FONT use FONT to draw diagram
-P, --pdb Drop into debugger on exception
-s, --separate Separate diagram images for each group (SVG only)
-T TYPE Output diagram as TYPE format
--nodoctype Do not output doctype definition tags (SVG only)
C:> blockdiag --version
blockdiag-script.py 0.9.4
これも easy_install から簡単にインストールできます。現時点では 0.5.0 です。
easy_install http://trac-hacks.org/svn/tracblockdiagplugin/0.12
必要なモジュール、プラグインをインストールしたので、ここで再起動しておきます。管理ツールで再起動、もしくはコマンドラインから以下のように入力しても再起動できます。
C:> net stop traclightning C:> net start traclightning
プラグインを有効にするために、以下の記述を C:\TracLight\python\share\trac\conf\trac.ini の [components] セクションに追加します。
blockdiagplugin.* = enabled
さらに blockdiag で使用するフォントを指定するために、以下の設定を追加します。
[blockdiag] font = C:\WINDOWS\FONTS\msgothic.ttc
ここで指定したフォントを使ってブロック図の文字が描画されるようになっていて、この指定がないと文字化けを起こすはずです。メイリオが好きな人は代わりに meiryo.ttc にしたり、自分の好きなフォントをフルパスで指定してみてください。
適当なプロジェクトの Wiki ページで以下のようなのを書きこんでみます。
{{{#!blockdiag(type=png)
diagram admin {
// Set M17N text using label property.
A [label = "起"];
B [label = "承"];
C [label = "転"];
D [label = "結"];
A -> B -> C -> D;
// Use M17N text directly (need to quote).
春 -> 夏 -> 秋 -> 冬;
// Use M17N text including symbol characters (need to quote).
"春は 曙" -> "夏 = 夜" -> "秋.夕暮れ" -> "冬 & つとめて";
}
}}}
すべて問題なくインストール・設定できていれば以下のような形でブロック図が Wiki に展開されているはずです。
すばらしいです。Wiki から手軽に簡単にブロック図を書くことができるようになりました。
ここで試してみたものはあくまで一例に過ぎないので、インストールしていろいろ試してみてください。
cikloneはTracをベースにしたエンタープライズ向けのWebサービスです。利用しているお客様の声から開発した各種プラグインをTrac/Trac Lightningでも利用できるように trac-hacks:ExcelDownloadPlugin として公開しました。
https://trac-hacks.org/wiki/ExcelDownloadPlugin
Excelダウンロードプラグインは、Tracの強力なレポート機能と連動した
することが出来ます。
それでは、Windows環境で良く利用されているTracLightningをつかってインストールをしましょう。
ExcelDownloadPlugin は Excel ファイルの生成に xlwt を使っています。まずはこれをインストールします。
c:\TracLight\bin>easy_install -Z xlwt
https://trac-hacks.org/wiki/ExcelDownloadPlugin にアクセスして、Downloadから「here」をクリックして、exceldownloadplugin-rxxxxx.zip をダウンロードします。ダウンロードしたファイルを適当なディレクトリに展開します。
ここでは、
C:\temp\exceldownloadplugin\0.12
に展開。
easy_install にソースディレクトリを指定してインストールを実行します。
c:\TracLight\bin>easy_install -Z C:\temp\exceldownloadplugin\0.12 Processing 0.12 Running setup.py -q bdist_egg --dist-dir C:\temp\exceldownloadplugin\0.12\egg-dist-tmp-nduefk zip_safe flag not set; analyzing archive contents... Adding exceldownloadplugin 0.12.0.1 to easy-install.pth file Installed c:\traclight\python\lib\site-packages\exceldownloadplugin-0.12.0.1-py2.6.egg Processing dependencies for exceldownloadplugin==0.12.0.1 Finished processing dependencies for exceldownloadplugin==0.12.0.1
trac.ini はプロジェクト毎に設定する必要があります。有効にしたいプロジェクトの conf/trac.ini でプラグインを有効にします。
# conf/trac.ini [components] tracexceldownload.* = enabled
カスタムクエリやレポートからチケット一覧を表示します。一覧表示されたページの下部に、「Excel」「Excel(履歴含む)」が表示されます。あとは、クリックしてダウンロードしてください。
Excelダウンロードプラグイン
が利用可能です。
ぜひ、あなたのプロジェクトでご活用下さい。
こんにちは。オンラインマニュアル担当のhayashidaです。
先日リリースされました、高速・シンプルで簡単なウェブアプリケーション向けのスクリーンキャプチャー&バグレポートツール、fulmo。もうお使い頂いていますでしょうか？
私なども、画像を添付したチケットの作成が圧倒的に楽になり、重宝しております。
fulmoに対するより詳しい説明は前回8月8日の記事をご覧下さい。
これに伴って、fulmoオンラインマニュアルページをオープン致しました。
本当にシンプルなので、直感的に使って頂けますが、周囲の皆さんにご説明頂く時やcikloneと合わせてこんな使い方も出来るのねふーん。といった感じで見て頂けると幸いです。
先ずは導入方法からご確認下さい。
cikloneご利用の方だけでなく、Tracユーザの皆様も是非fulmoをご活用下さい。
では、また！
先週まで涼しかったのに今週はずいぶん暑くて辛いおおまえです。(夏はまだまだこれからなのに…)
先週の金曜ぐらいにJIRA 課題を付箋に印刷する方法というのを知りました (たしかに Twitter で)。「これはよいのでわ!」と思い、同じようなことができる Trac プラグインを作ってみました。
http://trac-hacks.org/wiki/StickyTicketPlugin
さっそくインストールしましょう。
http://trac-hacks.org/svn/stickyticketplugin/0.12 を適当なディレクトリにチェックアウト (もしくはエクスポート) します。
easy_install にソースディレクトリを指定してインストールを実行します。PDF 生成のために reportlab を使っています。このライブラリがインストールされていない場合には PyPI から合わせてインストールされます。
C:\TracLight\bin>easy_install -Z C:\temp\stickyticketplugin\0.12 Processing 0.12 Running setup.py -q bdist_egg --dist-dir C:\temp\stickyticketplugin\0.12\egg-dist-tmp-aboc0q zip_safe flag not set; analyzing archive contents... stickyticketplugin 0.12.0.1 is already the active version in easy-install.pth Installed c:\traclight\python\lib\site-packages\stickyticketplugin-0.12.0.1-py2.6.egg Processing dependencies for stickyticketplugin==0.12.0.1 Searching for reportlab Reading http://pypi.python.org/simple/reportlab/ Reading http://www.reportlab.com/ Best match: reportlab 2.5 Downloading http://pypi.python.org/packages/2.6/r/reportlab/reportlab-2.5.win32-py2.6.exe#md5=4ce6342f3264507a59b33d20dd819471 Processing reportlab-2.5.win32-py2.6.exe reportlab.rl_config: module references __file__ reportlab.__init__: module references __file__ reportlab.lib.fontfinder: module references __file__ reportlab.lib.testutils: module references __path__ reportlab.lib.utils: module references __file__ reportlab.lib.utils: module references __path__ reportlab.pdfgen.pdfimages: module references __file__ creating 'c:\docume~1\admini~1.ope\locals~1\temp\easy_install-_go0ni\reportlab-2.5-py2.6-win32.egg' and adding 'c:\docume~1\admini~1.ope\locals~1\temp\easy_install-_go0ni\reportlab-2.5-py2.6-win32.egg.tmp' to it creating c:\traclight\python\lib\site-packages\reportlab-2.5-py2.6-win32.egg Extracting reportlab-2.5-py2.6-win32.egg to c:\traclight\python\lib\site-packages Adding reportlab 2.5 to easy-install.pth file Installed c:\traclight\python\lib\site-packages\reportlab-2.5-py2.6-win32.egg Finished processing dependencies for stickyticketplugin==0.12.0.1
有効にしたい Trac プロジェクトの conf/trac.ini か inherit-file で共有している trac.ini でこのプラグインを有効にします。
# trac.ini [components] tracstickyticket.* = enabled
付箋に印刷するにあたって、まずは付箋を貼り付ける台紙が必要です。それを作るためにプラグインを有効にしたプロジェクトの検索ボックスで query:?id=0 と入力します。
もちろん検索結果は 0 ですが、この一番にある「付箋」リンクをクリックすると付箋を貼り付ける箱が描かれた PDF がダウンロードできます。この PDF を印刷して付箋を貼る台紙にします。
付箋のサイズはデフォルトで 75mm x 75mm としています。また紙のサイズは A4 です。これ以外のサイズにしたいときは trac.ini で [sticky-ticket] セクションを設定してください。sticky-width, sticky-height で付箋の幅と高さをミリメートルで指定するようになっています。
ようやく準備が整いました。カスタムクエリを使って印刷したいチケットを絞り込みます。絞り込んだら一番下にある付箋リンクをクリックしましょう。付箋を貼った位置と同じ場所にチケット内容が配置された PDF がダウンロード出来たでしょうか。うまく行っていれば、この PDF と付箋を貼った紙を手差ししながらチケットを付箋に印刷していきましょう。
印刷したいチケットの番号がはっきりしているときには、カスタムクエリから検索条件にチケットを選んで対象の id をカンマ区切りで入力するとすぐに検索できます。検索ボックスから query:?id=6,8,10 と入力するのでもいいと思います。
これでチケットが付箋に印刷できました。タスクボードに貼っていきましょう。
普通は、trac.ini に [ticket-workflow] セクションを作成し、[ticket-workflow] セクション内にサンプルを貼り付けておわり。
残念ながら、TracWorkflowAdmin にはGUIで trac.ini の {ticket-workflow} を編集できる機能がないので画像を示しながら設定例を解説します。当然、trac.ini の {ticket-workflow}セクションにコピーアンドペーストしても良いです。
標準的なワークフローです。流れとしては、新規作成(new) → 担当割り当て(assigned) → 解決(closed) となります。新規作成(new) → 担当する(accepted) → 解決(closed) という流れもあり、こちらはチケットを自分で選んで処理する場合のフローです。
[ticket-workflow] accept = new,assigned,accepted,reopened -> accepted accept.default = 999 accept.name = 担当する accept.operations = set_owner_to_self accept.permissions = TICKET_MODIFY leave = new,assigned,accepted,reopened,closed -> * leave.default = 1000 leave.name = 変更しない leave.operations = leave_status reassign = new,assigned,accepted,reopened -> assigned reassign.default = 998 reassign.name = 担当を変える reassign.operations = set_owner reassign.permissions = TICKET_MODIFY reopen = closed -> reopened reopen.default = 997 reopen.name = 再オープンする reopen.operations = del_resolution reopen.permissions = TICKET_CREATE resolve = new,assigned,accepted,reopened -> closed resolve.default = 996 resolve.name = 解決にする resolve.operations = set_resolution resolve.permissions = TICKET_MODIFY
最もシンプルなフローです。新規作成(new) → 解決(closed) 。一人で利用している場合やワークフロー機能を使わない場合など、チケットを備忘録やタスクとしてシンプルに利用するときに良いかもしれません。
[ticket-workflow] leave = new,closed,reopened -> * leave.default = 1000 leave.name = 変更しない leave.operations = leave_status reopen = closed -> reopened reopen.default = 999 reopen.name = 差し戻す reopen.operations = del_resolution reopen.permissions = TICKET_CREATE resolve = new,reopened -> closed resolve.default = 998 resolve.name = 解決にする resolve.operations = set_resolution resolve.permissions = TICKET_MODIFY
フローダイアグラムは少し複雑になります。
チケットの作業が完了したとき、「確認待ち」というステータスが必要な場合があります。バグ管理の場合、開発者が対応済みと思っても、解決していないことや認識違いが多々あります。そこで、「完了」の前に必ず別の担当者による「確認」を入れることでバグが修正されたことをチェックしたり、再現しないことを確認したあとで「完了」にするためのワークフローです。
このワークフローでは完了にするためには必ず「解決・確認を依頼する」を経由しなければいけません。場合によっては直接完了できるフローを追加しても良いかもしれません。
[ticket-workflow] leave = new,assigned,accepted,reopened,closed,resolved -> * leave.name = 変更しない。 leave.default = 1 leave.operations = leave_status accept = new,assigned,accepted,reopened -> accepted accept.name = 着手する。 accept.default = 0 accept.operations = set_owner_to_self accept.permissions = TICKET_MODIFY reassign = new,assigned,accepted,reopened -> assigned reassign.name = 担当者変更 reassign.default = 0 reassign.operations = set_owner reassign.permissions = TICKET_MODIFY reject = resolved -> assigned reject.name = 差し戻す。 reject.default = 0 reopen = closed,resolved -> reopened reopen.name = 再オープンする。 reopen.default = 0 reopen.operations = del_resolution reopen.permissions = TICKET_CREATE resolve = new,assigned,accepted,reopened -> resolved resolve.name = 解決、確認を依頼する。 resolve.default = 0 resolve.operations = set_resolution resolve.permissions = TICKET_MODIFY verify = resolved -> closed verify.name = 完了を承認する。 verify.default = 0 verify.operations = set_resolution
trac の wiki/TracWorkflowから引用
などがワークフロー関連では良く利用されているのではないでしょうか。
今回ご紹介するプラグインは、
チケットワークフローの図
TracWorkflowAdmin はチケットのワークフロー管理のために、シンプルなWebインターフェースを提供し、ワークフローを簡単に追加・編集することができます。
TracWorkflowAdminの一番の特徴は、変更したワークフローをダイアグラム(線図)によるリアルタイムプレビューが利用できることです。
従来のワークフロー管理では複雑なワークフローを作成する場合、何度もやり直して試行錯誤しながら設定していたのではないでしょうか。このプラグインは「かんたんに、目で見て分るワークフロー管理」を目指して開発しました。
前準備として、Tracが正常に動作する環境とpythonへのパスが通っていること。python は TracLightning と同時にインストールされます。パスの設定なども導入時に出来ていると思います。
>{Tracホーム}\python\Scripts
TracWorkflowAdmin をダウンロードし、適当な場所に解凍します。
C:> easy_install.exe C:\TracLight\plugins\svn\tracworkflowadmin\0.12
実行結果:
C:\TracLight\bin>easy_install.exe c:\TracLight\plugins\svn\tracworkflowadmin\0.12 Processing 0.12 Running setup.py -q bdist_egg --dist-dir c:\TracLight\plugins\svn\tracworkflowadmin\0.12\egg-dist-tmp-k4yidd zip_safe flag not set; analyzing archive contents... Removing tracworkflowadmin 0.1 from easy-install.pth file Adding tracworkflowadmin 0.12.0.1 to easy-install.pth file Installed c:\traclight\python\lib\site-packages\tracworkflowadmin-0.12.0.1-py2.6.egg Processing dependencies for tracworkflowadmin==0.12.0.1 Finished processing dependencies for tracworkflowadmin==0.12.0.1
TracLightningの場合、
再起動できたらブラウザから TracLightning のプロジェクトに管理者カウントでログインします。
ログイン後、管理メニュー → プラグインをクリック。
trac でプロジェクトを運用をするのが初めての方などは特にですが、「チケットって何を書けばいいの？」となることが多いとおもいます。
私も初めて使ったときはチケットとはどういうものかよくわからなかったものです。
雛形があればどうにかチケットを書くことができるのではないか。
そんなプラグインなんて・・・ありました！
今回はチケットのテンプレートを作成できるプラグイン Trac Ticket Template Plugin をご紹介いたします。