jDocBook 和资源+内容准备

   |       讨论

<queue-voice-of-god>起初有 jdocbook-styles...</queue-voice-of-god>

jDocBook 样式旨在表示可以独立开发的常见样式元素,可以构建到捆绑包中,并用作依赖项,通过 jDocBook 插件在 DocBook 构建中使用。样式的内容(CSS 和图像)被放置在 DocBook 项目目标目录中的特殊目录中,用于 XSLT 格式化。

最近我一直在努力将这个概念扩展到来自 publican 世界的一个想法。对于不熟悉它的人来说,publican 是 Fedora 和许多 Red Hat 相关项目使用的 DocBook 构建系统。我正在考虑将其引入 jDocBook 的世界中的是 publican 术语中的“品牌”。这些品牌实际上提供了两个相对互补的东西

  1. 样式
  2. 回退内容

与 jdocbook-styles 类似,publican 品牌允许提供用于输出格式的 CSS 和图像。最大的区别是品牌允许它们针对特定的翻译进行本地化。'回退内容'的概念允许开发常见的文档内容(DocBook XML),然后在各种文档项目中使用。例如,publican 品牌通常定义法律声明和文档约定的回退内容。再次,允许在适当的 POT/PO 文件中针对各种翻译进行本地化。

本地化方面引发了一个关于jdocbook-styles及其资源部署的问题。目前,jdocbook插件本身会将jdocbook-styles内的资源部署到目标/docbook/staging目录(后续格式化阶段只是简单地指向这些资源,因为它们对于所有翻译来说都是隐式共享的)。然而,品牌的部署则需要每个翻译都有其自己的部署目录(如target/docbook/staging/en-US等)。因此,我们可以选择将jdocbook-styles重复部署到每个翻译的部署目录中,或者将本地化的jdocbook-styles也进行部署。

最初的想法是让jDocBook插件本身执行所有这些部署(特别是因为它已经为jdocbook-styles这样做)。但今天,我脑海中闪过一个想法:将部署的概念分离出来。基本原则是简化jDocBook,使其专注于核心能力,即接收一些DocBook XML、一些资源、一些XSLT并生成一些格式化的输出。这将允许不使用样式和不使用品牌的项自有一个非常简单的jDocBook设置;本质上,它将直接从受控源构建。对于使用样式和/或品牌的项自有,我们将所有内容部署到部署目录中,并配置jDocBook自身以使用部署目录作为其输入。

--- 资源

  • GNU gettext 如果你不熟悉POT/PO文件
  • poxml 用于处理XML文件中的gettext的工具

返回顶部