Perlの日本語ドキュメントポータルは速やかに刷新すべき

と思いこんなものを作ってみました。α版なので細かいツッコミは歓迎ですがメール(canadie at gmail)かブクマコメントにて寛容にお願いします。当然気づいているバグも多数あるのですが、ケツを叩かれるとのそのそ動くのが私の習性なので。デザインの著作権を侵していますが、勝手な都合でsearch.cpan.orgの方から警告があるまではこのままにします。
断言します。日本のPerlコミュニティには、このような、新しい形の日本語Perlドキュメントポータルが絶対に必要です。そのためのリソースは、今の状況では量的にも質的にも不十分です
誰もやらないので私がやります。賛同者・協力者の参加を募集しています。
グループ http://groups.google.co.jp/group/new_perldocjp ML mailto:new_perldocjp@googlegroups.com
グループは参加無制限です。グループに参加すると自動的にMLに加えられます。グループはいいけどMLはやだという場合はMLメンバの手動管理も検討します。
質的、というのは訳がダメとかじゃなくて、メタ情報の少なさによるところです。例えばperldoc.jpにドキュメントごとにXMLがあるのは知っていますがその上で言っています。それでも足りない分を補うため、スクレイプには随分と時間を要しましたし例外が多かったです(これはperldoc.jpの中の人も同意してくれました)。
なお、これは、しばらくは動くようにしておきます(なるべく・1ヶ月くらい?)。その後状況をみてなるべく当社とは関係ない(最終的には全く関係ない)ドメインでどこかに移転します。それ以降にデッドリンクになっているのを見つけた方は、canadie at gmail まで一言頂けると助かります(他力リマインダ)。
なお動いているのは弱小サーバーでしかも多段Proxyを組んでいるので過負荷の可能性があります。その時はごめんなさい。
今日は、このスクリプトを作ったいきさつを説明します。というか、説明するまでもなく、こういうサイトがあったら便利だと思いませんか?欲しいと思いませんか?必要だと思いませんか?
では話します。miyagawaさんはじめ関連している方でこれを読んでおられる方。 僕は話を良く覚えていない方なのと例のログを飛ばしてしまったのと、基本的に天然が入っているバカなので、突っ込みどころとか勘違いとかあったら言ってください。
日本におけるスクリプト言語の普及率というのは、日本語ドキュメントの量と質によるところがあると僕は主張しています。日本人のリテラシーはエンジニアと言えどもまだそれほど高くありません。
昨今日本ではPHPの需要が大きく(BtoC/Webサイト用スクリプトとしてのシェアを主観で見てですよ)感じるのですが、反面Rubyの伸びが予想に反していまいちなのは、RubyはPHPのそれに比べて必ずしもドキュメントの量が充分とは言えないからだと思っています。逆にPHPの普及は、PHPの日本語ドキュメントの充実が大きく寄与していると覆います。急にシェアを伸ばしたMySQLも、対抗馬のPostgreSQLに負けじと詳細なドキュメントを用意してきましたよね。そして私は赤らくだ本の和訳が出版された時の、急速なPerlの普及をよく覚えています。
ここで大きく水をあけられているのがPerlだと思っています。管理している方も事情もIRCで知り聞いているので、ケチをつけるつもりは全くないのですが、Perlの日本語マニュアル類で最も充実しているのが、以下のperldoc.jpです。検索はついてますが独自のものではありませんし、階層のブラウズは昔のApacheのデフォルトかそれに近いものです。
そんなわけで、ここのドキュメントを勝手にチェックアウトし、メタデータを無理やりスクレイプし、Perl文化が誇るsearch.cpan.orgと同じインターフェイスの日本語版を作ってみたのが上記のものです。現在perldoc.jp中のものしかありませんし、コアモジュールは検索できませんが、将来的にはこれらrのサポート、JPAのMoose関連や、Coro関連で独自に訳している方などのサイトとも連動し、全て検索可能にする予定です。著者ユーザー名が*unknown*だとエラーになるとかバグがあるのでとりあえず”YAML”とか検索してみて下さい。
Perlは今伸びていると思います。私は言語の優劣のことを言うのを嫌います。しかし今、日々新芽の芽吹くがごとく進歩している古参の言語のはPerlだけのように感じます。これは要求仕様の複雑化によるモジュール利用の重要性が高まってきたこと(Perlはそれを充分に提供していること)、C10K問題が顕在化し、負荷のあるプロダクトは使えなくなってきたこと(PHPとかが負荷があると言っているのではなく、Perlは負荷を減らしやすいと考えています)などが考えられます。
既に米国ではPHPを抑え、Perlの需要が上回っているとも聞きます(Javaには負けてます)。ここで日本語ドキュメントとそのブラウズを充実させれば、日本のPerl文化はもっと充実したものになるのではないでしょうか。
私は売名しようとか、儲けようとか考えているんじゃありません。お金には困っていますが。私はPerlとその文化を真剣に愛しているのです。どんな形でもアフィリエイトはしないか、あるとして、100%サーバや回線にかかる費用に還元します。残りは寄付します。開発に還元するとか寝言はいいません。僕が面倒なことをして欲しいんじゃありません。賛同・助言・諫言や私にどうしてもできないことに協力して欲しいのです。
さて、perldocはドキュメントは充実しているのですが(コアモジュールについてはほぼ完全に網羅)、デザイン性・操作性に乏しく(これは歴史的理由によるもので仕方のないことです)、読みにくい(デフォルトの設定だと文字が小さすぎるブラウザが多い)ため、検索で見つかったものを読んだ人は多いでしょうが、ポータル的な働きはしていません。
JPAの方はYAPC::Asiaを開催するなど精力的な活動を行っていますが、日本語ドキュメントの方はMooseで止まっています(ただ、運営開始直後にMooseのドキュメントをここまで訳したのは賞賛、いや驚嘆に値します)。
まず、同じことをしようとしているコミュニティが2つあるのが良くないですね。で、perldocの方は入会してみたのですが、「管理人の承認待ちです」というのが半月以上続き放置プレイを食らっています。当然コミッタ権限もなしです(ML経由でもらえます)。perldocjpはコミュニティとしては既に機能不全に陥っていると感じました。コミュニティ最後の会合は2003年です。ドキュメントは、精力的な既に会員のコミッタの熱意で維持しているのではないかと推測します([ログ http://www.freeml.com/perldocjp/topics]を見てもそんな感じです)。ということで、ここでは具体的な提言はできませんでした。
Hippo2000氏とJPAにはまだ連絡取ってません(早く取れ>俺)。perldocjpには立ち直って欲しいと願っています(今のままがいいんだと言われるかも知れませんが)。
とにかく感じたのは、この2つのドキュメント群は統合しなきゃいけないんじゃないかというのと、機能停止しているように見えるperldoc.jpを再建するか、僕が新しく3つ目を建てるしかないんじゃないかと言うことです。しかし私はこの2つの資源を必要としていますし、2つはどちらに統合するかとかではなく、両者が共有する形が良いと思っていますが答えは簡単ではないでしょうね。あと僕はしかるべきところにとっとと連絡を取るべきでしょうね。
Perl日本語ドキュメントポータルを作るためには、2つのことが考えられます。
- どこか(JPAなど)にこのスクリプトと運営を任せる
- ドキュメントの調達はなんとかするとして、自費で別ドメインで運営する
なお政治的な理由からほぼ確実に後者になるんじゃないかと思いますし、IRCの方々からも後者の方が良いのではという助言を頂きました。スクリプトは恥ずかしくてまだ見せられませんが、gitHubなどに公開して共同開発することも視野に入れています。Catalyst5.80007を使っています。いずれにせよ、何らかの形でFreeにする予定です。
私はどうしてもsearch.cpan.orgの日本語版があった方が日本のPerl文化はもっと栄えると考えてます。私の考えは間違っているでしょうか?傲慢でしょうか?無意味でしょうか?不必要でしょうか?方向性が違うでしょうか?私は元々一人で何でもやっちゃう性質なのでこういうのはものすごく苦手なのですが、今本当にみなさんの力を必要としています。Perl文化を少しでも良くするための、あらゆる形での助言・援助を求めます。助言の求め方の助言が欲しいくらいです。
どうか、みなさんお力添えください。宜しくお願いします。各方面の方々の協力が必要だと思っています。私はIRCにはあまりいませんし、使い方も稚拙なので行き違いが多いですが、GTalkはオンライン率が高いです。繰り返しになりますがcanadieです。IRCではcanadaのことが多いです。今日24日は日本時間で21:30〜22:00頃にfreenode#shibuya.pmに入ります。12時ぐらいまではいます。
(*)ちなみにナメ猫の旗と全く同一デザインのロゴは僕がデザイン苦手なので許してください。これでも色味を調整して右翼っぽさを消そうと努力したんです。サイト名が固まったら誰か手伝って欲しいです。
2011/12/10 - 19:55:45 -
Websites you should visit
[…]below you’ll find the link to some sites that we think you should visit[…]…
2011/12/11 - 00:58:05 -
Recent Blogroll Additions…
[…]usually posts some very interesting stuff like this. If you’re new to this site[…]…
2011/12/11 - 02:16:06 -
Vegas SEO
[…]that may be the finish of this article. Here you will uncover some web-sites that we consider you will enjoy, just click the hyperlinks over[…]
2011/12/11 - 06:13:55 -
Sites we Like…
[…] Every once in a while we choose blogs that we read. Listed below are the latest sites that we choose […]…
2011/12/11 - 07:09:49 -
Sites we Like…
[…] Every once in a while we choose blogs that we read. Listed below are the latest sites that we choose […]…
2011/12/11 - 07:15:53 -
Superb website
[…]always a big fan of linking to bloggers that I love but don’t get a lot of link love from[…]…
2011/12/11 - 08:03:03 -
Great Source Of Web Marketing Material
[…]Thank you for posting this interesting details. It’s excellent to understand a number of people still care about this[…]
2011/12/11 - 11:41:02 -
Trackback for a Great Article…
[… ]Left you a trackback for your readers to get more info[… ]……
2011/12/11 - 21:27:49 -
P38 Body Electrical control module
[…]just beneath, are numerous absolutely not associated sites to ours, nonetheless, they may be certainly really worth going over[…]
2011/12/12 - 04:41:09 -
Great website
[…]we like to honor many other internet sites on the web, even if they aren’t linked to us, by linking to them. Under are some webpages worth checking out[…]…
2011/12/12 - 07:20:12 -
Cool sites
[…]we came across a cool site that you might enjoy. Take a look if you want[…]…
2011/12/12 - 21:36:34 -
Recommeneded websites…
[…]Here are some of the sites we recommend for our visitors[…]……
2011/12/13 - 03:10:53 -
Superb website
[…]always a big fan of linking to bloggers that I love but don’t get a lot of link love from[…]…
2011/12/13 - 04:49:56 -
new condo in singapore
[…]check below, are some completely unrelated web sites to ours, however, they may be most trustworthy sources that we use[…]
2011/12/13 - 06:22:45 -
2012 Fashion ideas k
I guess what I’m trying to say is, I don’t think you can measure life in terms of years. I think longevity doesn’t necessarily have anything to do with happiness. I mean happiness comes from facing challenges and going out on a limb and taking risks…
2011/12/13 - 08:11:43 -
mlm business opportunity
[…]we came across a cool web-site that you simply could possibly take pleasure in. Take a appear for those who want[…]
2011/12/14 - 07:16:20 -
Recommeneded websites
[…]Here are some of the sites we recommend for our visitors[…]…
2011/12/14 - 09:26:53 -
Gems form the internet
[…]very few websites that happen to be detailed below, from our point of view are undoubtedly well worth checking out[…]…
2011/12/14 - 21:50:53 -
cheap flights to pakistan
[…]The information mentioned in the post are several of the top readily available […]
2011/12/14 - 22:44:19 -
Really interesting post
This truly replied my challenge , thank you!.
2011/12/15 - 01:44:31 -
clear skin max
[…]very couple of websites that take place to become detailed beneath, from our point of view are undoubtedly very well really worth checking out[…]
2011/12/15 - 04:37:24 -
Cool sites
[…]we came across a cool site that you might enjoy. Take a look if you want[…]…
2011/12/15 - 08:53:11 -
Solglasögon Online
[…]It’s great that individuals nonetheless know a good deal about point like that. This definitely includes a lot of men and women agreeing with.[…]
2011/12/15 - 13:36:13 -
Its hard to find good help
I am regularly saying that its hard to get good help, but here is
2011/12/15 - 13:56:09 -
Informative and precise
Its hard to find informative and accurate info but here I found
2011/12/15 - 19:48:01 -
singles dating
I’ve been browsing online more than three hours today, yet I never found any interesting article like yours. It is pretty worth enough for me. In my opinion, if all website owners and bloggers made good content as you did, the internet will be a lot m…
2011/12/16 - 04:24:09 -
Further Resources
[…] If you are trying to find more in detail info about this problem, more information about today’s issue was published at […]
2011/12/16 - 11:55:54 -
Related……
[… ]just beneath, are numerous totally possibly not related sites to our bait, however, they are absolutely worth going over[… ]……