群英汇采用 reStructuredText（简称 reST）文本标记语言进行文档维护。在 cuirui 解决了 rst2pdf 对 reST 转换 PDF 的图片缩放问题之后，如何让生成的 PDF 更有表现力，下了一番功夫去研究。

  • 页眉和页脚根据转换的格式（HTML，PDF），自动进行选择
  • PDF 的页眉显示章节标题以及页码，而页脚则显示文档标题和公司名称及相关链接
  • HTML 的页眉显示文档标题以及到官方文档的链接（公司网站该文档的安装位置），页脚显示网址
  • 文档版本号和文档编译时间由 Debian 软件包配置文件中的 changelog 动态替换

阅读全部内容 »