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形式にする必要があります。 |