Re: htdocs/guide/en

[Hiroki Sato <hrs@eos.ocn.ne.jp>]

佐藤＠東京理科大学です。

 とりあえず、DocBook/XSL+DSSSL ベースで
 フレームワークをつくりました。パッチを

 http://www.allbsd.org/%7Ehrs/NetBSD/netbsd-guide-ja-initial.diff.gz

 に置きましたので、どなたか構築できるかどうか
 チェックしていただけると助かります。ja に移動して

  % make DOCTYPE=xml

 とするだけです。

 必要なツールは

  - jade-1.2.1nb6
  - docbook-4.2nb3
  - dsssl-docbook-modular-1.57nb2
  - tidy-20021108

 です。マークアップ的にまずい点をざっと直した英語版と、
 それの冒頭だけ翻訳したものが guide/ja 以下に入れてあり、
 あとは英語のままの部分を翻訳するだけ、という状態になっています。

 スタイルシートは
 dsl/default.dsl -> ja/share/netbsd.dsl -> dsl/netbsd.dsl -> ...
 の順番に読み込まれ、最初の設定が有効になります。
 つまり、日本語用の設定は ja/share/netbsd.dsl で行ない、
 言語共通の設定は dsl/netbsd.dsl で行なうというわけです。

 オリジナルがどういう方向でやろうとしているのか、いまひとつ
 理解できていないのですが、XSLT をベースにしたものでやる、ということであれば
 このフレームワークを DSSSL から XSLT に porting するつもりでいます。
 XML ファイル群への作業は DSSSL と XSLT、どちらを使っても同じです。

 どちらを使うべきかについては netbsd-docs にも投げましたが、
 現時点では XSLT を使って印刷可能な形式にタイプセットすることは
 困難ですので、Jade が使えるならば、さしあたりそれを使うというので
 いいような気がしています。

 そういうわけで、これをもとに日本語化してみます。
 まあ、今までの経験上、マークアップの間違いやタイプセットの
 フレームワークに関する話はいくら主張しても理解されないと
 個人的には思ってるので、netbsd-docs で反応なければ勝手に
 進めようかと思ってます。

--
| 佐藤 広生＠東京理科大学 <hrs@eos.ocn.ne.jp>
|                         <hrs@FreeBSD.org> (FreeBSD Project)