如何使用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導出與自定義書籍樣式（這是我們主要做的）。