Warning: リポジトリと同期できません (サポートされていないバージョンコントロールシステム "svn です。 Python のライブラリに "svn" が正しくインストールされているか確認してください。)

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

差分発生行の前後
無視リスト:
更新日時:
2008/08/10 23:40:29 (17 年 前)
更新者:
hirobe (IP アドレス: 133.6.203.10)
コメント:

--

凡例:

変更なし
追加
削除
変更
  • TracDoc/WlwWikiPlugin

    v11 v12  
    11 
    22= Windows Live Writerと連携 - WLWriterPlugin = 
    3  
    43== 1.概要 == 
    5  
    64このプラグインは、Windows Live WriterでTracのWikiページを編集するためのプラグインです。 
    7  
    85Windows Live Writerはブログ投稿用のオフラインツールです。画像ファイルをクリップボードから張り付けることができるのが利点。このプラグインは、ぺたぺた画面キャプチャを張り付けながらwikiを作ること(手順書作るとか)が多い人向けです。 
    9  
    106ちなみに、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)]] 
    148== 2.主な機能 == 
    15  
    169=== (1) Windows Live WriterでWikiの編集 === 
    17  
    1810Windows Live WriterでWikiの編集ができるようになります。Atom Publishng Protocolというプロトコルを受信し、Wikiページとして保存します。 
    19  
    2011記事のタイトル欄にWikiページ名を入力してください。 
    21  
    2212=== (2)添付画像を一緒に保存 === 
    23  
    2413Windows Live Writerに貼り付けた画像を、添付ファイルとしてWikiページに保存します。 
    25  
    2614=== (3) Wiki文法での保存 === 
    27  
    2815Windows Live Writerが出力するの文法はHTMLですが、このプラグインはTracに保存する際にWiki文法に変換します。 
    29  
    3016なお、Wiki文法はHTMLほどの自由度はないので、Windows Live Writerで書いたものがそのまま表示されるとは限りません。できるだけ同じようなWikiに変換しますが、一致しないことはあります。 
    31  
    3217PREタグを入力したい場合は、Writerの引用ボタンを押してください。 Linkは「パイパーリンクの挿入」で挿入すると、保存時にある程度適切なTracLinkに変換します。 
    33  
     18=== (4) Wiki, Ticket, Blogの編集 === 
     19WikiとTicketとBlog(FullBlogPlugin必要)の作成と編集ができます。 
    3420== 3. 注意事項 == 
    35  
    36 このプラグインは、現在開発を進めている最中なので、おかしな挙動をするかもしれません。 
    37  
    38 === 制限事項 === 
    39  
    4021  * 手で書いたWikiページをWindows Live Writerで編集して保存すると、Wikiテキスト内の改行位置がなくなったりするとおもいます。変換する過程で、表示に関係ない改行は無視されるためです。 
    4122  * Windows Live Writerの「引用」はHTML的にはBlockQuoteなのですが、このプラグインでは整形済みテキストとして扱います。 
    4223  * テーブルの中のテーブルとか、リストの中のテーブルとかはwikiの文法的に無理。それっぽいものに変換します。 
    43   * プレビューちっくな機能はありません。投稿イコールWikiの保存です。 
    44  
    45 === 既知のバグ、あるいは作りかけ === 
    46  
    47   * 投稿の際に、画像を投稿できないといわれるかもしれません。その場合は、ブログ設定の編集から「アカウント情報の更新」を行ってください。 
    48  
     24  * プレビューちっくな機能はありません。投稿イコール保存です。 
     25  * 認証にAccountManagerPluginの機能を使います。インストールするだけでなく、管理画面のConfigurationは正しく設定しておく必要があります。 
    4926== 4. インストール == 
    50  
    5127=== 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] 
    5431  * Windows Live Writer 
    55  
    5632とりあえず上のものは、インストールされており、動くこと。 
    57  
    5833=== 4.2 プラグインの入手 === 
    59  
    6034Subversion を使用して、CodeReposからHTTP経由でチェックアウトしてください。コマンドラインクライアントでは、以下のようにします。 
    61  
    6235{{{ 
    6336svn checkout http://svn.coderepos.org/share/browser/platform/trac/plugins/wlwriter 
    6437}}} 
    65  
    6638=== 4.3 tracへのプラグインのインストール === 
    67  
    6839setup.pyのあるフォルダで以下のコマンドを実行し、distフォルダにできたeggファイルを `TracEnv` のpluginsフォルダにコピーしてください。 
    69  
    7040{{{ 
    7141setup.py bdist_egg 
    7242}}} 
    73  
    7443=== 4.4 tracへのプラグインを有効にする === 
    75  
    7644Tracの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などそれぞれの編集に関する権限も必要です。 
    9149== 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)]] 
    9552以下の情報を入力し、次へ。 
    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用の設定 === 
     58Wikiの設定とほぼ同様。ブログホームページのURLを以下の通り入力 
     59  * ブログ ホームページのURL: [tracのURL]/blogrsd/ '''ticket''' 
     60  * ユーザ名、パスワード:tracのアカウント。wikiの表示、編集権限必要。 
     61=== 5.3 Blog用の設定 === 
     62Wikiの設定とほぼ同様。ブログホームページのURLを以下の通り入力 
     63  * ブログ ホームページのURL: [tracのURL]/blogrsd/ '''blog''' 
     64  * ユーザ名、パスワード:tracのアカウント。wikiの表示、編集権限必要。 
    10965== おまけ == 
    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形式にする必要があります。