Windows Live Writerと連携 - WLWriterPlugin

1.概要

このプラグインは、Windows Live WriterでTracのWikiページを編集するためのプラグインです。

Windows Live Writerはブログ用のオフラインツールです。画像ファイルをクリップボードから張り付けることができるのが利点。このプラグインは、ぺたぺた画面キャプチャを張り付けながらwikiを作ること（手順書作るとか）が多い人向けです。

ちなみに、TracにはそれなりのWiki文法で保存されます。

Error: Macro Image(image_thumb_12.png) failed

Attachment 'wiki:TracDoc/WlwWikiPlugin: image_thumb_12.png' does not exist.

2.主な機能

(1) Metablog APIとの連携。

Windows Live Writerが持っているブログ投稿用のAPI (MetablogAPI) を受信し、Wikiページとして保存します。

(2) Wiki文法での保存。

Windows Live Writerが出力するの文法はHTMLですが、このプラグインはTracに保存する際にWiki文法に変換します。

なお、Wiki文法はHTMLほどの自由度はないので、変換できないものがあります。このツールの完成度が低いために変換できないものもあります。つまり、Windows Live Writerで作成した画面と、投稿した結果は一致しないことがあります。

3.注意事項

このプラグインは、まだ全然作りかけのプロトタイプなので、完成度は高くないです。そのつもりで使ってください。（でも、Windows Live Writerの出来がいいので、結構便利に使えるかも）

• 既存のWikiページを編集するのは、それなりの覚悟で。wiki文法とはいえ元のwikiとはだいぶ違うものになると思います（おもに改行あたり）。
• BlockQuote(字下げ)には対応していません。BlockQuoteはPreタグとしてあつかいます。
• テーブルの中のテーブルとか、リストの中のテーブルとかはwikiの文法的に無理なので非対応。
• 既存のWebページを張り付ける場合も、あまり動作期待せずに。後でwikiをテキストで直すくらいのつもりで。
• PREタグを入力したい場合は、Writerの引用ボタンを押してください。
• Linkは「パイパーリンクの挿入」で挿入すると、保存時にある程度適切なTracLinkに変換します。
• 記事のタイトル欄にWikiページ名を入力してください。
• プレビューちっくな機能はありません。投稿イコールWikiの保存です。

4. インストール

4.1 必要なもの

• XML-RCPプラグイン
• Trac0.11-beta1 以上
• Windows Live Writer

とりあえず上のものは、インストールされており、動くこと。
（XML-RPCの代わりにXmlJsonRpcPluginで動くかどうかは未確認）

4.2 プラグインの入手

Subversion を使用してShibuya.tracからHTTP経由でチェックアウトしてください。 コマンドラインクライアントでは、以下のようにします。（詳しくはhttp://sourceforge.jp/projects/shibuya-trac/cvs/ 参照）

svn checkout http://svn.sourceforge.jp/svnroot/shibuya-trac/wlwriter

4.2 tracへのプラグインのインストール。

setup.pyのあるフォルダで以下のコマンドを実行し、distフォルダにできたeggファイルをTracEnvのpluginsフォルダにコピーしてください。

setup.py bdiest_egg

4.2 Windows Live Writerの設定

メニューの「ブログ」→「ブログアカウントの追加」
「その他のブログサービス」を選択し、次へ

Error: Macro Image(image_thumb_2.png) failed

Attachment 'wiki:TracDoc/WlwWikiPlugin: image_thumb_2.png' does not exist.

以下の情報を入力し、次へ。

ブログ ホームページのURL： [tracのURL]/wlwriter
ユーザ名、パスワード：tracのアカウント。wikiの表示、編集権限必要。

Error: Macro Image(image_thumb_5.png) failed

Attachment 'wiki:TracDoc/WlwWikiPlugin: image_thumb_5.png' does not exist.

以下の情報を入力し、次へ。

使用するブログの種類：Metaweblog API
ブログのリモート投稿 URL： [tracのURL]/xmlrpc

Error: Macro Image(image_thumb_7.png) failed

Attachment 'wiki:TracDoc/WlwWikiPlugin: image_thumb_7.png' does not exist.

完了。
ちなみに、ブログ構成の完了が出る前に「仮の記事を投稿し、、、」というダイアログが表示されたら、入力した設定が誤ってます。いいえを選んで、再度設定を行ってください。

Error: Macro Image(image_thumb_10.png) failed

Attachment 'wiki:TracDoc/WlwWikiPlugin: image_thumb_10.png' does not exist.

おまけ

このツールはMetablogAPIをTracに与えるものですので、これに対応したブログ編集ツールでも動く可能性があります。なお、出力するHTMLはXHTML形式にする必要があります。

たとえば、Word2007はブログに投稿できるみたいなんで、ちょっと試してみました。Live Writerとちがってテンプレートがないんで、ずいぶん見た目は変わっちゃいますね。

Error: Macro Image(image_thumb_14.png) failed

Attachment 'wiki:TracDoc/WlwWikiPlugin: image_thumb_14.png' does not exist.

Error: Macro Image(image_thumb_15.png) failed

Attachment 'wiki:TracDoc/WlwWikiPlugin: image_thumb_15.png' does not exist.