4

我正在尝试使用 Dokuwiki 创建软件用户手册，因为我必须为不同平台的同一产品创建 3 个用户手册，并且更改非常少。Dokuwiki 有没有办法创建一个通用的用户手册，可以用于不同的产品？

4

2 回答 2

3

对于 DokuWiki 的细节，我建议使用站点导出插件（主要是因为我制作了它并且我们也将它用于我们的文档）。

您可以像创建 wiki 中的普通页面一样创建书籍的章节。在将它们组合成不同的书籍时，请在不同的命名空间中创建一个名为“toc”的页面。其中有以下语法（有关详细信息，请参见 github 页面）：

  * [[命名空间：第 1 章]]
    * [[命名空间：第 1.1 章]]
    * [[命名空间：第 1.2 章]]
  * [[命名空间：第 2 章]]
    * [[命名空间：第 2.1 章]]
    * [[命名空间：第 2.2 章]]

现在，您可以在启用 roc 选项的情况下导出此命名空间 - 并将其合并到一个文档中。您现在也可以使用带有自定义书本样式的 PDF 导出（这是我们主要做的）。

于 2014-07-18T08:54:06.773 回答
2

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

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

于 2012-01-18T14:44:17.390 回答