= Windows Live Writerと連携 - WLWriterPlugin =

== 1.概要 ==

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

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

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

[[Image(image_thumb[3].png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image[5].png)]]

== 2.主な機能 ==

=== (1) Windows Live WriterでWikiの編集 ===

Windows Live WriterでWikiの編集ができるようになります。Atom Publishng Protocolというプロトコルを受信し、Wikiページとして保存します。

=== (2)添付画像を一緒に保存 ===

Windows Live Writerに貼り付けた画像を、添付ファイルとしてWikiページに保存します。

=== (2) Wiki文法での保存 ===

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

なお、Wiki文法はHTMLほどの自由度はないので、Windows Live Writerで書いたものがそのまま表示されるとは限りません。できるだけ同じようなWikiに変換しますが、一致しないことはあります。

== 3.注意事項 ==

このプラグインは、現在開発を進めている最中なので、おかしな挙動をするかもしれません。

  * 手で書いたWikiページをWindows Live Writerで編集して保存すると、Wikiテキスト内の改行位置がなくなったりするとおもいます。変換する過程で、表示に関係ない改行は無視されるためです。
  * Windows Live Writerの「引用」はHTML的にはBlockQuoteなのですが、このプラグインでは整形済みテキストとして扱います。
  * テーブルの中のテーブルとか、リストの中のテーブルとかはwikiの文法的に無理。それっぽいものに変換します。
  * PREタグを入力したい場合は、Writerの引用ボタンを押してください。 Linkは「パイパーリンクの挿入」で挿入すると、保存時にある程度適切なTracLinkに変換します。
  * 記事のタイトル欄にWikiページ名を入力してください。
  * プレビューちっくな機能はありません。投稿イコールWikiの保存です。

== 4. インストール ==

=== 4.1 必要なもの ===

  * Trac0.11-beta1 ～Trac0.11rc1
  * Windows Live Writer

とりあえず上のものは、インストールされており、動くこと。

=== 4.2 プラグインの入手 ===

Subversion を使用して、CodeReposからHTTP経由でチェックアウトしてください。コマンドラインクライアントでは、以下のようにします。

{{{
svn checkout http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/wlwriterplugin
}}}

=== 4.3 tracへのプラグインのインストール ===

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

{{{
setup.py bdist_egg
}}}


=== 4.4 tracへのプラグインを有効にする ===

TracのAdminタブで、プラグインの機能を有効にしてください。

[[Image(image_thumb[4].png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image[8].png)]]

=== 4.5 アカウント制御 (1) ===



=== 4.2 Windows Live Writerの設定 ===

メニューの「ブログ」→「ブログアカウントの追加」[[BR]]「その他のブログサービス」を選択し、次へ[[BR]] [[Image(image_thumb_2.png)]]

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

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

[[Image(image_thumb_5.png)]]

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

使用するブログの種類：Metaweblog API[[BR]]ブログのリモート投稿 URL： [tracのURL]/xmlrpc[[BR]][[BR]] [[Image(image_thumb_7.png)]]

完了。[[BR]]ちなみに、ブログ構成の完了が出る前に「仮の記事を投稿し、、、」というダイアログが表示される場合は、そのまま「はい」を選んでも「失敗しました」と表示されますが、そのままいったん登録を完了してください。その後、ブログの設定ダイアログの「編集」メニューから「デザインの更新」ボタンを押して再度同じ操作を行うとうまくいく可能性があります。

[[Image(image_thumb_10.png)]]

== 5. ご意見・ご要望 ==

ご意見・ご要望は以下から登録してください。

  * Trac0.11-xxをお使いの方は [trac:newticket?component=WLWriterPlugin&version=Trac0.11 こちら]

これまでに登録されたものは [http://weekbuild.sakura.ne.jp/trac011a.cgi/query?component=WLWriterPlugin こちら] を参照してください。

== おまけ ==

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

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

[[Image(image_thumb_14.png)]] [[Image(image_thumb_15.png)]]