« Ticketの添付ファイルのファイル名を加工する(2) | Main | Tracで添付ファイルを直接ダウンロード »

2008.11.16

Trac/DownloadConfig

ダウンロードはこちらから: DownloadConfig-r202.zip (5.4K)

 添付ファイルに関して、Tracのプレビュー画面を経由せずに直接ダウンロードを行うことができるようにするためのプラグインです。設定項目に関しては、以下を参考にしてください。

default_raw_format
    extension_raw、extension_normalのいずれでも指定されていない拡張子のファイルに関して、プレビュー画面を表示するか直接ダウンロードさせるかを設定します。Trueを指定すると、直接ダウンロードさせるようになります(デフォルトはFalse(プレビュー画面を表示)となっております)。

extension_raw
    プレビュー画面を表示せずに直接ダウンロードの対象とする拡張子を指定します。拡張子の指定においては、"."も含めてください。複数ある場合は、カンマで区切ります。画面下部(Wikiページ、Roadmapページ)、チケット内容下部(Ticketページ)のリンクの部分には、自動的にプレビュー画面へのリンクも付加されます。

extension_normal
    必ずプレビュー画面を表示するファイルの拡張子を指定します。指定方法はextension_rawと同じとなります。

extension_inline
    extension_raw で指定されている拡張子のうち、ブラウザに対してinlineで表示させる拡張子を指定します。指定方法はextension_rawと同じとなります。なお、ここで指定する場合、render_unsafe_contentに記載されている注意事項も充分に考慮してください(XSSを仕掛けられる危険性が増します)。

サンプル

    直接ダウンロード対象となっている場合、添付ファイル一覧の部分に(Preview)のリンクが自動的に付加されます。添付ファイルの削除を行う場合は、Preview画面を表示してから作業してください。

注意点
  • レンダリング結果内のテキストを書き換えます。その都合上、Wikiページ/Roadmapページにおいては、Trac本体に若干手を加える必要があります。trac/templates/macros.htmlファイル内の<py:def function="list_of_attachments(alist, compact=False)">の数行下の
    <h3>${_('Attachments')}</h3> <ul>
    のulの部分を、
    <ul id="fileattachments">
    に書き換えてTrac本体の再インストールを行ってください。
  • 本来は、直接ダウンロードを行うリンクをraw-attachmentに書き換えたかったのですが、本文中のリンクの書き換えが上手くいかなかったのでこの方針は保留状態です。

AttachmentListマクロ
添付ファイルの一覧を表示するマクロです。なお、直接ダウンロードするモードと、Previewモードの両方のリンクを表示します。

【使用例】
  • [[AttachmentList()]] : Wiki/Ticket/Milestone全てを対象に、登録されている添付ファイルの一覧を表示します。
  • [[AttachmentList(wiki)]] : Wikiのみを対象に、登録されている添付ファイルの一覧を表示します。同様に、ticket、milestoneを指定可能です。また、wiki,ticketのようにカンマでつなげることも可能です。
  • [[AttachmentList(wiki=hoge|fuga)]] : 指定されたWikiページの添付ファイルの一覧を表示します。ページは|で区切ります。同様に、ticket、milestoneを指定可能です。また、wiki=hoge|fuga,ticket=1|2のようにカンマでつなげることも可能です。

2008/11/22更新
  • 直接ダウンロードするように指定している拡張子でも、プレビュー画面を表示することができるようにしました。
  • ブラウザのキャッシュへの対策を行いました。ただし、既にキャッシュされているファイルに対しては効果がありませんので、一度ブラウザのキャッシュをクリアする必要があります。

2008/11/23更新
  • 添付ファイルの追加ができなくなっていた不具合を修正しました。
  • 添付ファイルをアップロードする際に「置き換える」のチェックをデフォルトでオンにするための機能も便乗で追加しました。

2008/11/26更新
  • 添付ファイルアップロード後にエラーが出ていたのを修正しました。

2009/01/20更新
  • 添付ファイル一覧を表示するマクロ AttachmentList を追加しました。

|

« Ticketの添付ファイルのファイル名を加工する(2) | Main | Tracで添付ファイルを直接ダウンロード »

Comments

DownLoadConfigプラグインですが、Trac0.12で利用可能でしょうか?

Posted by: ろぽん | 2010.11.22 19:34

申し訳ありませんが、Trac0.12での動作確認は行えておりません。また、自分自身、環境をTrac0.12へ移行する目処が立っておりませんので、当面、検証する予定もありません。
ただ、Edgewall社のデモサイトを見た感じ、標準の機能で直接ダウンロードするリンクも表示されるようなので、このDownloadConfigプラグインは用済みかもしれません(参考1 http://trac.edgewall.org/demo-0.12/ticket/285 、参考2 http://trac.edgewall.org/demo-0.12/wiki#no1 )。

Posted by: syo | 2010.11.23 09:21

Post a comment



(Not displayed with comment.)


Comments are moderated, and will not appear on this weblog until the author has approved them.



TrackBack


Listed below are links to weblogs that reference Trac/DownloadConfig:

» [Trac]添付したpdfファイルをブラウザ内で開きたい・・プラグインTrac/DownloadConfigを試す [Nunockyの日記]
※ まだ動いていない。作業記録も兼ねる。 Tracのwikiページに添付したpdfファイルは、一旦プレビューの画面で「HTML プレビューできません。 レンダリングエンジンが定義されていません。 ファイルをダウンロードして下さい。 」などと怒られてからダウンロードが可能にな... [Read More]

Tracked on 2008.11.18 12:05

« Ticketの添付ファイルのファイル名を加工する(2) | Main | Tracで添付ファイルを直接ダウンロード »