複製一段內容

Question

在我的DocBook文檔我有幾個部分，其遵循此模式：

• 段名
• 簡短描述
• 長描述

我會喜歡創建這些部分的索引。但我需要它是一張表格，格式如下：

| link_with_section_name | short_description |
| < link id =「section1_id」>部分名稱1 < /鏈接> |簡短描述1 |
| < link id =「section2_id」>部分名稱2 < /鏈接> |簡短描述2 |

我不喜歡複製簡短描述的想法。我想在第二列中創建一些參考，以便簡短描述將直接從參考部分獲取。我大概可以創建一個xterm參考，其中endterm屬性，但我不想在第二列創建鏈接。我只是想複製包含簡短描述的段落中的內容。

有沒有辦法在DocBook中做到這一點？

Answer 1

這是XSLT可以在其中工作的地方。

您需要使用XPATH規則創建表格的模板，以填充現有文檔中的表格。

您需要將該表包含在適當的位置。然後你需要使用一個Ant（或Make或Maven或SCONS）來（1）運行你的變換來生成你的表格，然後（2）運行你的普通DocBook變換。

我使用的另一種方法是使用ElementTree XML解析器在Python中編寫轉換。

必不可少這個配方的一部分是建立表格只是從DocBook構建HTML或LaTeX的一個步驟。