UTF 8ドキュメントをビルドする際の注意事項

UTF-8 ドキュメントのビルドエラー

make html で以下のエラーが出る場合があります。

openjade:postgres.sgml:18:28:E: 非SGML数字 25991
openjade:postgres.sgml:18:29:E: 非SGML数字 26360
openjade:postgres.sgml:24:24:E: 非SGML数字 12464
openjade:postgres.sgml:24:25:E: 非SGML数字 12525
openjade:postgres.sgml:24:26:E: 非SGML数字 12540
openjade:postgres.sgml:24:27:E: 非SGML数字 12496
openjade:postgres.sgml:24:28:E: 非SGML数字 12523
openjade:postgres.sgml:24:29:E: 非SGML数字 38283
openjade:postgres.sgml:24:30:E: 非SGML数字 30330
openjade:postgres.sgml:24:31:E: 非SGML数字 12464
openjade:postgres.sgml:24:32:E: 非SGML数字 12523
openjade:postgres.sgml:24:33:E: 非SGML数字 12540
openjade:postgres.sgml:24:34:E: 非SGML数字 12503
(以下延々とエラーが続く)

これはシステムの openjade が参照する docbook.dcl が悪さをするためです。

Debian/Ubuntu 系は何もしなくても大丈夫。RedHat 系は問題が出ることが多い。

無効化スクリプト

@noborus さんが作られた以下の sed スクリプトを実行すると、システムの docbook catalog から docbook.dcl を読み込んでいる箇所をコメントアウトします。

sed -i -e 's/^SGMLDECL "docbook.dcl"/ -- SGMLDECL "docbook.dcl" --/' /usr/share/sgml/docbook/sgml-dtd-*/catalog

参考 https://github.com/pgsql-jp/jpug-doc/issues/95