PmWiki 安裝指南

本頁描述如何下載並安裝 PmWiki 2.1 及 2.2.

以下是相關的頁面：

系統需求 - 運行PmWiki的系統等的需求
系統升級 - 如何更新現有的PmWiki
Wiki Farms - 在同一個PmWiki安裝下運行多個wikis
Change Log - 更新日誌

非常歡迎對本頁的內容有所"更動"。若是遇到任何安裝上的問題，可有聯絡PmWiki的使用者們 mailing list或者是使用PmWiki Issue Tracking System。

安裝 PmWiki

1. 下載

下載最新版本的PmWiki，可以的型式有：

zip 壓縮 (pmwiki-latest.zip)
gzipped tarball (pmwiki-latest.tgz) 從 http://pmwiki.org/pub/pmwiki/

也可以下載最新的測試版： PmWiki:Subversion。

2. 解壓缩

解開壓縮檔 (輸入指令：tar zxvf pmwiki-latest.tgz 或是 unzip pmwiki-latest.zip或是使用圖形介面)。此動作將產生一個 pmwiki-x.y.z資料夾，內容即是PmWiki程式。例如，使用"最近版本" 的話，解壓縮將會產生一個叫 pmwiki-2.3.34的資料夾。此資料夾的內容包括：

  README.txt        簡介的文件
  pmwiki.php        主要的PmwWiki程式碼
  local/            設定控制的程式碼 (local configuration files)
  cookbook/         由 Cookbook下載的Recipes (擴充元件)
  docs/             簡短的文件， 設定碼的範例
  pub/              公開的檔案
  pub/css/          額外的 CSS stylesheet 檔案^[1]
  pub/guiedit/
  pub/skins/        由 custom下載的顯示模版
  scripts/          PmWiki程式碼的一部份
  wikilib.d/        內含預設的PmWiki頁面

pmwiki-x.y.z 必須被放置在你的webserver可以使用的地方
-> 例如，放置於public_html 這樣的資料夾
或者如apache，就是"htdocs"資料夾

您可以使用很多種方法來放置資料夾-- FTP, 或者是Unix mv、cp 指令都可以完成這樣的工作。

Note: 我們建議將"pmwiki-x.y.z"這個資料夾名稱改成簡短的"pmwiki".

3. 建立資料夾

在大部分的情況下，PmWiki會自動執行這個動作。

使用瀏灠器開啟server上的pmwiki.php (意指不在你本機電腦上的檔案。或者是用以file://...開頭的 URL 網址的方式開啟的檔案也不行)。 PmWiki會掃描你的系統設定，並且提供接下來的指引(若是需要的話)來建立一個wiki.d/資料夾，資料夾內將存放你的wiki頁面。

有另外的兩種方法可以完成這個動作(使用 Filezilla 或是 WinSCP來更改FTP的檔案/資料夾權限)

3a. 你也可以手動新增wiki.d/資料夾，並設定完整寫入的權限(就是"chmod 777 wiki.d")。當你在"安全模式" 時，可以使用這個方法。

3b. 在某些系統中，你可以暫時性地更改含有 pmwiki.php資料夾的權限為2777，讓PmWiki建立wiki.d/資料夾。在Unix系統中，通常可以用含有pmwiki.php的資料夾，並且輸入下列指令：

chmod 2777 .

(注意末尾的".")

chmod在許多FPT程式中也有支援。使用這個方法來建立wiki.d/資料夾可以： (1)使此資料夾可以被寫入，這使得web server可以建立放置wiki檔案的資料夾(2)保存使用的權根，這樣使安裝者可以控制資料夾內的檔案(3)使server上的其它使用者無法更改 wiki.d/資料夾中的檔案。

在建立好了資料夾權限後，請再用瀏灠器開啟 pmwiki.php檔案一次。若是成功的話，wiki.d 將會被建立，而你可以看到預設的首頁。

重要： 若是您使用3b的方法。你應該使用"chmod 755 ."指令，重新設定含有pmwiki.php的資料夾權限

4. 初始化

請參見初始運行來調整您的 PmWiki安裝。您也可以在版本訊息中得到進一步的資訊。

5. 設定語言

若您想要使用不同語言的 PmWiki，請參見國際化，並下載Zip壓縮型式的語言包(i18n-all.zip)。下載頁面為：http://pmwiki.org/pub/pmwiki/i18n/。下載完成後，解壓縮檔案，並放置於wikilib.d/資料夾。除了有 -all 的檔案(包含所有語言)，您也可以只下載您所屬地區的語言包檔案。

目前所提供的語言有：

Chinese (Traditional)

在每個語言包壓縮檔中，有二個資料夾，scripts 和 wikilib.d。把這兩個資料夾中的檔案複製到你的PmWiki的相對應之 scripts 和 wikilib.d 資料夾中。

例如，想要安裝法語的語言包，就要把 PmWikiFr.* 和 PmWiki.*中的內容放在你PmWiki的 同名的 資料夾中。

要啟用所安裝的語言，要在 local/config.php 中增加新的指令，例如： XLPage('fr','PmWikiFr.XLPage'); 將會載入法語的 PmWikiFr.XLPage

更多詳細的資料可以參見國際化。

注釋

在PmWiki的發行套件中，我們刻意地不包含index.php這個檔案。但是你可以輕易地增加你自已的"wrapper script"在資料夾中來當作pmwiki.php。方法是新增一個檔名為index.php的檔案，在這個檔案中寫入一行指令(請僅記" ?>"的符號是緊連著的)
<?php include_once('pmwiki.php');

請不要試著將pmwiki.php 重新命名為 index.php 。因為若是你這麼做的話，在更新時這個檔案就沒有辦法被更新到了。

在上面的步驟二中，若是你使用的是 Unix 系統中的tar 指令來解壓縮檔案，請確認解壓縮的檔案有足夠的讀寫權限，讓 webserver 可以讀寫它們。要確認這一點，通常你可以在解壓縮tar檔案之前，輸入 umask 002指令。
當你想要在windows上安裝時，你可以參考Cookbook:SimultaneousEdits來啟用 simultaneous edits。
有關於其他的幫助可以考 Troubleshooting

參見：

我可以將pmwiki.php 重新命名為 index.php嗎？

我們不建議將 pmwiki.php 給重新命名，我們建議新增一個名為index.php的檔案，內容只含以下一行指令：

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

我要如何將 pmwiki.php設置為網站的預設頁面呢？

建立一個名為index.php 的檔案，把PmWiki的程式於一個子目錄中運行(例如pmwiki/) 然後把index.php檔案放置於此網站的母目錄(網站的主資料夾)。index.php中含有下列一行指令：

<?php chdir('pmwiki'); include_once('pmwiki.php');

Note:你必須明確地設定 $PubDirUrl 變數(例如"http://example.com/pmwiki/pub")，它在local/config.php 檔案中。

我要如何啟用"Clean URLs" 來讓網址變得較短，而且可以明顯地顯示出這是連到我的wiki頁的呢？為什麼 pmwiki.org的頁面看起來像使用資料夾的結構，而不是以 "?n=pagename" 的形式來呈現網址呢？

請參見：Cookbook:CleanUrls

我可以將 wiki.d 資料夾移動到/tmp/persistent/foo/wiki.d (以新的 sourceforge rule)？

Sourceforge建議將所有的資料移動到/tmp/persistent/new-folder-of-your-choice/ 並設置 symbolic link 到新的資料夾： /tmp 。這是可行的-- 請參見Cookbook:SourceForgeServers.

我要如何在獨立的(例如離線的、可攜式設備)設備上運行 PmWiki ？

請參見Cookbook:Standalone(中文簡介：獨立運行) 或是 Cookbook:WikiOnAStick。