大前です。
なんか私が勘違いしていたみたいで、wiki の話はこちらでいいようですね。右往
左往させてすみませんでした。
とりあえず去年までの話と、私が調査した wiki について、まとめておきます。
【去年までの話】
・wiki の更新時も Pod 形式で翻訳する
・従来の CVS による直接コミットも受け入れる
・まずは perldoc の最新版から
・CVS リポジトリとの同期は手動で行う
【PodWiki】
・デフォルトで日本語が通らない
・バックエンドが RCS
・2007年を最後に更新されていない
という難点があり、wiki としても未完成な印象を受けました。
【KWiki】
・CPAN (0.39) は古く、Subversion レポジトリが最新版
・その Kwiki2 は開発中で、ドキュメントが充実していない、URL が見つからな
いなどの問題(プラグインの書き方もよくわからない)
・Kwiki::Pages::Perldoc (Kwiki::Formatter::Pod) があり、Pod を Wiki で表
示するプラグインがデフォルトで提供されている
こんな感じでした。Pod 表示プラグインは私のローカル環境では動かすことがで
きず、ググって見つけた解決策を適用しても、解決しませんでした。
http://markmail.org/message/grfkmntidng2qqjm
具体的には、config.yaml に以下を追加しました。
formatter_class: Kwiki::Formatter::Pod
pages_class: Kwiki::Pages::Perldoc
plugins_file: plugins
また、CPAN から 0.39, 0.38 をインストールして検証してみましたが、いずれも
同じ結果でした。
【私見】
●バージョンコントロールシステムの選択
今現在使われているのは CVS, 去年検討されたのは Subversion, 今年は Git, 来
年あたりにはさらに別の何かが話題に上っているのではないでしょうか。
一方、ここで求められているのは wiki であり、翻訳対象も Pod 以外の形式が対
象になることはほとんどないと考えられます。
よって、Pod の表示・更新が行える wiki 的インターフェースを実現することが
優先で、リポジトリは交換可能にしておくべきでしょう。
また、リポジトリとの自動的な同期も、後から実装する必要があるでしょう。
●spam にどう対応するか
wiki に対する自動的 spam であれば、投稿前に整形式の Pod かどうかを検証す
ればよいと思います (podchecker)。spam ボットが Pod 形式で submit してきた
ら手に負えませんが、そうはならないことを祈ります。
また手動での spam なら、人手でも何とかなると思います。自動的な spam には
自動的に対応し、手動の spam には手動で対応すれば十分だと思います。
--- "IWAI, Masaharu" <iwaim.sub@…> wrote:
> 岩井です。
>
> 2009年11月27日20:09 <omaeyuki@…>:
> > ただ wiki に書き込むのが面倒というなら、SourceForge.jp
> のアカウントを取得
> > して、開発メンバーに加わることを ML に通知し、POD を修正して CVS
> にコミッ
> > トすることが面倒でないとは思わないでください。
>
> それは全然おもってないです。
> 私が「現状だとこうやってできるよ/こうやるとマシだよ」
> という話に突っ込まれても……というだけの話なので。
>
>
> > 具体的な方法は、金田さんの ML で議論しましょう。
>
> はい。まずはそれで。
>
> --
> いわい
>
>
> 【MLコミュホームページ】http://www.freeml.com/perldocjp
>
> --[PR]------------------------------------------------------------------
> ◇◆◇◆ 憧れの4LDKや共用施設充実マンション
> ◇◆◇◆
> ◆◇◆◇賃貸じゃ難しい?理想の住まい探しは早めの資料請求で先手!◆◇◆◇
> ◇◆◇◆ これから販売予定のおNewなマンション、即チェック
> ◇◆◇◆
> http://ad.freeml.com/cgi-bin/sa.cgi?id=eMYJI
> ------------------------------------------------------------------[PR]--
> ■GMO INTERNET GROUP■ GMO INTERNET www.gmo.jp
>
>
--------------------------------------
Learn more about HIV/AIDS - Red Ribbon Campaign 2009
http://pr.mail.yahoo.co.jp/redribbon/