针对不同目标受众的Docbook发布

Question

我希望有一个docbook xml文档，其中包含多个目标受众的内容。是否有过滤器可以过滤掉“高级”用户只需要的东西？

我发明了关卡属性来表达我的想法。

 <?xml version="1.0"?>
 <book>  
   <title lang="en">Documentation</title>

   <chapter id="introduction" level="advanced">  
       <title>Introduction for advanced users</title>
   </chapter>

   <chapter id="introduction" level="basic">  
      <title>Introduction for basic users</title>
   </chapter>  

   <chapter id="ch1">
      <para level="basic">Just press the button</para>
      <para level="advanced">
           Go to preferences to set your
           needs and then start the process 
           by pressing the button.
      </para>
   </chapter>
</book>

Answer 1

DocBook没有level属性。也许你的意思是userlevel？

如果您使用DocBook XSL样式表来转换文档，则它们具有内置的分析支持（条件文本）。要使用它，你需要

1. 使用样式表的启用概要分析的版本（例如，使用html/profile-docbook.xsl代替通常的html/docbook.xsl）和

2. 通过parameter指定要分析的属性值（例如，将profile.userlevel设置为basic）。

Bob Stayton的 DocBook XSL：完整指南的

Chapter 26包含所有细节。

Answer 2

两种方式，我的头脑：

1. 编写一个快速脚本，将level作为参数，并使用XPath或正则表达式，只显示您想要的XML。
2. 写一个XSLT transformation，它会吐出你想要的XML。

（2）更清晰，但（1）写起来可能更快。