XML

[kano@na.rim.or.jp (OKANO Takayoshi)]

別のところに反応します。

In message <20041118.103932.74750281.taca@back-street.net>
  Takahiro Kambe <taca@back-street.net> writes:
> 	- XML指向したい。:-p

最近、本家のいくつかのファイルが XML から生成されるようになっており、

http://www.netbsd.org/developers/htdocs.html#convert-to-xml

などによると、今後は他のページも XML 化されるようです。
これの翻訳はどのようにおこなえばよいでしょうか。

従来は htdocs/ja 以下だけの作業ですんでいたわけですが、
本家では htdocs/share 以下を各言語で共用しているので、
本家への反映を考えると、これまでの方法はとれないと思います。

1. 原文の htdocs/share 以下、 htdocs/Makefile.inc, htdocs/layout.xml を、
   jp.NetBSD.org の htdocs 以下にインポートする
2. htdocs/ja/Makefile.inc と htdocs/share/xsl/netbsd-webpage-ja.xsl を作り、
   jp.NetBSD.org に commit し、本家にも commit する
3. 翻訳対象の XML (例: htdocs/ja/Ports/sgimips/index.xml) をインポートする
4. XML を翻訳し、 HTML を作って
   jp.NetBSD.org に commit し、本家にも commit する

という手順になるのかと思いますが、手順 1 をやってしまうと、
本家のファイルが更新されるたびにインポートしなければならなくなります。

過去の議論のなかで、
そのようなことは大変なのですべきでない、という話がありました。

# http://www.jp.netbsd.org/ja/JP/ml/admin-ja/199901/msg00066.html
# http://www.jp.netbsd.org/ja/JP/ml/www-changes-ja/200002/threads.html#00027 からのスレッド

あと、わからないことがいくつかあります。

- NetBSD guide は他のページと階層が異なるため、上記手順は適用できません。
  # htdocs/guide を作る?
  # http://www.jp.netbsd.org/ja/JP/ml/www-changes-ja/200111/msg00047.html

- netbsd-webpage-??.xsl で locale.backto を定義していますが、
  従来の日本語訳では「NetBSD プロジェクトについてに戻る」
  のような書き方をしており、対応できません。
  # 「戻る: NetBSD プロジェクトについて」は、
  # 「出ます: ディレクトリ」みたいで何だか変なので

- htdocs/share/xml/developers.ent で
  developer 名が実体参照として定義されています。
  従来の日本語訳では
  http://www.jp.NetBSD.org/ja/Ports/x68k/
  のように、 developer 名も訳していたりするところがありますが、
  どのように対応するのがよいでしょうか。
  # developers.ent を参照して原文どおりのローマ字表記にする?
  # ベタに漢字で書く?

私は XML はさっぱりわかりませんので、
詳しい方にフォローしていただけるとありがたく思います。
よろしくお願いします。