バージョン 16 から バージョン 17 における更新: TracDoc/WlwWikiPlugin

更新日時:

2008/12/15 21:55:28 (16 年 前)

更新者:

hirobe (IP アドレス: 133.6.203.10)

コメント:

--

TracDoc/WlwWikiPlugin

@@ -1 @@
-
 = Windows Live Writerと連携 - WLWriterPlugin =
 == 1.概要 ==
-このプラグインは、Windows Live WriterでTracのWikiページを編集するためのプラグインです。
-Windows Live Writerはブログ投稿用のオフラインツールです。画像ファイルをクリップボードから張り付けることができるのが利点。このプラグインは、ぺたぺた画面キャプチャを張り付けながらwikiを作ること（手順書作るとか）が多い人向けです。
-ちなみに、TracにはそれなりのWiki文法で保存されます。
+このプラグインは、Windows Live WriterでTracのWikiページを編集するためのプラグインです。 Windows Live Writerはブログ投稿用のオフラインツールです。画像ファイルをクリップボードから張り付けることができるのが利点。このプラグインは、ぺたぺた画面キャプチャを張り付けながらwikiを作ること（手順書作るとか）が多い人向けです。ちなみに、TracにはそれなりのWiki文法で保存されます。
 
-[[Image(image_thumb[3].png)]] [[Image(image_12.png)]] [[Image(image_11.2.png)]]
+[[Image(image_thumb[3].png)]][[Image(image_12.png)]][[Image(image_11.2.png)]]
+
 == 2.主な機能 ==
 === (1) Windows Live WriterでWikiの編集 ===
-Windows Live WriterでWikiの編集ができるようになります。Atom Publishng Protocolというプロトコルを受信し、Wikiページとして保存します。
-記事のタイトル欄に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, Ticket, Blogの編集 ===
-WikiとTicketとBlog(FullBlogPlugin必要)の作成と編集ができます。
+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テキスト内の改行位置がなくなったりするとおもいます。変換する過程で、表示に関係ない改行は無視されるためです。
-  * Windows Live Writerの「引用」はHTML的にはBlockQuoteなのですが、このプラグインでは整形済みテキストとして扱います。
-  * テーブルの中のテーブルとか、リストの中のテーブルとかはwikiの文法的に無理。それっぽいものに変換します。
-  * プレビューちっくな機能はありません。投稿イコール保存です。
-  * 認証にAccountManagerPluginの機能を使います。インストールするだけでなく、管理画面のConfigurationは正しく設定しておく必要があります。
+ * 手で書いた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
-  * [http://trac-hacks.org/wiki/XmlRpcPlugin XmlRpcPlugin]
-  * [http://trac-hacks.org/wiki/AccountManagerPlugin AccountManagerPlugin]
-  * Windows Live Writer
+ * 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のあるフォルダで以下のコマンドを実行し、distフォルダにできたeggファイルを`TracEnv`のpluginsフォルダにコピーしてください。
+
 {{{
 setup.py bdist_egg
 }}}
+
 === 4.4 tracへのプラグインを有効にする ===
-TracのAdminタブで、プラグインの機能を有効にしてください。
+Tracの管理画面(WebAdmin)で、プラグインの機能を有効にしてください。
 
-[[Image(image[8].png)]]
+[[Image(Image4.png, link=attachment:Image3.png)]]
+
 === 4.5 アカウント制御 ===
-ユーザにXML_RPC権限を与える。
-なお、Wikiなどそれぞれの編集に関する権限も必要です。
+ユーザにATOM_PUB権限を与える。なお、ユーザに対してWikiなどそれぞれの編集に関する権限も必要です。[[BR]]
+
+
 == 5. Windows Live Writerの設定 ==
 === 5.1 Wiki用の設定 ===
-メニューの「ブログ」→「ブログアカウントの追加」[[BR]]「その他のブログサービス」を選択し、次へ[[BR]] [[Image(image_thumb.png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image_2.png)]]
+メニューの「ブログ」→「ブログアカウントの追加」[[BR]]
+「その他のブログサービス」を選択し、次へ[[BR]]
+[[Image(image_thumb.png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image_2.png)]]
+
 以下の情報を入力し、次へ。(画像ではURLがblogrsdとなってますが、正しくはwlwriterです）
-  * ブログ ホームページのURL： [tracのURL]/wlwriter/'''wiki'''
-  * ユーザ名、パスワード：tracのアカウント。wikiの表示、編集権限必要。
-[[Image(image_thumb_1.png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image_4.png)]]
-完了。
-=== 5.2 Ticket用の設定 ===
-Wikiの設定とほぼ同様。ブログホームページのURLを以下の通り入力
-  * ブログ ホームページのURL： [tracのURL]/wlwriter/'''ticket'''
-  * ユーザ名、パスワード：tracのアカウント。wikiの表示、編集権限必要。
-=== 5.3 Blog用の設定 ===
-Wikiの設定とほぼ同様。ブログホームページのURLを以下の通り入力
-  * ブログ ホームページのURL： [tracのURL]/wlwriter/'''blog'''
-  * ユーザ名、パスワード：tracのアカウント。wikiの表示、編集権限必要。
+
+ * ブログ ホームページのURL： [tracのURL]/atompub/'''wiki'''
+ * ユーザ名、パスワード：tracのアカウント。wikiの表示、編集権限必要。[[BR]]
+   (注意：WindowsLiveWriterの設定の際、'''anonymous'''にWIKI_VIEWの権限が必要です。[[BR]]
+   一度設定が済めば、anonymousに対してはWIKI_VIEWの権限は不要となります。)
+[[Image(Image6.png, link=attachment:Image5.png)]]
+
+
+
 == おまけ ==
 このツールはBlogエディタ用のオフライン編集インタフェースをTracに与えるものですので、これに対応したブログ編集ツールでも動く可能性があります。なお、出力するHTMLはXHTML形式にする必要があります。