Perlドキュメント日本語訳

太田@…です。

最近はPerl をあまり使っていないので貢献できていません。すみません。

On Thu, May 29, 2008 at 12:18:16AM +0900, Youth wrote:
>
> この際一気にWikiまで敷居を下げる、というのは無しでしょうか？
> まことさんのcpan.JpがWikiですよね？

samba-jpのwebは昔CVSで管理していました。しかし、これですと
なれている人以外はものすごく敷居が高くなり、なかなか更新しづらい
ということがありました。

そこで、コンテンツを基本的に全部Wikiに移行しました。
移行の際、多くのコンテンツは手動で移動することになり、
その移行コストは高かったのですが、そのあとの管理コストは
劇的に下がりました。
サーバそのもの(とwikiのバックエンドの管理)はあるわけですが、
それはそんなに手間ではありません。

移行してもあまり意味のないもの、XMLからHTML自動生成できるもの
などはWikiに移行していませんが、その他のドキュメントはWikiに
移行して楽になったと思っています。

なお、WikiエンジンはMediawikiを使っています。Mediawikiは履歴
管理、ユーザ管理が出来るので、簡易なCVSとして見ることもできます。
そういう点からもMediawikiを採用しました。

参考になれば幸いです。

--
太田 俊哉＠NEC OSS開本 OSS推進センター OSS/LinuxソリューションG(芝.港.東京)
(samba-jp/ldap-jp Staff,mutt-j admin,analog-jp/samba-jp postmaster)

小林です。

perldoc.jpのsvn化に関連するのですが
今までperldoc.jpのドメイン＆サーバは宮川さんが管理されていましたが、
本日perldoc.jpのドメインは大沢さん（id:yappo）に委譲されました。
サーバについても大沢さんが管理するサーバに移行される予定です。

そこで、サーバを移行するにあたり、
cvsからsvn(coderepos.org)へ移行できればと思います。
# 基本的には今までどおりPOD形式での翻訳になります
# svnのcommit pingでHTMLに変換してサイトに出す形になるかと思います。

現在perldoc.jpに参加されている方で
coderepos.orgのcommit bitを持っていない方は申請してcommit bitを取得していただかなければなりません。

という感じですがどうでしょうか？

--
Atsushi Kobayashi

井上です。

Youth さんは書きました:
> この際一気にWikiまで敷居を下げる、というのは無しでしょうか？

素晴らしい。似たような提案は以前にも出ていたような気がします。
やりたい人がやるのが良いので，提案ついでにやってみませんか？

--
Kenji Inoue

岩井です。

2008/5/30 Kenji Inoue :
>> この際一気にWikiまで敷居を下げる、というのは無しでしょうか？
>
> 素晴らしい。似たような提案は以前にも出ていたような気がします。
> やりたい人がやるのが良いので，提案ついでにやってみませんか？

Wikiにしてしまうのは一長一短だと思いますけど。
PODを解さないWikiだと、翻訳時に面倒な作業が増える気がするし、
POD形式であることのメリットもあります。
# 例えば、Vine Linuxのいくつかのパッケージにはpod2manで変換
# したものが同梱されている。

また、PODを解するWikiだった場合でも、ウェブブラウザを使うのが面倒
という人もいるとは思います。


--
いわい

井上です。

2008/5/30 IWAI, Masaharu :
> Wikiにしてしまうのは一長一短だと思いますけど。
> PODを解さないWikiだと、翻訳時に面倒な作業が増える気がするし、
> POD形式であることのメリットもあります。
> # 例えば、Vine Linuxのいくつかのパッケージにはpod2manで変換
> # したものが同梱されている。

PODをWikiの中に埋め込むものだと当然のように思ってました。

> また、PODを解するWikiだった場合でも、ウェブブラウザを使うのが面倒
> という人もいるとは思います。

従来のcvsによる直接コミットも受け入れる落としどころはあろうかと。

--
Kenji Inoue

Youthです。

これを思い付いたのはずいぶん前にPod2Wikiなるもの
http://search.cpan.org/~jmcnamara/Pod-Simple-Wiki-0.05/pod2wiki
の存在を確認したときですね。
やろうと思えば作業を自動化出来るっぽい、という印象だけ持って放置してましたけ
ど。

On Fri, 30 May 2008 00:28:43 +0900 (JST)
Subject: [perldocjp:0951] Re: perldoc.jpのsvn化について
Message-Id: <483ECBA4.4000302@…>
Kenji Inoue wrote:
> 素晴らしい。似たような提案は以前にも出ていたような気がします。
> やりたい人がやるのが良いので，提案ついでにやってみませんか？
まず自分がやるのは構わないですが「どこで」と「どうやって」を決める話し合いは
必要かと。

で、質問です。
出来ればpod2wikiをプラグインとして組み込んだWikiが欲しいのですが、それは誰が
用意するのですか？

まずはPerldocの最新版からやるとして、古いバージョンのそれはどういう扱いにし
ますか？
最新版が出るたびに邦訳の出ているモジュールも同様です。
一度書いてしまえばWikiの編集履歴から差分を取るか
独立したバージョンを別ページに分割するかになると思われますが、
一番初めはどのようにしたらよいですか？

Perldoc.jpに上げられているPOD群を一個人の判断で複製すること自体には問題はな
いのですか？事後報告でOKですか？

今まで手を出さなかった言い訳が上記な訳ですが、こうなった以上やる気はあります
のでご協力をお願いします。

　白方です。

<7a8c129c0805292159we04a15dxf680a28e1371e7d1@…>の記事において
chikuwa.bushi@…さんは書きました。

>> > また、PODを解するWikiだった場合でも、ウェブブラウザを使うのが面倒
>> > という人もいるとは思います。

# はい、とても面倒です(^^;)

>> 従来のcvsによる直接コミットも受け入れる落としどころはあろうかと。

　要するに「コミット機能つきviewcvs」みたいなのがあればいいような気がします。
　PODをレンダリングしてくれればさらに良し、みたいな。

--
-------------------------------------------------------------------
「ばよえ〜ん」 白方 健太郎 --
mailto:argrath@…
http://argrath.ub32.org/

小林です。

個人的にはPODの翻訳のような長文をWikiでやるのは面倒です。

ただ、Wikiでの翻訳プロジェクトを否定するつもりはありませんし、
色々な形で参加できるのは素晴らしいとは思います。

> で、質問です。
> 出来ればpod2wikiをプラグインとして組み込んだWikiが欲しいのですが、それは誰が
> 用意するのですか？

井上さんが
> やりたい人がやるのが良いので，提案ついでにやってみませんか？

とおっしゃっているのは、
Wikiを用意する事、どういった方向性で進めていくのかの大筋を考えること
を含めてやってみては如何ですかとおっしゃっているのだと思うのですが。

ちなむとPod::Simple::WikiはKwikiのフォーマットにも対応しているようですので、
Kwikiに組み込めばいいのではないかとおもいます。

--
Atsushi Kobayashi


2008/05/30 16:12 Youth :
> Youthです。
>
> これを思い付いたのはずいぶん前にPod2Wikiなるもの
> http://search.cpan.org/~jmcnamara/Pod-Simple-Wiki-0.05/pod2wiki
> の存在を確認したときですね。
> やろうと思えば作業を自動化出来るっぽい、という印象だけ持って放置してましたけ
> ど。
>
> On Fri, 30 May 2008 00:28:43 +0900 (JST)
> Subject: [perldocjp:0951] Re: perldoc.jpのsvn化について
> Message-Id: <483ECBA4.4000302@…>
> Kenji Inoue wrote:
>> 素晴らしい。似たような提案は以前にも出ていたような気がします。
>> やりたい人がやるのが良いので，提案ついでにやってみませんか？
> まず自分がやるのは構わないですが「どこで」と「どうやって」を決める話し合いは
> 必要かと。
>
> で、質問です。
> 出来ればpod2wikiをプラグインとして組み込んだWikiが欲しいのですが、それは誰が
> 用意するのですか？
>
> まずはPerldocの最新版からやるとして、古いバージョンのそれはどういう扱いにし
> ますか？
> 最新版が出るたびに邦訳の出ているモジュールも同様です。
> 一度書いてしまえばWikiの編集履歴から差分を取るか
> 独立したバージョンを別ページに分割するかになると思われますが、
> 一番初めはどのようにしたらよいですか？
>
> Perldoc.jpに上げられているPOD群を一個人の判断で複製すること自体には問題はな
> いのですか？事後報告でOKですか？
>
> 今まで手を出さなかった言い訳が上記な訳ですが、こうなった以上やる気はあります
> のでご協力をお願いします。
>
> 【MLコミュホームページ】http://www.freeml.com/perldocjp
>
> --[PR]------------------------------------------------------------------
> 。*・°*・°*。☆・。 【JAA指定校 日本アロマコーディネータースクール】
> 一生続けれられる癒しの仕事・°└─> アロマ体感1day無料セミナー実施中
> * アロマコーディネーター * 資料請求無料 ============================
> 。*・°*・°*。☆・。*。・°* 。*・°*・°*。☆・。*。・°* 。*・°*
> http://ad.freeml.com/cgi-bin/sa.cgi?id=bTuXN
> ------------------------------------------------------------------[PR]--
> ■GMO INTERNET GROUP■ GMO INTERNET www.gmo.jp
>
>



--
Atsushi Kobayashi

岩井です。

2008/5/30 Youth :
>> 素晴らしい。似たような提案は以前にも出ていたような気がします。
>> やりたい人がやるのが良いので，提案ついでにやってみませんか？
> まず自分がやるのは構わないですが「どこで」と「どうやって」を決める話し合いは
> 必要かと。

ですね。

CVSリポジトリとの同期をどのようにするのかという問題もありますし。
方針の選択肢としては
- Wikiの編集もすべてCVSにコミットされる
- WikiとCVSリポジトリの機械的な同期は行わない
の2つになると思います。

前者は荒らしの問題があります。sf.jp側の規約の問題もあるかもしれない。
後者は、完全に独立させるのか、誰かが暇なときに手作業でコミットするのか。
独立させるならばPODを解するWikiである必要すらないかも知れませんが、
既存のものの簡単なtypoを修正してもらうとかは無理そう。

出来ればpod2wikiをプラグインとして組み込んだWikiが欲しいのですが、それは誰が
> 用意するのですか？

PodWikiというものもあるようですが、バックエンドでCVSを使えるかどうかは
知りません。
http://www.daemon.de/PodWiki
まあ、実装系を考える前に、どういう方針でいくのかを検討する必要があるかと
思います。
# 上に書いたやつね

まずはPerldocの最新版からやるとして、古いバージョンのそれはどういう扱いにし
> ますか？
> 最新版が出るたびに邦訳の出ているモジュールも同様です。
> 一度書いてしまえばWikiの編集履歴から差分を取るか
> 独立したバージョンを別ページに分割するかになると思われますが、
> 一番初めはどのようにしたらよいですか？

これも、CVSリポジトリとの連携などを先に考える必要があると思います。

Perldoc.jpに上げられているPOD群を一個人の判断で複製すること自体には問題はな
> いのですか？事後報告でOKですか？

Perlと同じライセンスのものだと、そのライセンスにしたがう範囲での利用は
可能でしょう。範囲を越える場合にどうするのかという問題はありますけど。

--
いわい