誠に恐れ入りますが、TracOfficeRenderのメンテナンスは都合により終了しました。

プロジェクト管理システムTracのリポジトリブラウザ上で、Word、Excel、PowerPointのデータを表示するプラグインを作成したので公開します。

概要

Tracのリポジトリブラウザ上に、Word、Excel、PowerPointのデータをHTMLに変換して表示します。
変換に際しては、以下の外部ライブラリを使用しており、別途インストールが必要です。

  • Word – wvWare
  • Excel – xlhtml
  • PowerPoint – ppthtml(xlhtmlに付属)

HTMLに変換しているため、同じ表示というわけにはいきませんが、設計書や仕様書の内容を確認するには充分です。

なお、TracのプラグインどころかPythonのスクリプトも今回が初めてなので、変なところがあるかもしれません。
ご意見・ご要望・ご質問は大歓迎いたします。

動作環境

  • linux(Windowsでは動作しません。)
  • Trac 0.10.4
    (2008/3/26追記 0.11bではAPIの仕様が変わっているため動作しません。)
  • wvWare 1.0.3以上(?)
  • xlhtml 0.5.1以上(?)

弊社の環境では、TracのPygmentsプラグインとの相性が悪いようでした。
リポジトリブラウザ関係のプラグインとは相性があるかもしれません。

弊社のテスト環境

  • CentOS 4.5
  • Trac 0.10.4
  • Python 2.3.4
  • mod_python 3.1.3
  • Apache 2.0.59
  • wvWare 1.0.3
  • xlhtml 0.5.1

インストール方法

あらかじめ、wvWare及びxlhtmlをインストールしてください。
% unzip TracOfficeRender-01.zip # ファイルを解凍
% cd TracOfficeRender/
% sudo python setup.py install

Trac.iniの[mimeviewer]ディレクティブに以下の内容を追加してください。
wvWare_path = /usr/local/bin/wvWare
xlhtml_path = /usr/local/bin/xlhtm
ppthtml_path = /usr/local/bin/ppthtml

パスはそれぞれ、ご自身の環境に合わせてください。
それぞれのコマンドが/usr/local/bin以下にある場合は、上記の設定は記述しなくても動作します。

ダウンロード

TracOfficeRender-01.zip

更新履歴

2008/03/25

既存のプロジェクトと名称が重複していたため、TracOfficeRenderに名称を変更しました。
すでにインストールされた方は、誠に恐れ入りますが、アンインストールしてから再度インストールしてください。
また、今回の名称の変更のついでに、出力キャッシュ機能を設けました。

古い名称のファイルのアンインストール方法

  • $PYTHONLIB/site-packages/ 以下にあるTracOfficeView-0.1-py2.3.eggを削除
  • $PYTHONLIB/site-packages/easy-install.pth 内のTracOfficeView-0.1-py2.3.eggと記述されている行を削除
  • ウェブサーバーを再起動

今後の課題

    1. 重いので出力キャッシュの仕組みが必要かもしれない。(対応しました。2008/03/25)
      差分表示をしたいけど、プラグインのapiがあるのかどうかも分からない。

免責事項

ライセンスは、Trac本体にあわせてBSDライセンスとしますが、このプログラムを使ったことによるいかなる損害、トラブルに対しても責任を負うことはできません。
うまく動作しない等のご質問・ご要望にはなるべくお答えします。

リンク

  • The Trac Project – 開発元
  • HirobeのHack倉庫 – こちらで配布しているXDocViewプラグインを参考にさせていただきました。windows上で動作しているTracならこちらの方がおすすめです。
  • OfficeViewPlugin – こちらで配布しているプラグインもOpenOfficeを利用して同様の機能を実装しています。(ただし、こちらもWindows用です。)

コメント (4)

  • [...] さて、弊社サイトで配布しているTracOfficeRenderにつきましては、非常に多くのお客様にダウンロードしていただいておりましたが、Office2007への対応やTracバージョンアップへの対応等が非 [...]
  • 3. miyauchi - 2008/03/24 20:06:00
    hirokinkoさんはじめまして。
    それほどたいしたプログラムではないので恐縮ですが、お役に立てれば幸いです。
    ついでに、宣伝でもしていただければ(笑)
    名前がかぶっていますね、知りませんでしたすいません。
    名前を変えます。

    mootohさんはじめまして。
    初歩的なアドバイスで申し訳ないのですが、Apacheをしてみてはどうでしょうか?
    Trac0.11bでは動作テストしていないので、もうしかしたらだめなのかもしれません。
    ちょっと調べてみます。

    Trac 0.10.4以上 という記述は問題がありますね。
    修正しました。
  • 2. mootoh - 2008/03/24 15:02:50
    おお!
    さっそく使わせていただこうと、python setup install し、trac.ini の設定もしたのですが、Trac Web Admin にプラグインが表示されず、プレビューすることもできませんでした。

    Tracのログを見たところ、プラグインはちゃんと認識されているようですが...

    Trac[__init__] DEBUG: Adding plugin TracOfficeView 0.1 from /usr/lib/python2.4/site-packages/TracOfficeView-0.1-py2.4.egg

    Trac 0.11b1を、Debian etchのApache2.2.3 + ModPython3.2.10で動かしています。

    ぜひ利用したいので、アドバイスいただければ幸いです。
  • 1. hirokinko - 2008/03/24 02:32:29
    はじめまして、御社で開発されているTracOfficeViewプラグインと同様に、Shibuya.tracというOSSコミュニティでOfficeのファイルをPDFに変換してTrac上でプレビューするプラグインを作っている者です。
    私の方でもちょうどLinux環境対応とHTML表示の追加を検討していたところ、偶然こちらのプラグインのことを知りました。
    こちらのプラグインのソースコードを是非マージさせていただきたいのですが、構いませんでしょうか?

    私が開発したプラグインは下記URLにあります。
    ご参考までにどうぞ。

    http://sourceforge.jp/projects/shibuya-trac/wiki/plugins%2FOfficeViewPlugin

コメントの投稿

*がついている項目は必須入力です。
お名前*
メール* (非表示)
URL
コメント*

デジタルカタログ制作 ASP型メルマガ配信 技術者向けブログ
串本ダイビング