タグ

DocBookに関するmhrsのブックマーク (2)

  • DocBook/SGML や DocBook/XMLで文書を書く

    SGML,特にDocBookで文章を書く時のための方法についての説明です. DocBookは最近XMLに移行しつつあるので,XMLについても説明しています. DocBook文書作成術 SGMLの超基的用語説明 SGMLでは多くの専門用語がありますが,とりあえず 知っていなければいけない言葉として, エレメント(要素)という言葉があります. <para>むが</para> では,paraが要素(エレメント), <para>が開始タグ, </para>が終了タグ, というようになります. あと,<para id="fufu">というように, 指定できます.この「id」の部分を 属性(アトリビュート)と呼びます.そして, 「"fufu"」の部分を属性値と呼びます &なんたら;と書いてあるものを エンティティーと表現します. これは,何か別のものに置換されます. 「なんたら」が何に置換されるのか

  • DocBook + OpenJadeでw3c準拠のHTML作成を目指す

    はじめに DocBookで文書を記述して、HTMLに変換すれば目次や索引を自動的に 作成してくれるので便利だ。DocBook形式をHTML形式に変換する ソフトウェアのひとつにJadeがある。JadeはDSSSLという言語を用いて DocBook形式をHTML形式に変換する。JadeはLDPプロジェクトや JFプロジェクトにも採用されているソフトウェアであり、事実上の標準だろう。 また、表題のOpenJadeもJadeの一種である。 このJadeの出力するHTMLは非常にクセがある。 個人的な意見としては、「悶絶するくらい汚い」と思う。 その辺のHTMLエディタの方がよほどましなHTMLを吐き出してくれる。 例1がOpenJade (Ver. 1.4devel) + Norman Walsh 氏のDSSSL (Ver. 1.77) のデフォルトによる出力例だ。 例 1. OpenJade

  • 1