## 訳注：このドキュメントは、writebackプラグインのreadmeを一部翻訳したものです。
## readmeは、writebackプラグイン中にスクリプトの一部として記述されています。
## blosxom start kitを使っている場合、ここに登場する設定値のいくつかはconfig.cgiで設定します(多分)。

NAME

Blosxom Plug-in: writeback

概要

コメントとトラックバックによるWriteBack機能を提供する。 [http://www.movabletype.org/trackback/].

エントリー中のすべてのコメントとTruckBack pingsは、$writeback_dir/$path/$filename.cmt に保存される。

クイックスタート

writeback Pluginのファイルをプラグインディレクトリにコピーする。(これは、blosxom.cgiの$plugin_dirで指定している)。

Writebackの情報は、$writeback_dirに保存される。

blosxomの$datadirで同じディレクトリを使っているなら(WriteBackは、このパスのweblog_entry_name.wbに保存される)、たぶん分けておくと良いだろう。

設定が終わったら、あなたのサイトにアクセスすると、WriteBackプラグインは、いくつかのチェックを行ってみて必要な情報がなければ、$writeback_dirを作成して、そこに情報を保存する(背後で何が起きているか知りたければ、error_logで詳細がわかる）。

この配布ファイルに含まれるflavourファイルは、blosxomのデータディレクトリ（$datadir)にコピーする。フォルダごとコピーするのではなく、ファイルだけをコピーすること。もしも、手元にサンプルflavourファイルがなければ、次からダウンロードできる。

http://www.raelity.org/apps/blosxom/downloads/plugins/writeback.zip

あとはブラウザで、エントリーのWriteBack flavourにアクセスする。
(e.g. http://localhost/cgi-bin/blosxom.cgi/path/to/a/post.writeback)
##訳注：path-to-aというカテゴリにあるpostエントリにコメントを付ける。

Enjoy!

FLAVOUR テンプレートの設定

flavourテンプレートにエントリーのWriteBackを表示したい場合は、$writeback::writebacksを使う。

コメント数を表示したい場合は、$writeback::countを使う

もしも「コメントありがとう」とか「There was a problem posting your writeback」と言ったメッセージをコメントを投稿した後に表示するには、$writeback::writeback_responseを付ける.

サンプルFLAVOURテンプレート

あなたの学習を手助けするよう、サンプルFLAVOUR テンプレートを用意してある。次のHTMLファイルを参照して欲しい。

• story.writeback、基本的なシングルエントリのstory flavourにWriteBack機能を追加したもの。デフォルトのflavourとしては使わないで、現在使っているflavourを修正した方がいい。
• foot.writeback、コメントを追記するフォームを表示する。
  NOTE: wikieditish plug-inには、valueに"wikieditish"をセットした、pluginフォームが必要になる。これは、ほかのプラグインからデータを送信(POSTing)するときのハンドルになる。
• writeback.writeback、WriteBack自身のサンプルflavour。WriteBackを表示するときの参考に

FLAVOURING WRITEBACKS

デフォルトでもまあまあ動作するが、もっと使いやすくするには、writeback flavourファイル(e.g. writeback.writeback)にあるような、次の設定値を追加する。

• $writeback::name$writeback::blog_name、コメントに名前を追加する。TrackBack pingにblog名を追加する
• $writeback::url、コメントかTrackback pingにURLを追加する
• $writeback::title、コメントかTrackback pingにタイトルを追加する。
• $writeback::comment$writeback::excerpt、コメントかTrackBack Pingの内容を追加する。
• $writeback::pref_name and $writeback::pref_url are prepopulated with the values of the form you just submitted or preferences stored in a 'writeback' cookie, if you've the cookie plug-in installed an enabled.

TRACKBACKSを付けてもらう／サポートする

あなたが、各ストーリーにTrackBack ping URLを提供したいなら、$writeback::trackback_path_and_filenameをflavour中に記述しておく。

e.g. $url$writeback::trackback_path_and_filename.trackback

The writeback plugin provides an XML response to TrackBack pings in the form of a baked-in trackback flavour. If you alter the value of $trackback_flavour (why would you?), you'll have to create a set of flavour templates by hand; all should be blank save the content_type (text/xml) and head ($writeback::trackback_response).

インストール

plug-inディレクトリに、writebackファイルをコピーする ($blosxom::plugin_dir)

設定

(必須) SPECIFYING A WRITEBACK DIRECTORY

Writeback, being a well-behaved plug-in, won't do anything until you set $writeback_dir, create the directory, and make it write-able by Blosxom.

Create a directory to save WriteBacks to (e.g. $plugin_state_dir/writeback), and set $writeback_dir to the path to that directory.

While you can use the same directory as your blosxom $datadir (WriteBacks are saved as path/weblog_entry_name.wb), it's probably better to keep them separate.

The writeback plug-in will create the appropriate paths to mimick your $datadir hierarchy on-the-fly. So, for a weblog entry in $datadir/some/path/or/other/entry.txt, WriteBacks will be kept in $writeback_dir/some/path/or/other/entry.wb.

(オプション) ALTERING THE TRACKBACK FLAVOUR

The $trackback_flavour sets the flavour the plug-in associates with incoming TrackBack pings. Unless this corresponds to the flavour associated with your trackback URL, the writeback plug-in will ignore incoming pings.

(オプション) SPECIFYING AN EXTENSION FOR WRITEBACK FILES

The default extension for WriteBacks is wb. You can change this if you wish by altering the $file_extension value.

(オプション) SPECIFYING WHAT FIELDS YOU EXPECT IN YOUR COMMENTS FORM

The defaults are probably ok here, but you can specify that the writeback plug-in should look for more fields in your comments form by adding to this list. You should keep at least the defaults in place so as not to break anything.

my @fields = qw! name url title comment excerpt blog_name !;

VERSION

2003-09-18

AUTHOR

Rael Dornfest , http://www.raelity.org/

その他

Blosxom Home/Docs/Licensing: http://www.raelity.org/apps/blosxom/

Blosxom Plugin Docs: http://www.raelity.org/apps/blosxom/plugin.shtml

バグ

Address bug reports and comments to the Blosxom mailing list [http://www.yahoogroups.com/group/blosxom].

LICENSE

Blosxom and this Blosxom Plug-in

Copyright 2003, Rael Dornfest

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.