FreeBSD_Docs

FreeBSD Documents †

FreeBSDのハンドブックはオンラインやPDFなどいろいろな形式で提供されており、ドキュメントプロジェクトでは日本語版も提供されている。 一度ハンドブックをじっくりと読みたくなりPDFを製本化してみようとPDFファイルやRTFファイルをダウンロードしてみた。

ところが、日本語が文字化けしてまったく読めなかった。Windows XPとMac OSXのAcrobat Readerで開いてみたけどやはり日本語は文字化けしていた。

で、コミュニティで問い合わせたところ、ftp.freebsd.org/pub/FreeBSD/doc/で公開されているbook.pdfは日本語フォントの入っていない環境でPDFを作成したので、文字化けしているということだった。つまり自分でPDFを作成するば文字化けしないPDFを作成することができるということだった。

日本語版ハンドブック.pdfの作り方 †

handbookのsourceそのものは、cvsから持ってきてくる。
/usr/share/examples/cvsup/doc-supfile
あたりを参考に。

• 必要な package
  • ja-jadetex-ptex
  • ja-ptex-tetex
  • ja-dvipdfm
  • docproj-jadetex (WITHOUT_CJK を定義して build しないと chinese/docproj からずるずると chinese/latex だかなんだかのでかい package が入って泣くことになります)
    

あとは、こいつらが依存している package が適当に入ることでしょう (特定の ghostscript を入れたければ、それも事前にいれておくべきでしょう)。

パッケージのインストール †

最近のマイブームでpkg_addでインストールしてみる

# pkg_add -r ja-jadetex-ptex
# pkg_add -r ja-ptex-tetex
# pkg_add -r ja-dvipdfm
# pkg_add -r docproj-jadetex

でもって、doc の source の doc/ja_JP.eucJP/books/handbook で次のコマンドを実行します。
make NO_TEX_LANG= TEX_CMD=ptex LATEX_CMD=platex JADETEX_CMD='ptex "&jadetex-ptex"' book.tex
make NO_TEX_LANG= TEX_CMD=ptex LATEX_CMD=platex JADETEX_CMD='ptex "&jadetex-ptex"' book.dvi
dvipdfm -p a4 book.dvi

詳しいことは、Makefile からたどって、doc/share/mk/*.mk を眺めてみるべし。