*[[關於 PukiWiki 的資訊>關於 PukiWiki]] [#o8b217db] -您可以在本頁取得關於 PukiWiki 的中文相關資訊。所有的文件翻譯可能是由不相干的人一起翻譯的。所以,若您發現到有任何錯誤或是不自然的表達方式,不用客氣 ,請直接幫忙更正。您知道的,這是 Wiki 系統的主要優點之一。 -您可以在[[這裡>pukiwiki.tw:About PukiWiki]]取得關於本頁面的最新資訊。 #contents **簡介 [#c0fc630a] -PukiWiki 是一個以網頁為基礎的工具,可以讓網頁瀏覽者自由的新增及刪除頁面,並且能夠編輯頁面的內容。它可以像網頁論壇或討論區一樣,讓瀏覽者可以自由的發佈公告或是文章。但 PukiWiki 還允許您可以自由的去變更某個已存在頁面的內容,相較於網頁論壇或討論區,則僅能新增或回覆訊息而已。 -PukiWiki 最初是由日本的 sng 先生所開發,而目前則是由 "PukiWiki 開發團隊" 接手維護及開發。 -PukiWiki 是移植自 Hiroshi Youki 先生所開發的 PHP 版本的 WikiWikiWeb -- YukiWiki。目前已從 YukiWiki 獨立出來,並命名為 PukiWiki,且功能正逐漸擴充及增加中。 -它就像是 YukiWiki + Tiki + RWiki 三套的綜合體。 PukiWiki = (YukiWiki + Tiki + RWiki) / 3 -您可以使用插件(Plugins)自由的擴充 PukiWiki 的功能。而且,還有很多並沒有被包含在標準插件內的插件,這些都有被列表出來,您可以 "盡情的去嚐試它!" **特色 [#vd4654ae] -使用 PHP 語言撰寫。 -支援雙位元組的字元,包含漢字(中文字)。 -支援 InterWiki 的功能。 -支援定期備份的功能。 -具有簡單的權限控管功能。 -具有簡單的網誌(Weblog)功能。 -所有的資料都以純文字檔的格式儲存。(二進位的檔案,可以附加在任何頁面中。) -不需要用到資料庫,僅需要用 PHP 的支援即可,安裝方便快速。 -以 GPL 版權的方式發行。 **開發網站 [#tc96c3e4] -點進 [[pukiwiki.dev>dev:FrontPage]] 將帶領您到開發團隊的 Wiki 頁面去。 **版本狀態及下載 [#g6bbfb18] :版本狀態| 目前最新版本為 1.4.3 Release。~ 請參閱 [[開發日記>dev:開発日記]]。 :最新版本| 1.4系列 (XHTML 1.1) - 1.4.3~ 1.3系列 (HTML 4.01 transitional) - 1.3.7 ***下載 [#h9c09f95] -[[日本官方下載網頁>PukiWiki/Download]] -[[繁體中文版下載網頁>pukiwiki.tw:FrontPage#content_1_3]] **安裝需求 [#l70f4d3a] -PukiWiki 是使用 PHP 語言所撰寫,因此,需要 PHP 的環境。建議使用 PHP 4.1 或以上的版本。 -若要使用 multibyte 的功能,則需要 PHP 的 multibyte extension。 **安裝 [#af6883ea] ***Un*x 平台 [#c3adeb71] -請先至 "[[下載頁面>PukiWiki/Download]]" 下載所需的程式。 -將其解開放到您的網頁目錄底下。 -修改檔案及目錄的相關權限。若您下載的是繁體中文版,請直接執行裡面的 Install.sh 程式。(若有必要,請先視您的狀況調整 Install.sh 檔案的內容) ***Windows 平台 [#k738bace] -繁體中文版請參考 [[這裡>pukiwiki.tw:WinInstallHowto]]。 **個人化的設定與調整 [#gc95284a] -繁體中文版請參考 [[這裡>pukiwiki.tw:PukiWiki/Configuration]]。 ***UTF-8 編碼的問題 [#q88f27a7] -由於繁體中文版的 PukiWiki 所有的檔案都是使用 UTF-8 的編碼方式儲存,因此,您在編輯檔案(如 pukiwiki.ini.php)時,可能看到的會是亂碼。若您使用的是 vi/vim 編輯器的話,可以在 ~/.vimrc 設定檔中加入底下幾行即可: set encoding=utf-8 set fileencodings=ucs-bom,utf-8,big5,latin1 set fileencoding=big5 set termencoding=big5 -若是使用 gedit 編輯器,應該可以直接看到中文,並正常編輯。 -至於在 Windows 系統上,可以使用 UltraEdit 編輯器來編輯。 ***進階的設定 [#q11de2df] -編輯 MenuBar,您可以自訂在左邊的選單中要顯示哪些東西。 -修改版面的配置,所有的版面配置、Skin 及 StyleSheet 等設定,都放在 skin/ 目錄底下,您可以依需求自由的調整,注意,除非您很熟悉 HTML 及 CSS 等相關語法,否則請不要隨意修改,以免造成整個版面亂掉。 **PukiWiki 程式版本的更新與升級 [#s73924ce] -繁體中文版請參考 [[這裡>pukiwiki.tw:PukiWiki/Upgrade]]。 **基本操作 [#cc9fe4ab] ***寫作語法 [#ee3c7ffb] -在開始編輯一個頁面之前,先請瀏覽一下 PukiWiki 的[[寫作語法>pukiwiki.tw:寫作語法]],好對 PukiWiki 的語法有個基本的認識。 ***新增頁面 [#tb9ab37c] -點選選單中的 "新建" 即會出現新增頁面的畫面,輸入您要新增的頁面名稱後再按下編輯即可,接下來您就可以根據寫作語法在編輯視窗中輸入您要的頁面內容。 -每一次您寫下一個 WikiName,即包含兩個以上的大小寫英文字,或是括弧名稱(使用 [[ ]] 包圍起來),那麼在該文字後面,您將會看到一個 "?",只要您點選該 "?",即會進入編輯視窗的畫面,然後您就可以根據寫作語法來建立該新頁面的內容。 ***編輯頁面 [#y44d2e4a] -在瀏覽某個頁面時,若想要編輯該頁面,只要點選選單中的 "編輯" 即會出現編輯視窗讓您修改該頁面的內容。 ***刪除頁面 [#d710e282] -想要刪除某個頁面,只要編輯該頁面,並將該頁面的內容完全清空,不留任何內容即可。 ***頁面更名 [#cd5feccf] -先瀏覽想要更名的頁面,然後再點選選單中的 "更名" 即會出現更名的畫面,輸入想要變更的名稱,,若您想把相關的頁面也一起更名,可以把該選項勾選起來,然後按下 "下一步" ,接著您必須輸入管理員的密碼才可以進行真正的更名動作。 ***複製頁面 [#vbda87ab] -先瀏覽要被複製的頁面,然後再點選選單中的 "複製" 即會出現複製的畫面,然後選好開始的那一行及結束的那一行後,再輸入複製後的頁面名稱,最後再按下建立即可。 ***封鎖及解封頁面 [#e80923de] -先瀏覽要封鎖的頁面,然後再點選選單中的 "封鎖" 即會出現封鎖的畫面,然後再輸入封鎖密碼(即管理員密碼)即可進行頁面的封鎖,讓任何人都不能夠再對該頁面進行編輯的動作。 -若要解封頁面,請先瀏覽該頁面,然後再點選選單中的 "解封" 即會出現解封的畫面,然後再輸入解封密碼(即管理員密碼)即可進行頁面的解封。 ***頁面差異 [#r2174f09] -在瀏覽某個頁面時,點選選單中的 "差異" 即會出現目前頁面內容跟前一版本之間的差異狀況。 ***上傳附件 [#b273e477] -在瀏覽某個頁面時,點選選單中的 "上傳" 即會出現上傳附件的畫面,然後再按瀏覽選擇一個檔案或是直接輸入該檔案名稱後再按下上傳即可,該上傳的檔案即變成該頁面的附加檔案,您可以在該頁面的下方找到相關的附加檔案。 -點選某個附加檔案的 "資訊" 後即會出現該檔案資訊的畫面,您可以對該附加檔案進行刪除、封鎖或解封的動作。 ***頁面索引與頁面一覽表 [#t75e1f9c] -點選選單中的 "索引" 即會列出索引的畫面。 -在索引畫面的選單中,會有一個 "一覽表" 的選單,點選 "一覽表" 後除了會列出索引的清單外,其他隱藏的頁面也會一併列出。 ***搜尋頁面 [#se94fadf] -點選選單中的 "搜尋" 即會列出搜尋的畫面,輸入要搜尋的字串後按下搜尋即可進行搜尋的動作。 ***近期更動與近期刪除 [#p5ab6d94] -點選選單中的 "新期更動" 即會列出最近有修改過的頁面。 -想要列出 "新期刪除" 的頁面,請直接連至 [[http://your.pukiwiki.site/index.php?RecentDeleted>http://localhost/pukiwiki/index.php?RecentDeleted]] 即可。 ***備份與復原頁面 [#a3e93c84] -關於頁面的備份部份,您必須要在 pukiwiki.ini.php 設定檔中去指定您的備份策略。請參考 [[PukiWiki 的設定調整>pukiwiki.tw:PukiWiki/Configuration]] 中的設定部份。 -在瀏覽某個頁面時,點選選單中的 "備份" 即會出現該頁面的備份清單,您可以去比較各版本之間的差異或是點選某一版本後方的 "復原" 即可復原成該版本的內容,當然,您還是要輸入管理員的密碼才行。 **權限管理 [#v6cce440] -這裡的權限管理部份,是針對繁體中文版的使用者才有效的。 -預設的管理者密碼、一般使用者及網誌使用者的帳號密碼都存放在 auth 目錄下的 pass.inc 檔中。您可以直接修改該檔案的內容來變更、新增或移除使用者的帳號密碼。 -關於密碼的表示方式有兩種,一種是直接使用明碼,如: md5("password"),這種表示方式由於是明碼,或許會有安全上的問題,因此,較不建議使用此方式。 -另一種方式則是使用 md5 編碼過的值,至於如何產生 md5 編碼過的值,您可以直接在瀏覽器的網址列上輸入 [[http://your.pukiwiki.site/index.php?md5=password>http://localhost/pukiwiki/index.php?md5=password]],這樣畫面上就會顯示 password 經過 md5 編碼過後的值。 ***頁面的權限控管 [#xdffcfff] -要啟用頁面的權限控管,首先您必須先在 pukiwiki.ini.php 設定檔中將底下四行前面的 "//" 註解拿掉。(請參考 [[PukiWiki 的設定調整>pukiwiki.tw:PukiWiki/Configuration]] 的相關設定) //require('wiki/3A417574682F52656164.txt'); //require('wiki/3A417574682F536F75726365.txt'); //require('wiki/3A417574682F45646974.txt'); //require('wiki/3A417574682F4261736963.txt'); -然後連到 [[http://your.pukiwiki.site/index.php?:Auth/Basic>http://localhost/pukiwiki/index.php?:Auth/Basic]] 來做基本的認證設定。 -編輯 :Auth/Basic 頁面,說明如下: --認證類型 ---可以是 "pagename" 即根據頁面名稱來認證,或是 "contents" 即根據頁面的內容來認證。範例如下: $auth_method_type = "pagename"; --頁面閱讀的認證 --- "1" 表示啟用,"0" 表示不啟用。範例如下: $read_auth = 1; ---設定檔 :Auth/Read。範例如下: '/(Secret|candyz|:Auth)/' => 'candyz', >表示 Secret 或 candyz 或 :Auth 等頁面,需要有 candyz 這個使用者通過認證才能閱讀。 --頁面編輯的認證 --- "1" 表示啟用,"0" 表示不啟用。範例如下: $edit_auth = 1; ---設定檔 :Auth/Edit。範例如下: '!:Auth/Source!' => 'editadmin', '/(FrontPage|MenuBar|:Auth)/' => 'candyz,editadmin', >第一行表示 :Auth/Source 這個頁面需要有 editadmin 這個使用者通過認證才能編輯。由於頁面名稱包含了 "/" 字元,因此,頭尾的 "/" 才改由 "!" 來取代。 >第二行則表示 FrontPage、MenuBar、:Auth 等頁面,需要有 candyz 或是 editadmin 使用者通過認證才能編輯。 --查看頁面原始碼的認證 --- "1" 表示啟用,"0" 表示不啟用。範例如下: $source_auth = 1; ---設定檔 :Auth/Source。範例如下: '/(FrontPage|Home|MenuBar)/' => 'candyz', >表示 FrontPage、Home、MenuBar 等頁面,需要有 candyz 這個使用者通過認證才能夠查看該頁的原始碼。 --頁面搜尋的認證 --- "1" 表示啟用,"0" 表示不啟用。範例如下: $search_auth = 0; **[[InterWiki>InterWikiName]] [#c008af49] -Interwiki 原來的意義為從另一個 Wiki 網站建立連結的功能。所表示的 InterWiki 可以以字串的型式連結到任何網站。而加上擴張的功能則是更為方便了,即使這幾乎已經是一個完全不同概念的功能。這個功能是移植自 tiki。 -PukiWiki 支援 InterWiki 的功能,因此,您可以編輯 InterWikiName 頁面來使用 InterWiki 的功能。 ***InterWiki 的使用方式 [#td1dd675] -首先在 InterWikiName 頁面中加入站台,例如我要把 [[CLE 網站>http://cle.linux.org.tw/]] 加入到 InterWikiName 中,請在 InterWikiName 中加入一行,如下: -[http://cle.linux.org.tw/? CLE] -然後在編輯頁面要使用 InterWiki 時,可以用如下的語法: > [[CLE:Home]] 會連到 http://cle.linux.org.tw/ 的 Home 頁面去 [[CLE:Home]] 會連到 http://cle.linux.org.tw/ 的 Home 頁面去 [[CLE 留言版>CLE:留言版]] 會連到 http://cle.linux.org.tw/ 的留言版頁面去 [[CLE 留言版>CLE:留言版]] 會連到 http://cle.linux.org.tw/ 的留言版頁面去 [[PukiWiki.tw:FrontPage]] 會連到 PukiWiki.tw 的首頁去 [[PukiWiki.tw:FrontPage]] 會連到 PukiWiki.tw 的首頁去 [[日本官方下載網頁>PukiWiki.org:PukiWiki/Download]] 會連到 PukiWiki.org 的下載頁面去 [[日本官方下載網頁>PukiWiki.org:PukiWiki/Download]] 會連到 PukiWiki.org 的下載頁面去 ***InterWiki 的擴張 [#f9f0daa6] -透過 InterWiki 的功能,還可以玩出很多的花樣呢。舉一些例子說明如下: > [[查詢 PHP strlen 函數的用法>PHP函數:strlen]] [[查詢 PHP strlen 函數的用法>PHP函數:strlen]] [[在 Google 上查詢 PukiWiki>Google:PukiWiki]] [[在 Google 上查詢 PukiWiki>Google:PukiWiki]] [[在 Google 上找林志玲的圖片>Google圖片:林志玲]] [[在 Google 上找林志玲的圖片>Google圖片:林志玲]] [[在 Google 論壇上搜尋 Fedora>Google論壇:Fedora]] [[在 Google 論壇上搜尋 Fedora>Google論壇:Fedora]] [[在站內搜尋 'PukiWiki' 這個關鍵字>站內搜尋:PukiWiki]] [[在站內搜尋 'PukiWiki' 這個關鍵字>站內搜尋:PukiWiki]] **插件(Plugins) [#r39fe226] -PukiWiki 除了有預設的插件外,還有許多人也為 PukiWiki 寫了很多好用的插件,當然,若您有興趣,也可以自己來寫自己想要的插件。 -您可以在 [[自作プラグイン]] 找到更多插件的相關資訊。 **版權 [#p70978c0] -PukiWiki 使用 [[GNU GPL/2 (GNU General Public License)>http://www.gnu.org]] 的版權宣告。 **作者 [#je5ff325] :[[PukiWiki 開發小組>dev:FrontPage]]|http://pukiwiki.sourceforge.jp/dev/ (Based on "PukiWiki" 1.3 by yu-ji) :[[PukiWiki 繁體中文化小組>pukiwiki.tw:FrontPage]] [[Chung-Yen Chang (Candyz)>Candyz]]|http://pukiwiki.kandix.idv.tw/ (Based on "PukiWiki" 1.4) **感謝 [#u327068b] -首先,要感謝所有使用 PukiWiki 的使用者以及 PukiWiki 開發小組的成員。 -另外要特別感謝 yu-ji 先生,開發了第一個版本的 PukiWiki。 -以及感謝 Hiroshi Yuki 先生願意接受我們的 YukiWiki 分支。 -以及建立最原始 WikiWikiWeb 的 Cunningham & Cunningham, Inc. **參考 [#nfc4854d] -PukiWiki 網站: http://pukiwiki.sourceforge.jp/ -PukiWiki 開發網站: http://pukiwiki.sourceforge.jp/dev/ -PukiWiki.tw 網站: http://pukiwiki.kandix.idv.tw/ -yu-ji's 網站 (PukiWiki 的原作者): http://factage.com/yu-ji/ -Hiroshi Yuki 的網站: http://www.hyuki.com/ -YukiWiki: http://www.hyuki.com/yukiwiki/ -Tiki: http://todo.org/cgi-bin/jp/tiki.cgi -最原始的 WikiWikiWeb: http://c2.com/cgi/wiki?WikiWikiWeb -另一個 WikiWikiWeb(Cunningham & Cunningham, Inc.): http://c2.com/ **迴響與討論 [#e1fc0e35] - http://pukiwiki.kandix.idv.tw/ 掛掉了,所有相關的說明、下載、頁面都失效。怎麼辦……T_T -- [[忠邦]] &new{2012-10-24 (水) 01:04:34}; - 確かに、pukiwiki.kandix.idv.tw が見られなくなっていますね。http://sourceforge.net/projects/pukiwiki-tw/ ぐらいしか、関係のありそうな場所が見つけられないです。 -- &new{2012-10-30 (火) 18:02:53}; - 我開啟了「$edit_auth = 1;」,另外設置了一個測試帳號「$auth_users = array('test' => 'test',」之後,但是按了登入之後,輸入帳號密碼為test卻還是無法登入是怎麼回事? 我的版本是PukiWiki 1.4.7(utf8) -- [[哲莫]] &new{2012-12-01 (土) 09:39:55}; #comment