最新消息:20190717 VPS服务器:Vultr新加坡,WordPress主题:大前端D8,统一介绍入口:关于

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

工作和技术 crifan 933浏览 0评论

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

发表我的评论
取消评论

表情

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
68 queries in 0.101 seconds, using 18.53MB memory