【整理】DocBook 开发过程记录 – 1

1.按照这里：

http://www.worldhello.net/doc/docbook_howto/ar01s03s01.html

建了个helloworld.sgml。

2.按照这里：

http://www.worldhello.net/doc/docbook_howto/ar01s03s02.html

去下载了：

http://www.oasis-open.org/docbook/sgml/4.2/docbook-4.2.zip

http://www.oasis-open.org/docbook/xml/4.2/docbook-xml-4.2.zip

不过在这里：

http://www.oasis-open.org/docbook/sgml/4.5/

http://www.oasis-open.org/docbook/xml/4.5/

下载到了更新的版本：

http://www.oasis-open.org/docbook/sgml/4.5/docbook-4.5.zip

http://www.oasis-open.org/docbook/xml/4.5/docbook-xml-4.5.zip

后来接着还是按照教程的说明去一步步操作，只是对应的把之前4.2改为4.5即可。

其中下载的一些文件为：

http://surfnet.dl.sourceforge.net/project/docbook/docbook-xsl/1.76.1/docbook-xsl-1.76.1.tar.bz2

http://superb-sea2.dl.sourceforge.net/project/docbook/docbook-dsssl/1.79/docbook-dsssl-1.79.tar.bz2

http://www.tldp.org/authors/tools/ldp.dsl

http://cdnetworks-us-2.dl.sourceforge.net/project/openjade/openjade/1.3/openjade-1.3-1.exe

不过，其中，

SGML格式的ISO Entities，是可以从 http://www.oasis-open.org/cover/ISOEnts.zip下载；

但是XML格式的ISO Entities，所给出的地址

http://www.oasis-open.org/committees/docbook/xmlcharent/0.3/xmlcharent-0.3.zip

是无效的，有效的地址，可以从这里：

http://lists.oasis-open.org/archives/docbook/200206/msg00089.html

找到，应该是：

http://www.oasis-open.org/docbook/xmlcharent/0.3/index.shtml

中的：

http://www.oasis-open.org/docbook/xmlcharent/0.3/xmlcharent-0.3.zip

3.根据：

http://www.worldhello.net/doc/docbook_howto/ar01s03s03.html
中的介绍，去编译了helloword，都是可以正常生成的对应的，多个html，单个html，rtf文档等。

用到的一些命令为：

E516537@CH3UDTDJ9G4C2X /cygdrive/d/dev_root/DocBook/dev/src
$ history
    1  cd /cygdrive/d/dev_root/DocBook/dev/src/
    2  ls
    3  openjade.exe /?
    4  openjade.exe --help
    5  openjade.exe -h
    6  openjade.exe -E 0 -t sgml -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/html/docbook.dsl helloworld.sgml
    7  openjade.exe -E 0 -t sgml -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/html/docbook.dsl helloworld.xml
    8  openjade.exe -E 0 -t sgml -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/html/docbook.dsl helloworld.xml
    9  openjade.exe -E 0 -t sgml -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/html/docbook.dsl helloworld.sgml
   10  openjade.exe -E 0 -t sgml -i html -d ../../config/style/dsssl/ldp.dsl#html helloworld.sgml
   11  openjade.exe -E 0 -t sgml -i html -d ../../config/style/dsssl/ldp.dsl#html helloworld.xml
   12  openjade.exe /h
   13  openjade.exe --help
   14  openjade.exe -E 0 -t sgml -V nochunks -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/html/docbook.dsl helloworld.sgml > index_sgml.html
   15  openjade.exe -E 0 -t sgml -V nochunks -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/html/docbook.dsl helloworld.xml > index_xml.html
   16  openjade -E 0 -t sgml -i html -V nochunks -d ../../config/style/dsssl/ldp.dsl#html helloworld.sgml > index_ldp_sgml.html
   17  openjade -E 0 -t sgml -i html -V nochunks -d ../../config/style/dsssl/ldp.dsl#html helloworld.xml > index_ldp_xml.html
   18  openjade -E 0 -t rtf -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/print/docbook.dsl helloworld.sgml -O rtf_sgml.rtf
   19  openjade -E 0 -t rtf -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/print/docbook.dsl helloworld.sgml -O rtf_sgml.rtf
   20  openjade -E 0 -t rtf -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/print/docbook.dsl helloworld.sgml
   21  openjade -E 0 -t rtf -d ../../config/style/dsssl/1.79/docbook-dsssl-1.79/print/docbook.dsl helloworld.xml -O rtf_xml.rtf
   22  openjade -E 0 -t rtf -i print -d ../../config/style/dsssl/ldp.dsl#print helloworld.sgml -O rtf_ldp_sgml.rtf
   23  openjade -E 0 -t rtf -i print -d ../../config/style/dsssl/ldp.dsl#print helloworld.xml -O rtf_ldp_xml.rtf
   24  history

4.关于xsltproc，可以从主页的download页面：

http://xmlsoft.org/XSLT/downloads.html

中找到了对应的windows的二进制安装文件下载页面：

ftp://ftp.zlatkovic.com/libxml/

其中可以下载到所要的zip格式的windows的二进制版本。

关于如何下载安装，详细步骤请参考这里：

http://easwy.com/blog/archives/a-simple-docbook-5-example/

中的“2.下载xsltproc转换程序”章节。

5.XSL

关于XSL，有份完整的英文教程，可以在线看：

DocBook XSL: The Complete Guide

http://www.sagehill.net/docbookxsl/

6.完整版的Docbook英文资料，可以看最新版的这个：

DocBook 5: The Definitive Guide

http://www.docbook.org/tdg51/en/html/docbook.html

7.从DocBook转为pdf的方式
这里有总结：
http://www.dpawson.co.uk/docbook/tools.html#d884e2955
其中最常用的还是Apache的FOP。

8.关于SGML转为pdf的toolchain

这里有简单的comments：

http://www.dpawson.co.uk/docbook/tools.html#d884e871

9.fop
其主页是：
http://xmlgraphics.apache.org/fop/
其中可以一步步找到下载二进制的地方：
http://www.poolsaboveground.com/apache//xmlgraphics/fop/binaries/

10.cygwin xsltproc

http://www.sagehill.net/docbookxsl/InstallingAProcessor.html

11.一个典型的book，chapter，article，reference page，front and back可以参考这里：

http://www.docbook.org/tdg51/en/html/ch02.html#ch02-makexml

的：

“5. Making a DocBook Book

6. Making a Chapter

7. Making an Article
8. Making a Reference Page

9. Making Front and Back Matter (Index, Glossary, Bibliography)”

相关内容：

【记录】DocBook开发过程 – 2

转载请注明：在路上 » 【整理】DocBook 开发过程记录 – 1