支持的版本: 当前 (17) / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4

J.5. 文档编写 #

文档源文件最好使用具有 XML 编辑模式的编辑器进行修改,如果它还了解 XML 模式语言,以便它可以专门了解 DocBook 语法,那就更好了。

请注意,由于历史原因,文档源文件的扩展名为 .sgml,即使它们现在是 XML 文件。因此,您可能需要调整编辑器配置以设置正确的模式。

J.5.1. Emacs #

nXML 模式,它随 Emacs 一起提供,是使用 Emacs 编辑XML文档最常用的模式。它将允许您使用 Emacs 插入标签并检查标记一致性,并且它开箱即用地支持 DocBook。请查看nXML 手册 以获取详细文档。

src/tools/editors/emacs.samples 包含此模式的推荐设置。

提交更正

如果您在文档中发现任何不正确、与您的特定功能体验不符或需要进一步澄清的内容,请使用此表格报告文档问题。