DocBook 资料链接

从以前的 Wiki 中整理出来的,也不知道还有几个链接是有效的:

The Definitive Guide DocBook线上官方手册 来自台湾的朋友老貢生之作 强烈推荐! DocBook 文件寫作入門 DocBook XML/SGML Processing Using OpenJade DocBook 文件制作进阶（一）文件模块化 新 DocBook学习 又一新作，作者是LinuxForum的limodou http://pyrecord.freezope.org/articles/doc2004030302/show saxon实践(一)(二) 更多丰富的教程 DocBook官方网站提供的 tutorials DocBook初学者入门网站，提供文件原始档案 DocBook XSL 参考手册 The KDE DocBook Authors guide GNOME Handbook of Writing Software Documentation Writing Documentation Using DocBook: Using DocBook at CERN 其他相关资料 DocBook助你完成传世之作 (未完成) DocBook文件转换环境设定 ...[ 繁体 ] （上） （下） DocBookFromScratch 分页 XSLT 是什么类型的语言 XML格式转换图示 Online DocBook to HTML / PDF convertor & DocBook validator 相关站点： Software Documentation Weblog

---

Dsssl相关 How-to documentation Parameter reference: HTML stylesheets Parameter reference: print stylesheets DocBook DSSSL Stylesheet FAQ Docbook DSSSL Stylesheets General DSSSL stylesheet Questions Introduction to DSSSL The DSSSL Cookbook

---

XML技术的相关资源和教程 http://www.bihu.net/html/bbs/viewthread.php?tid=2055 http://cmpp.linuxforum.net/XML/ >来自LinuxForum论坛XML版块 Chinese XML NOW! >http://www.ascc.net/xml/zh/GB/ XML站点: http://www.xml.org.tw/

saxon 实践

其中说到了中文的解决办法。 saxon 应该是很好的了，有一个 docbook 集成管理软件 DocMan 使用的也是saxon，曾经试过，特性基本上都有，可惜根本不可用（无论是Linux版本还是windows版本），即使我用它自带的 test 来测试文件也是一样。一直不清楚原因。 其实最好的还是 openjade，不管什么样的照吃，XML 的处理器都太娇嫩了。openjade 的缺点是速度慢，看来两全是很难了。我现在的做法是编辑过程中用 xalna 处理预览，而真正发布的时候用 openjade。

DocBook容易使用吗？

Dan Moniz 首先持反对意见：那是地狱，他们说了慌。

They Lied to Us

Norman Walsh 当然是持赞同观点了。

XML Interop, DocBook, and Ease of Use

Dan Moniz says no: I've been spending three weeks in XML hell.

In and amongst all my other work duties, I've been trying to develop a single-source XML based document publishing toolchain. A "solution", if you will, that will allow me to write documents in a layout-agnostic way based on document structure that can then be processed and published to whatever format I want or need: PDF, Microsoft Word, HTML, etc.

I'm surprised at the lack of integration and easy-to-use tools that seems to exist in the XML authoring world. I would have thought that by now, someone would have put together a package that approaches the sort of Microsoft Word/Corel WordPerfect model of authoring, but XML based, say with DocBook, but it doesn't seem to have been done. High-quality Windows-native XML editors with an authoring/publishing focus (as opposed to an IDE model) are rare, and I haven't found a free or open source editor yet that's reasonably feature complete. Once you have the editor, you still have to piece together an amazing amount of individual software and configuration details to put together a toolchain.

Norman Walsh says yes: Dan points out, fairly I think, that there’s been a lot of hype about the benefits of XML and how easy it’s going to make things. If you believe all that hype, the first few weeks in the trenches must be a real shock.

I’m trying to decide if I’ve contributed to that hype. I’m not sure. XML authoring, and DocBook authoring in particular, are easy by some metrics. For example, I do it in a free editor. By that metric, Word is extremely hard for me. I’d have to change operating systems ($$$) and buy the application ($$$). (Yes, I could use OpenOffice, in fact, I do sometimes, but that’s not really the point.)

The point is it depends on your metrics. It is dead easy for me to publish an essay like this one in HTML and PDF, and to syndicate it in RSS and Atom, and to generate metadata that can be queried. I could easily generate other forms as well.

自由软件中最好的XML编辑器 - jEdit

继续昨天的足迹又开始寻找可用的DocBook编辑器，偶然在一篇文章中作者推荐了几款编辑器其中就有jEdit，已经倦了的心想试试看吧。jEdit在sourceforge的老家：jedit.sourceforge.net在其中看到一张屏幕截图：

回头测试测试。

欲寻一款好用的DocBook编辑器不可得

这几天一直在寻找可用与Linux下的DocBook编辑器，几乎尝试了所有可用的版本。 居然没有一款个人比较满意的： Emacs/PSGML不会用，首先排除了。 epcEdit安装的时候需要TCL/TK的库，在Debian下的TCL/TK库位置和epcEdit的安装程序默认位置不同，换个目录后这个问题解决了，真正的问题是后面弹出一个窗口之后就僵死在那了。 LyX不支持CJK，下在了CJK的patch编译不能通过，后来用alien转换CJK patch作者提供的LyX-qt RPM包安装后可以正常输入中文，只是界面不满意，而且不能够直接编辑源代码。 Morphon XML Editor基于JAVA的，慢而且界面只有JAVA的和Motif的，非常丑陋，不过他的几个视图模式还是可以。 Corel XMetaL没有Linux的版本，这个应该不错，因为Norman Walsh用这个。 Syntext Serna基于QT，速度到是不错，安装也没有什么问题，不过不可以编辑源代码。 XMLBuddy是基于eclipse的插件，没有代码补全，不是所见即所得，不过也算不错了。 oxygenxml虽然不是所见即所得的但有代码补全功能，还是很喜欢，可惜在Linux上安装后运行一直不成功，包括作为eclipse的插件。 最欣赏的该是Conglomerate，这个基于GTK2的而且以GPL发布，是为DocBook量身定做的，唯一的遗憾是不支持中文输入，另外还有一些不稳定。 看来还是用kate算了。

DocBook Authoring Tools

编辑器	平台	Free?	XML	SGML	Off-the-shelf DocBook support?	评价&备注
Emacs/PSGML	All	Yes	XML	SGML	included in most DocBook Packages	****
epcEdit	Linux, Win, Solaris	No	XML	SGML	DTD, WYSIWYM, tables	***,安装程序有bug
Lyx(*not* just for Latex editing!)	*nix, Win, Mac	Yes	no	SGML	DTD, hybrid-WYSIWYG, tables?	***,输入中文需要CJK-patch
Morphon XML Editor	All	Yes	XML	NO	DTD, WYSIWYG, tables?, stylesheets	****,java平台，慢
XXE Standard Edition	All (Java)	Yes	XML	NO	DTD, WYSIWYG
Corel XMetaL	Win	No	XML	SGML (until version 3.1)	tables;	*****，Norman Walsh用这个
XML Editor	All (Java)	No	XML	SGML	DTD, stylesheets,code completion	****,有for eclipse的插件，安装不成功
Conglomerate	Linux	Yes	XML	NO	As far as I know	****,接口最好，需要更多的特性，不支持CJK，希望有人能够patch一下
Syntext Serna	Win, Linux	No	XML	NO	Schema, DTD, WYSIWYG, Tables, XSL rendering	****
XMLBuddy	ALL(Java)	Yes	XML	NO	Schema	***,plugin for eclipse,pro版本需要license
jaxe	ALL(Java)	Yes	XML	NO	Schema	***,plugin for netbeans
VEX	ALL(Java)	Yes	XML	NO	Schema,WYSIWYG	***

chm和Docbook的闲碎事

前几天下载了chm_view,发现编译需要qt库和一些devel包，没有搞定，今天时间多点，看完mail后花了点时间apt-cache了一下，发现了些东东：kde-devel包，只是一个空包，估计就是我需要的(活活，后来证明我的估计没有错)。

apt-get install kde-devel之后发现需要安装一堆包，活活，挺兴奋的，至少对路了，而且最重要的是，现在没有依赖性了，安装过后如法炮制install了 gnome-devel。

顺便安装了几个Recommended的包。

好有时间，看了些DocBook的HowTo，安装了DocBook需要的包：apt-get install linuxdoc-tools apt-get install sgmltools-Lite apt-get install zh-sgmltools 以后有时间再研究了，faint，考试真烦！害得没有时间。