轻松（如所见即所得）自定义文档输出

Question

我过去使用过 DocBook，我喜欢将内容与演示分开的想法。我很喜欢直接编辑 XML。在我广泛搜索以找到满足我需求的最佳文档解决方案时，我总是回到这个解决方案：

DocBook -> 构建系统（ant、make 等）-> 输出

我已经看到很多关于编写 DocBook 的最佳 WYSIWYG、XML、文本编辑器的信息，包括 asciidoc 等替代标记语言。所有这些解决方案都集中在 DocBook 的创建或 DocBook 工具链的噩梦上。除了说“只需使用 XSL”或“自定义脚本”之外，没有人会在输出端提到过

当我负责编写文档或手册时，我不想担心花费无数小时尝试重新编程、自定义和修改 XSL、CSS 和 shell 脚本（即 O'Riely 的书籍）。这是一项非常艰巨的任务。

我的问题：有没有一种工具可以让定制变得更容易？是否有任何类似于 Pages 或 Word 的内容，因为用户创建了一个模板，而工具链完成了其余的工作？尝试执行像漂亮的徽标这样的视觉任务并修复默认 XSL 提供的所有损坏的布局（分页是一团糟）对于文本编辑器来说是非常困难的。内容很简单。过去，编辑 DocBook XSL 真是一场噩梦。我搜索了很多关于 XML 编辑器的信息，但没有找到关于 XSL 编辑器的信息。

或者我缺乏对流程的关键理解。谢谢。

Answer 1

我认为这不是您想要的，但我一直在使用两个 CLI 实用程序来简化我的 docbook 工具链：xmlto 和 publican。

Publican 在我看来很优雅，但足以满足 Fedora 和 Redhat 的发布需求。

• https://fedorahosted.org/xmlto/
• https://fedorahosted.org/publican/

Answer 2

使用样式表。 CSS 比你想象的要简单，只要你远离圆角、渐变背景和其他你不需要的无关紧要的废话。下面是一个经过美化和跨浏览器测试的 XML 文档示例：

http://mailmarkup.org/hcl/hcl1_0-documentation.xsd