能够编写文档,然后以多种不同的输出格式创建它,这曾是许多开发团队多年来的梦想。通过 DocBook XML 就可以实现,它不仅保持了语义标记,也保持了对资料格式化与输出的控制。 控制语义可以指定组成文档的章节和段落。在段落中可进一步详细规定包含的项。比方说可以将命
能够编写文档,然后以多种不同的输出格式创建它,这曾是许多开发团队多年来的梦想。通过 DocBook XML 就可以实现,它不仅保持了语义标记,也保持了对资料格式化与输出的控制。
控制语义可以指定组成文档的章节和段落。在段落中可进一步详细规定包含的项。比方说可以将命令和函数名放在单独的标签中,如清单 8 所示。
清单 8. 使用单独的标签包装命令和函数

<para>The <command>compile</command> takes the source code of the 

material and builds a new class based on the filename. For example, if the filename is

<filename>HelloWorld</filename> then the name of the class generated will be

<classname>HelloWorld</classname>.

显示不同的元素时可以选择不同的输出样式和格式,也可选择相同的样式。更重要的是,因为语义信息回会被返回(比如文档可能包含对类名的引用),所以可以在编写索引时用它生成一个列表(该列表包含文档中详细描述的所有类名)。
除了语义标记外,文档的章节和不同部分还可以用特殊的 ID 标记,用这些 ID 建立文档不同部分的链接。有些类型可自动完成(章节、部分以及其他生成目录的类型),其他则需要明确建立到其他部分的链接。
转化成目标格式的时这些链接可以自动转换成适当的格式。比如,这个链接会转换为适当的 HTML 页面或页面中锚的链接。如果要生成 PDF,则可以包含目标章节的页码。
这种转换由 XSLT 样式表完成。现有的标准 DocBook XSLT 样式表支持到标准 HTML、XHTML、PDF(通过 FO 标准)、Texinfo、Java™ Help 和 Man 页面的转换。使用标准样式表还可以将数据转化成各种不同的大小和风格,书籍、A4 页面和幻灯片。
各种输出格式和标记的灵活性意味着:当创建文档时,可以使用相同的文档源代码提供打印的手册、内嵌式的帮助、man 页面、在线和上下文感知的信息。使用更传统的模型,可以分别编写这些元素。
DocBook XML 在技术文章社区得到了广泛的认可,很多公司所有的文档全部采用 DocBook XML 标准(或它的一个子集)。

以上就是XML模式-详细介绍DocBook XML的详细内容,更多请关注php中文网其它相关文章!

声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn核实处理。

  • 相关标签:XML,DocBook
  • 程序员必备接口测试调试工具:点击使用

    Apipost = Postman + Swagger + Mock + Jmeter

    Api设计、调试、文档、自动化测试工具

    网页生成APP,用做网站的技术去做APP:立即创建

    手机网站开发APP、自助封装APP、200+原生模块、2000+映射JS接口按需打包

    • 上一篇:XML模式-RDF的详细介绍
    • 下一篇:XML模式-Dublin Core的详解

    相关文章

    相关视频


    • 使用xmlhttp为网站增加域名查询功能的示例代码...
    • 四种XML解析方式详解
    • 基于PHP对XML的操作详解
    • XML和Tomcat的入门知识的详细介绍
    • XML模式-详细介绍DocBook XML
    • Vue3 事件修饰符
    • vue3 指令
    • vue3 基础语法
    • vue3 组合api和选项api介绍

    视频教程分类

    • php视频教程
    • html视频教程
    • css视频教程
    • JS视频教程
    • jQuery视频教程
    • mysql视频教程
    • Linux视频教程
    • Python视频教程
    • Laravel视频教程
    • Vue视频教程

    专题

    XML模式-详细介绍DocBook XML