D.6. 元数据的标记

D.6.1. 署名译者、转换者和合作作者

有几种方法可以对这些人以及您文档的其他贡献者给予认可,感谢他们提供的帮助。

D.6.1.1.<othercredit>

所有译者、转换者和合作作者都应使用<othercredit>标签条目进行署名。要正确署名译者或转换者,请使用<othercredit>标签,并使用role属性设置为 "converter""translator",如下例所示

示例 D-8. 其他署名

<othercredit role='converter'>
  <firstname>David</firstname> 
  <surname>Merrill</surname> 
  <contrib>Conversion from HTML to DocBook v3.1 (SGML).</contrib>
</othercredit>

D.6.1.2. 署名编辑和审阅者

为了帮助跟踪审阅过程,所有新文档都必须包含对 技术语言元数据 审阅者的引用。

示例 D-9. 编辑

<editor>
  <firstname>Tabatha</firstname> 
  <surname>Marshall</surname> 
  <contrib>Language review of version 0.8</contrib>
</editor>

D.6.2.<revremark>s

<revision>标签层次结构中有一个名为<revremark>的标签。在此标签内,您可以对文档的每个特定修订版本进行任何简要注释。

D.6.3. 修订历史

应使用<revhistory>标签来表示文档的各种修订版本。指定日期、修订号和关于更改内容的注释。

修订版本应按最新版本在最顶部列出(以降序排列)。

D.6.4. 日期格式

应使用<pubdate>标签在您的标头中应列出此特定文档版本的发布日期(与修订日期一致)。它应采用以下格式

<pubdate>2002-04-25</pubdate>

日期格式为 YYYY-MM-DD,这是表示日期的 ISO 8601 标准格式之一。对于你们这些美国佬(也包括我),可以将其视为从最大的时间单位到最小的时间单位。

D.6.5. 示例文章(或书籍)信息元素

这是一个完整的 DocBook (SGML 或 XML) 的示例<articleinfo>元素,其中包含一些先前描述的项目和结构。

示例 D-10. 示例元数据

<!--
   Above these lines in a typical DocBook article would be the article
   element (the immediate parent of the articleinfo element) and above
   that typically, the DOCTYPE declaration and internal subset.
  -->

<articleinfo>

  <!-- 
  	Use "HOWTO", "mini HOWTO", "FAQ" in title, if appropriate
  --> 
  
<title>Sample HOWTO</title>

<author>   
	<firstname>Your Firstname</firstname>
	<surname>Your Surname</surname>
	<affiliation>
		<address><email>your email</email></address>
		</affiliation>
</author>

<editor>
  <firstname>Tabatha</firstname> 
  <surname>Marshall</surname> 
  <contrib>Language review of version 0.8</contrib>
</editor>

<othercredit role='converter'>
  <firstname>David</firstname> 
  <surname>Merrill</surname> 
  <contrib>Conversion from HTML to DocBook v3.1 (SGML).</contrib>
</othercredit>

   <pubdate>YYYY-MM-DD</pubdate>

	<revhistory>
		<revision>
		<revnumber>1.0</revnumber>
		<date>YYYY-MM-DD</date>
		<authorinitials>ABC</authorinitials>
		</revremark>first official release</revremark>
		</revision>
		
		<revision>
		<revnumber>0.9</revnumber>
		<date>YYYY-MM-DD</date>
		<authorinitials>ABC</authorinitials>
		<revremark>First draft</revremark>
		</revision>
	</revhistory>

   <!-- 
		Provide a good abstract; a couple of sentences is sufficient
   -->

  <abstract>    
		<para>
       This is a sample DocBook (SGML or XML) HOWTO which has been
       constructed to serve as a template.
		</para>
	</abstract>

</articleinfo>