• View
• Edit
• Rename
• History
• Print
• Backlinks

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.25的資料夾。 此資料夾的內容包括：

  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 指令都可以完成這樣的工作。

3. 建立資料夾

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

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

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

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 的檔案(包含所有語言)，您也可以只下載您所屬地區的語言包檔案。

目前所提供的語言有：

在每個語言包壓縮檔中，有二個資料夾，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

參見：

• Cookbook:PHP
• Cookbook:InstallOnIIS