Codex

一旦您完成了PmWiki的安裝,並成功的運行(請參見PmWiki 安裝指南)。您就可以定製它,以符合您的需求。

大部分PmWiki的設定被儲存在名為「local/config.php」檔案中,以及「pub/css/local.css」檔案中。另外一些設定則被儲在特定的頁面組中,例如SiteSiteAdmin頁面組中,例如 Site.SideBar選單 。

本地設定檔(local/config.php)

當你第一次安裝了PmWiki時,本地的設定檔尚不存在。請複製範例的檔案:sample-config.php file(在 docs/ 資料夾中),並改名為local/config.php 來作為您開始設定的起點。您也可以建立一個全新的 local/config.php 檔案,但是範例的檔案中有許多已經建立好可供調整的選項,適合新入門的初學者。

這裡有一個範例的 config.php 檔案:

<?php if (!defined('PmWiki')) exit(); $WikiTitle = "My New Wiki"; $PageLogoUrl = "";

  1. 若是需要的話,可以去除下列詞句的註解
  2. $ScriptUrl = 'http://example.com/pmwiki/pmwiki.php';
  3. $PubDirUrl = 'http://example.com/pmwiki/pub';

$DefaultPasswords['admin'] = crypt('onesecret');

$EnableUpload = 1; $DefaultPasswords['upload'] = crypt('secrettwo');

putenv("TZ=EST5EDT"); $TimeFmt = 'd, I:p EST';

請注意:config.php 檔案必須以<?php 開頭,至於 PHP 的結尾標記 ?> 則是可選擇的。 而且,為了在某些作業系統的相容性,它可以被省略掉。請確認在<?php 的開頭前沒有任何的空行或空白;在?>的結尾後也不可有空行或空白。若是有此情形,在您PmWiki的頁面中,會出現奇怪的 PHP 錯誤訊息。

上面所述的config.php 檔案,包含了以下PmWiki會用到的PHP變數:

  • $WikiTitle 變數:為您的網站命名,此網站名稱將會出現在您瀏灠器的標題列上。
  • $ScriptUrl$PubDirUrl 變數:告訴您的網站它的位置。通常PmWiki可以自已偵測到。但是若您有時候無法找到它的位置,或者您的外觀設定無法作用,那麼可以去除它們的註解。
  • $PageLogoUrl 變數:定義出圖示的檔案位置。圖示將出現在每一個Wiki頁面的左上角。
  • $DefaultPasswords['admin'] 變數:設置管理者的密碼。
  • $EnableUpload 變數:設為"1" 則開放上傳,("上傳附件檔案")。
  • $DefaultPasswords['upload'] 變數:設置上傳的密碼。
  • TZ environment 變數:定義特定的時區(請參見 Cookbook:ChangeTimeFormat)。
  • $TimeFmt 變數:定義時間的顯示格式(和 TZ 變數併用) 來將wiki設定為特定的時區(請參見 Cookbook:ChangeTimeFormat)。

設定在local/config.php檔案中的上述(以及其它的)的變數,您就可以更改PmWiki的預設的外觀及功能。您也可以參見 Variables 中的PmWiki會使用到的變數列表,您也可以參見 + 來參考客製化PmWiki的各種設定範例。

其它常見的設定

下列是在安裝新的Wiki系統時,所常會用到的變數:

以下是常被安裝的 Cookbook recipes:

  • Clean Urls? - 移除網址末尾的 ?n=Group.Page arguments。

若您想要建立的是國際化的wiki系統,您必須使您的wiki系統可以支持不同的字元(例如Cyrillic, Greek, Chinese)。或是需要許多的變音符號(例如:Czech、French),請參見PmWiki.UTF-8以及Cookbook:UTF-8

安全性

請參見Security並設定所需的安全性設定。

請務必使用crypt() 函式,並設定只有您知道的密碼。請參見 PasswordsAdmin中有關如何設定安全性較高的密碼。

設定一個管理者的密碼

Site群組下的所有頁面 (除了 Site.SideBar 頁面之外) 預設都是「鎖定的」。若想要編輯此群組下的頁面, 您必須設定一個「site-wide」的管理密碼於 local/config.php 檔案中。以下的範例,說明如何把密碼設定為"mysecret":

$DefaultPasswords['admin'] = crypt('mysecret');

您必須使用crypt() 函式,但是函式內的值則是您所想要設定的密碼。請參見PasswordsAdmin 關於如何設定安全性更高的密碼。

請不要變更 pmwiki.php 此檔案的名稱

PmWiki的設計理念是:不需要更改發行檔案即可完成定製。這樣是為了確保「平滑升級」的方便性。PmWiki並不會更動任何 local/cookbook/ 資料夾內的檔案。所以您可以放心的將定製設定儲存於此,如此在升級您的PmWiki時,您也不會失去原有的設定。

當您要更改任何設定時,請使用local/config.php 檔案來儲存您的設定;或是將檔案放置於cookbook/pub 資料夾。但是請不要更動pmwiki.php 或尟scripts/資料夾內的檔案,因為它們在更新的時候會被覆寫掉。

也請您不要更改更改pmwiki.php的檔案名稱。若是您將此檔案重新命名了,它在更新時便不會被覆寫掉,而這將造成版本上相容的問題。許多網站管理者的作法是:在PmWiki資料夾中,建立一個名為index.php,內含有 "wrapper script" ,內容如下:

<?php include('pmwiki.php');

建立的方法很簡單:首先開新一個純文字檔案,並貼上「<?php include('pmwiki.php');」這一行語法,另存新檔,檔名為index.php。並將其放置於和pmwiki.php相同的資料夾中(您可以使用FTP Client軟體來放置檔案)

組織管理

上傳資料夾

預設的情況下,PmWiki為每一個頁面組都建立了一個上傳資料夾(請參見 Uploads administration 來設定使用預設的上傳管理,或是指定另一特定的資料夾(例如整個Wiki系統共用一個上傳資料夾,或者是單一頁面使用單一上傳資料夾。 )依您需求而定。

頁面儲存資料夾

預設的情況下,PmWiki使用單一的頁面儲存資料夾。(wiki.d資料夾)。您可以決定使用預設值(建議);或者您可以為每一個頁面組都設定一個儲存頁面資料夾。

其他定製

在設定完local/config.php檔案後,您也可設定其他不同的local customizations。請參見Cookbook中列出了大量已發佈的其它功能及設定。請不要害怕使用Cookbook recipes - 它們大部分都是已經預先編寫好的檔案,您所需要做的,只是下載檔案,並在config.php檔案中加入一行命令即可。恭喜!這樣就大功告成了!

若是您(或是和您使用同一個網路主機的人) 想要在同一個網路主機中建立「多個PmWiki系統」,請參見Wiki Farms

然後咧?

最後,請別忘了加入PmWiki mailing list,您可以藉此和其他Wiki管理員請求使用上的幫助;並參與提供意見來改進。當您的PmWiki網站架設好時,別忘了將其加入PmWiki:PmWikiUsers 使其他人都可以知道!!