Warning: リポジトリと同期できません (サポートされていないバージョンコントロールシステム "svn です。 Python のライブラリに "svn" が正しくインストールされているか確認してください。)
- 更新日時:
-
2008/08/10 23:40:29 (17 年 前)
- 更新者:
-
hirobe (IP アドレス: 133.6.203.10)
- コメント:
-
--
-
|
v11
|
v12
|
|
| 1 | 1 | |
| 2 | 2 | = Windows Live Writerと連携 - WLWriterPlugin = |
| 3 | | |
| 4 | 3 | == 1.概要 == |
| 5 | | |
| 6 | 4 | このプラグインは、Windows Live WriterでTracのWikiページを編集するためのプラグインです。 |
| 7 | | |
| 8 | 5 | Windows Live Writerはブログ投稿用のオフラインツールです。画像ファイルをクリップボードから張り付けることができるのが利点。このプラグインは、ぺたぺた画面キャプチャを張り付けながらwikiを作ること(手順書作るとか)が多い人向けです。 |
| 9 | | |
| 10 | 6 | ちなみに、TracにはそれなりのWiki文法で保存されます。 |
| 11 | | |
| 12 | | [[Image(image_thumb[3].png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image%5B5%5D.png)]] |
| 13 | | |
| | 7 | [[Image(http://weekbuild.sakura.ne.jp/trac/raw-attachment/wiki/TracDoc/WlwWikiPlugin/image_thumb%5B3%5D.png)]] [[Image(image_12.png)]] [[Image(image_11.png)]] |
| 14 | 8 | == 2.主な機能 == |
| 15 | | |
| 16 | 9 | === (1) Windows Live WriterでWikiの編集 === |
| 17 | | |
| 18 | 10 | Windows Live WriterでWikiの編集ができるようになります。Atom Publishng Protocolというプロトコルを受信し、Wikiページとして保存します。 |
| 19 | | |
| 20 | 11 | 記事のタイトル欄にWikiページ名を入力してください。 |
| 21 | | |
| 22 | 12 | === (2)添付画像を一緒に保存 === |
| 23 | | |
| 24 | 13 | Windows Live Writerに貼り付けた画像を、添付ファイルとしてWikiページに保存します。 |
| 25 | | |
| 26 | 14 | === (3) Wiki文法での保存 === |
| 27 | | |
| 28 | 15 | Windows Live Writerが出力するの文法はHTMLですが、このプラグインはTracに保存する際にWiki文法に変換します。 |
| 29 | | |
| 30 | 16 | なお、Wiki文法はHTMLほどの自由度はないので、Windows Live Writerで書いたものがそのまま表示されるとは限りません。できるだけ同じようなWikiに変換しますが、一致しないことはあります。 |
| 31 | | |
| 32 | 17 | PREタグを入力したい場合は、Writerの引用ボタンを押してください。 Linkは「パイパーリンクの挿入」で挿入すると、保存時にある程度適切なTracLinkに変換します。 |
| 33 | | |
| | 18 | === (4) Wiki, Ticket, Blogの編集 === |
| | 19 | WikiとTicketとBlog(FullBlogPlugin必要)の作成と編集ができます。 |
| 34 | 20 | == 3. 注意事項 == |
| 35 | | |
| 36 | | このプラグインは、現在開発を進めている最中なので、おかしな挙動をするかもしれません。 |
| 37 | | |
| 38 | | === 制限事項 === |
| 39 | | |
| 40 | 21 | * 手で書いたWikiページをWindows Live Writerで編集して保存すると、Wikiテキスト内の改行位置がなくなったりするとおもいます。変換する過程で、表示に関係ない改行は無視されるためです。 |
| 41 | 22 | * Windows Live Writerの「引用」はHTML的にはBlockQuoteなのですが、このプラグインでは整形済みテキストとして扱います。 |
| 42 | 23 | * テーブルの中のテーブルとか、リストの中のテーブルとかはwikiの文法的に無理。それっぽいものに変換します。 |
| 43 | | * プレビューちっくな機能はありません。投稿イコールWikiの保存です。 |
| 44 | | |
| 45 | | === 既知のバグ、あるいは作りかけ === |
| 46 | | |
| 47 | | * 投稿の際に、画像を投稿できないといわれるかもしれません。その場合は、ブログ設定の編集から「アカウント情報の更新」を行ってください。 |
| 48 | | |
| | 24 | * プレビューちっくな機能はありません。投稿イコール保存です。 |
| | 25 | * 認証にAccountManagerPluginの機能を使います。インストールするだけでなく、管理画面のConfigurationは正しく設定しておく必要があります。 |
| 49 | 26 | == 4. インストール == |
| 50 | | |
| 51 | 27 | === 4.1 必要なもの === |
| 52 | | |
| 53 | | * Trac0.11-beta1 ~Trac0.11rc1 |
| | 28 | * Trac0.11 |
| | 29 | * [http://trac-hacks.org/wiki/XmlRpcPlugin XmlRpcPlugin] |
| | 30 | * [http://trac-hacks.org/wiki/AccountManagerPlugin AccountManagerPlugin] |
| 54 | 31 | * Windows Live Writer |
| 55 | | |
| 56 | 32 | とりあえず上のものは、インストールされており、動くこと。 |
| 57 | | |
| 58 | 33 | === 4.2 プラグインの入手 === |
| 59 | | |
| 60 | 34 | Subversion を使用して、CodeReposからHTTP経由でチェックアウトしてください。コマンドラインクライアントでは、以下のようにします。 |
| 61 | | |
| 62 | 35 | {{{ |
| 63 | 36 | svn checkout http://svn.coderepos.org/share/browser/platform/trac/plugins/wlwriter |
| 64 | 37 | }}} |
| 65 | | |
| 66 | 38 | === 4.3 tracへのプラグインのインストール === |
| 67 | | |
| 68 | 39 | setup.pyのあるフォルダで以下のコマンドを実行し、distフォルダにできたeggファイルを `TracEnv` のpluginsフォルダにコピーしてください。 |
| 69 | | |
| 70 | 40 | {{{ |
| 71 | 41 | setup.py bdist_egg |
| 72 | 42 | }}} |
| 73 | | |
| 74 | 43 | === 4.4 tracへのプラグインを有効にする === |
| 75 | | |
| 76 | 44 | TracのAdminタブで、プラグインの機能を有効にしてください。 |
| 77 | | |
| 78 | | [[Image(image_thumb[4].png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image%5B8%5D.png)]] |
| 79 | | |
| 80 | | === 4.5 アカウント制御 (1) === |
| 81 | | |
| 82 | | ユーザにATOM_PUB権限を与える。 |
| 83 | | |
| 84 | | なお、Wikiの編集に関する権限も必要です。 |
| 85 | | |
| 86 | | === 4.6 アカウント制御 (2) === |
| 87 | | |
| 88 | | apacheの設定で、サイトURL/atompub/loginというLocationに認証を走らせるように設定する。これしないとユーザはanonymousと判断されちゃいます。 |
| 89 | | |
| 90 | | |
| | 45 | [[Image(http://weekbuild.sakura.ne.jp/trac/raw-attachment/wiki/TracDoc/WlwWikiPlugin/image_thumb%5B4%5D.png)]] |
| | 46 | === 4.5 アカウント制御 === |
| | 47 | ユーザにXML_RPC権限を与える。 |
| | 48 | なお、Wikiなどそれぞれの編集に関する権限も必要です。 |
| 91 | 49 | == 5. Windows Live Writerの設定 == |
| 92 | | |
| 93 | | メニューの「ブログ」→「ブログアカウントの追加」[[BR]]「その他のブログサービス」を選択し、次へ[[BR]] [[Image(image_thumb[4].png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image[10].png)]] |
| 94 | | |
| | 50 | === 5.1 Wiki用の設定 === |
| | 51 | メニューの「ブログ」→「ブログアカウントの追加」[[BR]]「その他のブログサービス」を選択し、次へ[[BR]] [[Image(image_thumb.png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image_2.png)]] |
| 95 | 52 | 以下の情報を入力し、次へ。 |
| 96 | | |
| 97 | | ブログ ホームページのURL: [tracのURL][[BR]]ユーザ名、パスワード:tracのアカウント。wikiの表示、編集権限必要。 |
| 98 | | |
| 99 | | [[Image(image_thumb[2].png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image[6].png)]] |
| 100 | | |
| 101 | | ブログとしてWikiを選択する。(Tikcetはまだ動きません) |
| 102 | | |
| 103 | | [[Image(image_thumb[11].png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image%5B21%5D.png)]] [[BR]][[BR]] |
| 104 | | |
| 105 | | この後、画像ファイルのアップロード先を聞かれるが、同じものを選択すること。 |
| 106 | | |
| 107 | | 完了。[[BR]] |
| 108 | | |
| | 53 | * ブログ ホームページのURL: [tracのURL]/blogrsd/ '''wiki''' |
| | 54 | * ユーザ名、パスワード:tracのアカウント。wikiの表示、編集権限必要。 |
| | 55 | [[Image(image_thumb_1.png, link=attachment:wiki:TracDoc/WlwWikiPlugin:image_4.png)]] |
| | 56 | 完了。 |
| | 57 | === 5.2 Ticket用の設定 === |
| | 58 | Wikiの設定とほぼ同様。ブログホームページのURLを以下の通り入力 |
| | 59 | * ブログ ホームページのURL: [tracのURL]/blogrsd/ '''ticket''' |
| | 60 | * ユーザ名、パスワード:tracのアカウント。wikiの表示、編集権限必要。 |
| | 61 | === 5.3 Blog用の設定 === |
| | 62 | Wikiの設定とほぼ同様。ブログホームページのURLを以下の通り入力 |
| | 63 | * ブログ ホームページのURL: [tracのURL]/blogrsd/ '''blog''' |
| | 64 | * ユーザ名、パスワード:tracのアカウント。wikiの表示、編集権限必要。 |
| 109 | 65 | == おまけ == |
| 110 | | |
| 111 | | このツールはAtom Publising ProtocolをTracに与えるものですので、これに対応したブログ編集ツールでも動く可能性があります。なお、出力するHTMLはXHTML形式にする必要があります。 |
| 112 | | |
| 113 | | たとえば、Word2007はブログに投稿できるみたいなんで、ちょっと試してみました。Live Writerとちがってテンプレートがないんで、ずいぶん見た目は変わっちゃいますね。 |
| 114 | | |
| 115 | | [[Image(image_thumb_14.png)]] [[Image(image_thumb_15.png)]] |
| | 66 | このツールはBlogエディタ用のオフライン編集インタフェースをTracに与えるものですので、これに対応したブログ編集ツールでも動く可能性があります。なお、出力するHTMLはXHTML形式にする必要があります。 |