xml - dita 内容中的元数据

Question

我需要在源文档（在 DITA 中）中包含（精确地）我的需求的可追溯性机制。例如，要求 IFU1234 表明我们必须包括有关产品处置和回收的信息。我在想我可以劫持“draft-comment”标签以在相应主题中指示我的要求编号。然后，我将有可能发布带有这些评论的 PDF，以表明我已经在我的文档中涵盖了我的所有要求。然后发布没有评论的最终 PDF。是否可以使用draft-comment 元素？您是否看到另一个更适合我的用例的元素？（顺便说一下，我们没有 CMS。）谢谢，

Answer 1

我同意 Julio：主题序言中的元数据可能是最合适的，尽管您几乎可以在任何上下文中使用数据元素。

请注意，对于 DITA 1.3，我们添加了一个新的“发布管理”域，它提供了用于在地图和主题序言中用于捕获更改历史记录的显式标记，包括旨在识别更改源的标记，例如问题跟踪中的问题系统或形式要求。这听起来像你在找什么。

如果您希望能够以与显示或隐藏草稿注释相同的方式在某些输出中显示需求信息，那将是一个非常简单的 XSLT 或 PDF 自定义，例如，使用 DRAFT 运行时参数来显示相关的以某种适当的方式提出要求。

Answer 2

我不会用<draft-comment>这种方式。我要做的是使用<othermeta>名称要求和内容设置为它满足的要求。然后，我将添加处理以在一个输出版本中输出需求，并在地图上使用@outputclass 来关闭处理。