= Windows Live Writerと連携 - WLWriterPlugin =
== 1.概要 ==
このプラグインは、Windows Live WriterでTracのWikiページを編集するためのプラグインです。 Windows Live Writerはブログ投稿用のオフラインツールです。画像ファイルをクリップボードから張り付けることができるのが利点。このプラグインは、ぺたぺた画面キャプチャを張り付けながらwikiを作ること（手順書作るとか）が多い人向けです。ちなみに、TracにはそれなりのWiki文法で保存されます。

[[Image(Image8.png, link=attachment:Image7.png)]][[Image(Image10.png, link=attachment:Image9.png)]]

== 2.主な機能 ==
=== (1) Windows Live WriterでWikiの編集 ===
Windows Live WriterでWikiの編集ができるようになります。Atom Publishng Protocolというプロトコルを受信し、Wikiページとして保存します。記事のタイトル欄にWikiページ名を入力してください。

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

=== (3) Wiki文法での保存 ===
Windows Live Writerが出力するの文法はHTMLですが、このプラグインはTracに保存する際にWiki文法に変換します。なお、Wiki文法はHTMLほどの自由度はないので、Windows Live Writerで書いたものがそのまま表示されるとは限りません。できるだけ同じようなWikiに変換しますが、一致しないことはあります。 PREタグを入力したい場合は、Writerの引用ボタンを押してください。 Linkは「パイパーリンクの挿入」で挿入すると、保存時にある程度適切なTracLinkに変換します。

=== (4) Wikiの編集 ===
Wikiの作成と編集ができます。

== 3. 注意事項 ==
 * 手で書いたWikiページをWindows Live Writerで編集して保存すると、Wikiテキスト内の改行位置がなくなったりするとおもいます。変換する過程で、表示に関係ない改行は無視されるためです。([[BR]]
   の後には改行が入ります)
 * Windows Live Writerの「引用」はHTML的にはBlockQuoteなのですが、このプラグインでは整形済みテキストとして扱います。
 * テーブルの中のテーブルとか、リストの中のテーブルとかはwikiの文法的に無理。それっぽいものに変換します。
 * プレビューちっくな機能はありません。投稿イコール保存です。
AccountManagerPluginは不要になりました。Tracの基本機能としての認証を使用します。ただし、AccountManagerPluginのみで認証を行う場合は、[http://trac-hacks.org/wiki/XmlRpcPlugin XmlRpcPlugin]と同様に[http://trac-hacks.org/wiki/HttpAuthPlugin HttpAuthPlugin]が必要です。その場合は、以下のようにtrac.iniの[httpauth]に/atompub/loginを加えてください。

{{{
[httpauth]
paths = /xmlrpc, /login/xmlrpc, /atompub/login
}}}

== 4. インストール ==
=== 4.1 必要なもの ===
 * Trac0.11
 * Windows Live Writer (クライアント側)
とりあえず上のものは、インストールされており、動くこと。

（[http://trac-hacks.org/wiki/XmlRpcPlugin XmlRpcPlugin]と[http://trac-hacks.org/wiki/AccountManagerPlugin AccountManagerPlugin]は不要になりました。）

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

{{{
svn checkout http://svn.coderepos.org/share/platform/trac/plugins/wlwriter/
}}}

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

{{{
setup.py bdist_egg
}}}

=== 4.4 tracへのプラグインを有効にする ===
Tracの管理画面(WebAdmin)で、プラグインの機能を有効にしてください。

[[Image(Image4.png, link=attachment:wiki:TracDoc/WlwWikiPlugin:Image3.png)]]

=== 4.5 アカウント制御 ===
ユーザにATOM_PUB権限を与える。なお、ユーザに対してWikiなどそれぞれの編集に関する権限も必要です。[[BR]]


== 5. Windows Live Writerの設定 ==
=== 5.1 Wiki用の設定 ===
メニューの「ブログ」→「ブログアカウントの追加」[[BR]]
「その他のブログサービス」を選択し、次へ

[[Image(Image12.png, link=attachment:Image11.png)]]

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

 * ブログ ホームページのURL： [tracのURL]/atompub/'''wiki'''
 * ユーザ名、パスワード：tracのアカウント。wikiの表示、編集権限必要。
[[Image(Image14.png, link=attachment:Image13.png)]]

画像アップロード先を選択。

[[Image(Image16.png, link=attachment:Image15.png)]]

== おまけ ==
このツールはBlogエディタ用のオフライン編集インタフェースをTracに与えるものですので、これに対応したブログ編集ツールでも動く可能性があります。なお、出力するHTMLはXHTML形式である必要があります。