DocBook简要参考手册

DocBook 5.0 and XSLT 1.0 Stylesheet

https://docboon.github.io/

Li Chunxin

2022年5月27日

DocBook是一套非常流行的文档标准。在IT行业,有大量的开源社团在使用,包括Fedora、OpenSUSE、Gnome、OpenStack等。也有很多商业性的公司在使用,如IBM、Oracle、Cisco等。DocBook具有丰富、细腻的标签,几乎涵盖了出版一本专业的技术书籍(特别是计算机类的书籍)所需要的所有元素。使用Docbook技术,会使我们创作出更为专业的书籍。

我们把在这方面的一些微不足道的经验分享出来,以飨读者。如果您有任何的意见和想法请告知我们,任何的建议都弥足珍贵。

这份手册就是由Docbook及相关工具来完成的。

修订历史
修订 1.02022年5月26日ChunXin
docboon
修订 0.22021年9月30日ChunXin
基本完稿
修订 0.12021年9月12日ChunXin
发布第一个Draft

版权声明

本作品由声明以Creative Commons Attribution 4.0 International license (CC BY 4.0)许可发行。即您可以自由地:

  • 共享 — 在任何媒介以任何形式复制、发行本作品
  • 演绎 — 修改、转换或以本作品为基础进行创作在任何用途下,甚至商业目的。

惟须遵守下列条件:

  • 署名 — 您必须给出本作品的署名,提供指向本许可协议的链接,同时标明是否(对本作品)作了修改。您可以用任何合理的方式来署名,但是不得以任何方式暗示许可人为您或您的使用背书。
  • 没有附加限制 — 您不得适用法律术语或者 技术措施 从而限制其他人做许可协议允许的事情。

Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution 4.0 International license.

Chinese

English

This document was generated at 16:41:22 on 2022-11-07 by docboon . cx.lee@outlook.com


目录

前言
1. 排版约定
2. 相关资源
关于DocBook
1. What ?
1.1. DocBook简介
1.2. DocBook历史
2. Why ?
3. How ?
1. 制作第一份DocBook文档
1. 基础环境搭建
2. 书写DocBook格式的xml文件
3. 生成我们需要的文件
3.1. 转换为html文件
3.2. 转换为pdf文件
3.2.1. 配置fop.conf文件
3.2.2. 设置fop脚本
3.2.3. DocBook-xsl参数调整
3.2.4. 生成pdf文件
2. 制作更完整的DocBook文档
1. 文档声明
2. 将文档物理分割
3. 认识更多的docbook标签
3.1. 关于“文档种类”的标签
3.2. 认识更多的“文档元素”
3.2.1. list
3.2.2. inline
3.2.3. admonitions
3.2.4. Line-specific environments
3.2.5. callout
3.2.6. superscript和subscript
3. 样式定义
1. 参数设置部分
2. 样式模板
4. 字体
1. 字体简介
1.1. 字体类型
1.2. 字体样式
2. 字体选择

插图清单

1.1. docware目录中的组件
4.1. 字体查看

表格清单

1.1. software
1.2. 样式表目录及作用