[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: JDDP page



遠藤です。

Fumitoshi UKAI <ukai@debian.or.jp> writes:

> > * 既にあちこちから現 JDDP ページにリンクが張られています。特に理由がな
> >   い限りは、それらのリンクが切れないように、すなわち JDDP (or 文書) の
> >   メインページの場所は Documents/index.html のままにしておくべきでしょ
> >   う。
> 
> 古いのを移動しておいて Documents/ 以下を cvs の 
> www.debian.or.jp/Documents にいれていきましょうか?

現在の Documents/ 以下のファイルがどのように生成され、設置されているの
かちょっと分からないのですが、とりあえずそのようにしようかと思ってます。

> > * リンクする文書に関しては、最新のものと obsolete なもの (例えば hamm 
> >   インストールマニュアルなど) は区別した方がいいと思います。
> 
> Releaseに対応している文書は Releaseごとの場所 (Documents/releases/hamm/ とか?)
> に置くようにしていけばよいと思います。

すいません。私の先のメールはリンク集に関するもので、ドキュメント本体の
管理についてまでは考えていませんでした。ドキュメント本体の管理について
は鵜飼さんのおっしゃる通りだと思います。

> > * かつて八田(ま)さんが 未翻訳の各 DDP 文書を整理された記事を -doc に投
> >   稿されていました。未翻訳の文書でもユーザにとって有益なものはあるでしょ
> >   うし、翻訳メンバーの TODO としても役立つのではとか思ったりもします。
> 
> index.cgi とかにして html 自体は dynamic に生成するとか
> または cvs に commit されたら必要な link は自動的に生成する仕組を
> つくるとかした方がいいのかもしれませんね。まぁこれは将来の課題でもいいかも。

とりあえずは HTML そのもので管理するというのでよろしいんでしょうか? 
ただおっしゃる通り、英語版、日本語版などいくつかのページを用意すること
を考えたら、ちゃんとそういう仕組みを作らないと大変ですね。

# www.debian.org で利用している wml なんかも便利かも…

> > で、私の再編案なのですが、
> > 
> > Documents/
> > 
> > index 文書のページ (読むだけの人向けに特に重要な文書) 
> >       八田(ま)さんの Debian Book Shelf をとりあえず丸ごとコピー。
> > 
> >       * 佐野さんの Debian Tips のように正式には JDDP の文書でないもの
> >         もこちらにリンクを用意
> > 
> > jddp  JDDP 文書総目録  (翻訳/管理者向けに JDDP の全文書情報を網羅) 
> >       従来の details.html を改名
> > 
> > 最初は単純にこれくらいにしといたほうがいいように思います。
> > これなら直ぐにできますし、なるべく早く最新の情報を提供するには、従来の
> > 資産を活かして徐々に改良していった方が better でしょう。
> > 一から再構成するとなると、やはり相当の時間がかかってしまいます。
> > そのうえで必要があれば、index および jddp を分割すればよいのではないで
> > しょうか。
> 
> ふむ。そうですね。
> とりあえず さっさと cvs に移行して、徐々に修正していけるように
> するのを優先した方がいいと思います。

数日待って特にご意見がなければ、ディレクトリ 
www.debian.or.jp/Documents を cvs に設置し、とりあえず上記の私の再編案
に沿って index.html.ja と jddp.html.ja の commit を行ないます。

-- 
Yoshizumi Endo <y-endo@xxxxxxxxxxxxxxx>