如何使用Dokuwiki创建一个通用的用户手册

Question

我想用Dokuwiki创建一个软件用户手册，因为我必须为不同的平台上的同一产品创建3个用户手册，并且变化非常小。 Dokuwiki有什么方法可以创建可用于不同产品的通用用户手册吗？

Answer 1

此答案适用于任何wiki引擎，而不仅仅是DokuWiki。

基本上，您需要做的是将文档的公共部分分解为可包含在产品特定页面中的单独页面。对于DokuWiki，这需要包含插件（www.dokuwiki.org/plugin:include），尽管跨越常常是wiki的核心功能。我建议开始为最常见的产品编写文档，然后再回过头来看看哪些部分可以用于通用文档。

Answer 2

对于DokuWiki的细节，我建议使用site export插件（主要是因为我做了它，我们也将它用于我们的文档）。

您可以创建书中的章节，就像维基中的普通页面一样。将它们组合到不同的书籍中时，请在不同的名称空间中创建一个名为“toc”的页面。在那里的语法如下（详见github上页）：

 

    * [[namespace:chapter1]] 
    * [[namespace:chapter1.1]] 
    * [[namespace:chapter1.2]] 
    * [[namespace:chapter2]] 
    * [[namespace:chapter2.1]] 
    * [[namespace:chapter2.2]] 

现在你可以导出这个命名空间启用中华民国选项 - 并合并成一个文件。您现在也可以使用PDF导出与自定义书籍样式（这是我们主要做的）。