PmWiki 安裝指南

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

以下是相關的頁面：

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

安裝 PmWiki

1. 下載

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

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

2. 解壓缩

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

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

目前所提供的語言有：

Česky (Czech) Arabic Bulgarian Català Chinese (Traditional) Chinese simplified Dansk Deutsch English Español Esperanto Farsi (Persian) Français Greek Indonesian Italiano Japanese Korean Latviešu (Latvian) Lietuvių (Lithuanian) Macedonian Magyar (Hungarian) Nederlands Norsk Polski Portuguese Portuguese (Br) Românã Russian Shqip Slovenčina Slovenščina Suomi Svenska Türkçe Tamil Ukrainian Việt ngữ

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