针对不同目标受众的文档书出版

发布于 2024-09-15 23:53:24 字数 818 浏览 6 评论 0原文

我喜欢一份 docbook xml 文档,其中包含适合多个目标受众的内容。是否有一个过滤器可以让我过滤掉仅“高级”用户需要的内容?

level 属性是我发明的,用来表达我的想法。

 <?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>

I like to have one docbook xml document that has content for several target audiences. Is there a filter that enables me to filter out the stuff only needed for "advanced" users?

The level attribute is invented by me to express what I have in mind.

 <?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>

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(2

风筝在阴天搁浅。 2024-09-22 23:53:24

DocBook 没有 level 属性。也许您的意思是用户级别< /a>?

如果您使用 DocBook XSL 样式表来转换文档,它们具有对分析(条件文本)的内置支持。要使用它,您需要

  1. 使用支持分析的样式表版本(例如使用html/profile-docbook.xsl而不是通常的html/docbook.xsl),并

  2. 通过 参数(例如将profile.userlevel设置为basic)。

Bob Stayton 的 DocBook XSL:完整指南第 26 章 包含所有内容细节。

DocBook does not have a level attribute. Perhaps you meant userlevel?

If you are using the DocBook XSL stylesheets to transform your documents, they have built-in support for profiling (conditional text). To use it you need to

  1. use the profiling-enabled version of the stylesheet (e.g. use html/profile-docbook.xsl instead of the usual html/docbook.xsl), and

  2. specify the attribute values you want to profile on via a parameter (e.g. set profile.userlevel to basic).

Chapter 26 of Bob Stayton's DocBook XSL: The Complete Guide has all the details.

九公里浅绿 2024-09-22 23:53:24

我想到了两种方法:

  1. 编写一个快速脚本,将 level 作为参数,并使用 XPath 或正则表达式,只输出您想要的 XML。
  2. 编写一个 XSLT 转换,它将输出您想要的 XML。

(2) 更清晰,但 (1) 写起来可能更快。

Two ways, off the top of my head:

  1. Write a quick script that takes the level as a parameter and, using XPath or regular expressions, that only spits out the XML you want.
  2. Write an XSLT transformation that will spit out the XML you want.

(2) is cleaner, but (1) is probably faster to write up.

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文