大前です。
次の二点について、何らかの意見をもらえるとうれしいです。
●バージョンコントロールシステムについて
どのバージョンコントロールシステムを使うかは任意とはいいましたけれど、Git
に移行するのがベストではないかと個人的には思っています。
すでに JPA では Git を使っているので、そのレポジトリからマージしてくれば
、今は HTML では見られない Moose ドキュメントの表示を担えるのではないかと
考えています。
必要な場合は git pull, git push することによって、分散レポジトリの利点も
生きてくるのではないでしょうか。
●どの wiki を使うかという問題
今ある Pod を表示する wiki は私が調べた限り全滅でしたが、ほかの人にもちゃ
んと検証してほしいと思っています。
今後の方向性として、
1.なんとかして、PodWiki か Kwiki を使う
2.その他の、Perl で書かれた wiki をカスタマイズする
3.自作する
どれが望ましいのでしょうか。また、このほかにも選択肢があれば、ぜひ教えて
ください。
--- omaeyuki@… wrote:
> 大前です。
>
> なんか私が勘違いしていたみたいで、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]------------------------------------------------------------------
> > ◇◆◇◆ 憧れの４ＬＤＫや共用施設充実マンション
> > ◇◆◇◆
> >
> ◆◇◆◇賃貸じゃ難しい?理想の住まい探しは早めの資料請求で先手!◆◇◆◇
> > ◇◆◇◆ これから販売予定のお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/
>
>
> 【MLコミュホームページ】http://www.freeml.com/perldocjp
>
> --[PR]------------------------------------------------------------------
> ◇◆◇◆ 憧れの４ＬＤＫや共用施設充実マンション
> ◇◆◇◆
> ◆◇◆◇賃貸じゃ難しい?理想の住まい探しは早めの資料請求で先手!◆◇◆◇
> ◇◆◇◆ これから販売予定のおNewなマンション、即チェック
> ◇◆◇◆
> http://ad.freeml.com/cgi-bin/sa.cgi?id=eNTs6
> ------------------------------------------------------------------[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/
読み込み中...
