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

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

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

目前所提供的語言有:

在每個語言包壓縮檔中,有二個資料夾,scriptswikilib.d。把這兩個資料夾中的檔案複製到你的PmWiki的相對應之 scriptswikilib.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