view release on metacpan or  search on metacpan

lib/CGI/Kwiki/Pages/zh_tw.pm  view on Meta::CPAN

See http://www.perl.com/perl/misc/Artistic.html

=cut

__布萊恩英格森__
"Ingy" 布萊恩英格森 (Brian Ingerson) 是 Perl 狂熱份子，同時也是 [CPAN http://search.cpan.org/author/INGY/] 模組的作者之一。他所撰寫的模組，包括了妳正在使用的 Wiki 系統，也就是 CGI::Kwiki 。

他的夢想是看到所有使用 /靈巧程式語言/ (Perl, Python, PHP, Ruby) 的社群都合作無間。他正試著以下列的方法來達成這個夢想:

* [YAML http://www.yaml.org]
* [FreePAN http://www.freepan.org]
* [FIT http://fit.freepan.org]
* [Moss http://moss.freepan.org]

妳可以透過下列的管道聯絡到他:
* ingy@cpan.org
* irc://irc.freenode.net/kwiki
__首頁__
*恭喜*! 你已經建立起一個新的 _快紀_ 站台了.

現在妳所看到的是 *預設的* 首頁. 妳應該 /馬上/ 就修改這一頁的內容.

請按底下的編輯按鈕.

妳也可以在 config.yaml 檔案裡新增一個[快紀標幟圖片]，這張圖片將會出現在每一頁的左上方.
----
如果妳現在就需要關於快紀用法的協助，請查看[快紀說明索引].
__關於快紀__
CGI::Kwiki 是一個簡單但強大的 Wiki 環境，這是用 Perl 撰寫而成、並以 CPAN 模組的形式散佈的套件。這套系統是由[布萊恩英格森]所寫的.

*妳所使用的 CGI::Kwiki 版本是 [#.#]* 
  - 有某些更新

0.17 版的變更:
  - 開始支援 RCS 了!!!
  - 修改了判斷 Wiki 鏈結的正規表示式，讓它能夠處理鏈結裡的 '_' 字符
  - 把 html 和 css 模版都清理了一輪（多謝 AdamTrickett ）
  - 支援 template/local/ 目錄
  - 新增了編輯用的登入按鈕
  - 在導覽列加入了部落格
  - 從本地時間改成國際標準時
  - 在近期更新頁面中加入了時間

0.16 版的變更:
  - 能夠使用頁面隱私權（公開、保護、私人）
  - 支援管理者登入
  - 快紀部落格終於實現了
  - 網址能夠使用大寫字母的副檔名了 (.GIF)
  - 以空自串搜尋的時候會顯示站台索引（感謝 JoergBraukhoff ）
  - 在搜尋結果頁面裡，會以 'Search' 來當作 page_id 。
  - 在方刮號 ([) 前面的驚嘆號 (!) 會讓應該要產生的格式規則失效。
  - 抵抗瀏覽器快取（感謝 JoergBraukhoff ）
  - 現在支援 htaccess 的 $ENV{REMOTE_USER} （感謝 Pardus ）


0.15 版的變更:
  - 頁面名稱支援萬國碼 (unicode) 字符層級了
  - 搜尋功能現在會搜尋頁面名稱了
  - 搜尋功能現在用 Perl 重寫過了，而不再繼續用 grep 來搜尋
  - Cookies 的有效時間將能跨越連線期間的限制
  - 現在也可以用 ftp:// 和 irc:// 鏈結
  - 現在也讓妳能從舊的頁面直接建立新的
  - 損毀的 Wiki 鏈結會用 <strike> 加上刪除線
  - 加底線的文字格式不會對鏈結產生效果
  - 現在可以用像是 KWiki 這樣的 Wiki 鏈結
  - 支援 <H4> <H5> 和 <H6>
  - 安裝的時候可以選擇回復出廠預設值或祇進行升級安裝
  - 在 $CGI::Kwiki::VERSION 裡新增了 [#.#] 格式

0.14 版的變更:
  - 跟 mod_perl 一起運作
  - 偏好設定生效了。
  - 支援頁面的詮釋資料。
  - 最近更新會顯示出誰最後編輯了頁面。
  - 幾乎所有不是 perl 的內容現在都寫到合適的檔案裡了。
    像是 Javascript, CSS 之類的。
    這會讓這套系統更容易維護及延展。
  - 支援 mailto 鏈結和內嵌程式碼。
  - 加入了 https 鏈結。這得感謝 GregSchueler 。
  - ':' 可以用於頁面名稱了。這是由 JamesFitzGibbon 所建議的。
  - 修正了由 MikeArms 所回報的 Javascript 瑕疵。
  - 修正了 CGI 參數中的安全性漏洞。這是由 TimSweetman 所回報的。
  - HeikkiLehvaslaiho 修正了由於 Emacs 所產生的人為瑕疵
  - 清掉了多餘的 <p> 標籤。這是由 HolgerSchurig 所回報的
__備份快紀__
快紀 (Kwiki) 能夠備份每一次的頁面變更，所以妳可以很輕易地就把每一個頁面回復成早先的版本。目前唯一的備份模組是 CGI::Kwiki::Backup::Rcs ，這個模組使用 RCS 來備份。大致上任何當前的 Uni...

[備份快紀]預設並不會啟用。如果妳要啟用這個功能的話，請編輯妳的 config.yaml 檔案，然後加入這一列：

    backup_class: CGI::Kwiki::Backup::Rcs
__快紀部落格__
[快紀部落格]讓妳能把任何的 Wiki 頁面都轉為部落格頁面。在這之前妳得先啟用[快紀隱私權]功能，而且也必須先以站台管理者身份登入纔行。

請點選[這裡 http:blog.cgi]來看看[快紀部落格]功能是否已經運作無誤了。
__自訂快紀__
基本上整個快紀站台有三個不同的自訂層級。以下讓我們從最簡單的開始討論：

^=== 修改組態檔案

^=== 修改模版/CSS

在妳的快紀安裝目錄理會有兩個子目錄，它們包含著控制妳網頁樣式呈現的檔案：

* [=template]
* [=css]

你可以任意地修改這些 html 和 css 檔案。最好的作法是先把這些檔案複製到 [=local/template] 和 [=local/css] 目錄裡再進行修改。這麼一來妳對這些檔案的變更就不會被日後執行 [=kwiki-install --upgrade...

^=== 修改 Perl 程式碼
__快紀功能__
CGI::Kwiki 的整體設計目標是保持 /簡明/ 和 /擴展性/。

就算如此，快紀還是內建了一些幾乎其他 Wiki 所沒有的強大功能：

* [快紀隱私權]
* [快紀投影片展示]
* [快紀部落格]
* [快紀姊妹站]
* [快紀熱鍵]
* [快紀訂做]

lib/CGI/Kwiki/Pages/zh_tw.pm  view on Meta::CPAN

多列或含有複雜資料的表格：
| <<END | <<END |
這項資料是垂直的 | bars |
END
# 這是一些 Perl 程式碼：
sub foo {
    print "我要快紀!\n"
}
END
| foo | <<MSG |
如妳所見，我們正在使用
Perl 的即席文件語法。
MSG
  | <<END | <<END |
  這項資料是垂直的 | bars |
  END
  # 這是一些 Perl 程式碼：
  sub foo {
      print "我要快紀!\n"
  }
  END
  | foo | <<MSG |
  如妳所見，我們正在使用
  Perl 的即席文件語法。
  MSG
__快紀說明索引__
CGI::Kwiki 是一套簡單但強大的 Wiki 環境；它是由[布萊恩英格森]用 Perl 撰寫而成的，並以 CPAN 模組的形式加以散佈。

^=== 快紀基礎

* [安裝快紀]
* [升級快紀]
* [快紀功能]
* [快紀文字格式語法]
* [快紀導覽]

^=== CGI::Kwiki 開發

* [關於快紀]
* [快紀待辦]
* [已知的快紀瑕疵]

^=== 組態快紀站台

* [自訂快紀]
* [備份快紀]

^=== CGI::Kwiki 類別/模組文件

* [快紀模組]
* [快紀驅動模組]
* [快紀組態模組]
* [快紀YAML組態模組]
* [快紀文字格式模組]
* [快紀資料庫模組]
* [快紀描述資料模組]
* [快紀顯示模組]
* [快紀編輯模組]
* [快紀模版模組]
* [快紀CGI模組]
* [快紀Cookie模組]
* [快紀搜尋模組]
* [快紀更動模組]
* [快紀偏好模組]
* [快紀新建模組]
* [快紀頁面模組]
* [快紀樣式模組]
* [快紀腳本模組]
* [快紀Javascript模組]
* [快紀投影片模組]
__快紀熱鍵__
*快要寫出來了*

快紀定義了一些特別的按鍵，妳在任何時候都可以使用這些熱鍵，用來輔助[快紀導覽]的功能：

* t - 最上層頁面
* r - 最近更動
* 空白鍵 - 下一個最新的頁面
* e - 編輯
* s - 儲存
* p - 預覽
* h - [快紀說明索引]
* ? - [快紀熱鍵]
* ! - 隨機的快紀頁面
* $ - 捐錢給快紀計畫
__安裝快紀__
^== 安裝快紀站台 ==

瞬間就可以把快紀裝起來。

首先：
* 從 [CPAN http://search.cpan.org/search?query=cgi-kwiki&mode=dist] 下載及安裝 CGI::Kwiki 模組
* 跑一份 Apache 網頁伺服器。

其次：
* 在妳的 Apache 的 cgi-bin 目錄裡再新增一個目錄。
* 進入這個目錄然後執行：

  kwiki-install

第三：
* 把妳的網頁瀏覽器祇到這個新的路徑去。
* 賀！現在你在幾秒內就設定好 Kwiki 了！
----

^== Apache 組態 ==

以下是一段 Apache 組態範例，可能可以幫上忙。

  Alias /kwiki/ /home/ingy/kwiki/
  <Directory /home/ingy/kwiki/>
      Order allow,deny
      Allow from all
      AllowOverride None
      Options ExecCGI
      AddHandler cgi-script .cgi
  </Directory>

請依妳的實際需要加以調整。

^== 同時參見： ==