view release on metacpan or  search on metacpan

lib/CGI/Kwiki/Pages/zh_cn.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_cn.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>

请依你的实际需要加以调整。

^== 同时参见： ==