复制段落内容

Question

在我的DocBook文档中，我有几个部分，遵循这种模式：

• 部分名称
• 简短说明
• 长描述

我想创建这些部分的索引。但我需要它成为一个表格，其格式如下：

| link_with_section_name | short_description |
| ＆lt; link id =“section1_id”＆gt;部分名称1＆lt; / link＆gt; |简短说明1 |
| ＆lt; link id =“section2_id”＆gt;部分名称2＆lt; / link＆gt; |简短说明2 |

我不喜欢复制简短描述的想法。我想在第二列中创建某种引用，以便直接从引用的部分中获取简短描述。我可以使用 endterm 属性创建 xterm 引用，但我不想在第二列创建链接。我只想复制包含简短描述的段落中的内容。

有没有办法在DocBook中做到这一点？

Answer 1

这是XSLT可以工作的地方。

您需要使用XPATH规则创建表格模板，以便从现有文档填充表格。

您需要将该表包含在适当的位置。

然后您需要使用Ant（或Make或Maven或SCONS）来（1）运行转换以生成表，然后（2）运行普通的DocBook转换。

我使用的另一种方法是使用ElementTree XML解析器在Python中编写转换。

本配方的基本部分是构建表，只需从DocBook构建HTML或LaTeX一步。