網頁

2016年2月5日 星期五

DokoWiki 資料整理

DokoWiki 蠻特別的。它的資料儲存的方式可以選用檔案或是資料庫 (MySQL) 的方式。官方推薦的方式是採用檔案的方式,主要的論點是 Wiki 的使用與應用方式多數是以讀取為主。採用檔案的儲存方式,這點其實對於資料的備份也很方便。要備份整個系統其實只要將這些 dokowiki的檔案複製起來就可以了。

  • 環境與初次安裝:
系統需要有 PHP的執行環境,PHP 5.3 以上版本。安裝方式很簡單,只要在下載頁面內選擇好需要的功能 (它甚至連 web-server 都包含進來了),再按下 download 按鈕後就可以得到相關的程式碼;在這選擇的當然以 stable version 為主、language 僅挑選 zh-tw - 繁體中文、Plugins的部份,則挑了 Upgrade Plugin 好方便做往後的系統升級。

下載好的相關程式碼,解壓縮後傳到網站主機上。在利用瀏覽器到它的安裝介面(e.g. http://ip/dokuwiki/install.php),按照它介面上的指示操作後就可以順利的安裝。安裝好後,別忘了刪除 install.php 檔案。

至於安裝好後,要如何開始使用它呢?相關的使用說明文件在DokuWiki 的官方頁面也說明了很清楚。直接參考即可。在這列出新手上路,可能最需要知道的項目。
  1. 如何新增頁面 How to create pages in DokuWiki
  2. 刪除頁面  Delete a page 
  3. 新增左側的導覽列;新增 siderbar 頁面,將呈現的項目輸入即可。
  4. Namespaces;這功能主要可以讓很多的文件歸類到相同的類別內。做的好處是在找的時後,可以按分類尋找。
  5. 語法格式化 Formatting Syntax
  • DokoWiki Plugin 的安裝方式說明
Plugin 的安裝方式有提供很方便的 manager。但也是可以採用手動的方式安裝。方式也很簡單,只要將要使用的 plugin 下載後。再將檔案上傳到 /lib/plugins/* 的目錄內,就完成了。以 Add New Page Plugin 為例,只要將檔案下載後,解壓縮再上傳到指定目錄內。在 sidebar 頁面內新增 {{NEWPAGE}} 的語法,就能在頁面左側的導覽列內看到新增頁面的功能。

  • DokoWiki Template 的安裝方式說明
很多現成的樣版可供挑選,安裝與往後的更新方式也是透過 Extension Manager 來操作。手動的方式也很簡單。只要將下載好的樣版放在 /lib/tpl/* 內即可。RWD 在近年來很夯,Bootstrap3 Template 就是採用 bootstrap為基底的樣版,當然也支援 RWD 的頁面。所以採用這個樣版為例子,安裝的步驟只要將下載好的檔案解壓縮後,將整個目錄的檔案上傳到指定位圵後。再到系統介面內的管理選單內的系統設定內指定預設呈現的樣版後就完成了。
  • DokoWiki Upgrade
手動更新的方式可直接參考線上說明文件。也可以利用它的 Upgrade Plugin 來做升級的動作。不過利用 Upgrade Plugin來做升級的方式,必須主機的 PHP 有支援 SSL 串流加密 ( 將 php.ini 內的 extension=php_openssl.dll 啟用即可 )。

 也可以採用這的做法 https://www.dokuwiki.org/zh-tw:install:upgrade
直接將更新的版本內的所有檔案直接覆蓋上去。目前從測試環境內看來是沒有什麼問題。

  • DokoWiki Security
線上參考文件。我的做法是採用 LocationMatch 的方式。

相關資料
  1. DokuWiki Website
  2. Wiki語法入手