Re: /docs/guide/en/index.html

[OKANO Takayoshi <kano@na.rim.or.jp>]

> いまさら気づいたんですが
> /docs/guide/en/netbsd.xml と
> /docs/guide/en/index.html との違いはなんでしょうか？
> 
> /docs/guide/en/chap-*.xml は /docs/guide/en/netbsd.xml に関連するファイルですよね。

index.html や、chap-*.html は、これらの *.xml をもとに生成されたものです。

http://people.allbsd.org/%7Ehrs/N+I2005/sato-n+i.pdf
http://www.NetBSD.org/developers/htdocs.html
などに説明があります。

> 本家にある The NetBSD Guide http://www.netbsd.org/docs/guide/en/index.html は
> /docs/guide/en/index.html ですよね。

です。
で、手で編集されているのは .xml のほうです。

netbsd-www というメタパッケージを入れて、
htdocs/docs/guide/en/ で
make html
とか
make html-split
とかやると、.xml をもとに .html を作ってくれます。

本家の更新に追従することを考えると、
翻訳でも *.xml で作業するほうがよさげなのですが、
本家 htdocs から翻訳関係のファイル (翻訳そのもののほか、
翻訳 .xml から .html を作るためのファイルも) が削除されてしまったので、
日本語訳の作業や公開方法をどうするか決めないとなんとも。