这个页面将介绍如何下载安装PmWiki。
简单的来说:初次安装PmWiki,请上传PmWiki文件,复制“docs/”目录下的"sample-config.php"文件到“local/”目录下,并改名为“config.php”。
- 上传PmWiki文件到您的空间、服务器。
- 复制“docs/”目录下的"sample-config.php"文件到“local/”目录下,并改名为“config.php”。此时您就可以看到一个可访问的wiki了。
- 参照:初始化配置文档来初始化PmWiki。
- 进行一些“进阶”设置。
- 如果出现问题,请先确认您的“wiki.d/”目录可写。Linux需要设置755权限。对,您的wiki页面文件默认就存放在这儿。
- 千万不要把“PmWiki.php”直接改名为“index.php”。正确的做法是新建一个“index.php”文件,并加入这段
<?php include_once('pmwiki.php');
代码。对于国内的朋友,更为适合的做法是,采用伪静态化处理。详见:伪静态化页面。
这里有一些相关页面:
- 环境要求 - 一般的服务器配置环境通常可以满足PmWiki运行。
- 升级 - 如何更新现有的PmWiki。
- Wiki Farms - 在同一个PmWiki下安装多个“子Wiki”。
- 更新日志 - PmWiki更新日志。
注意 如果您有疑问,请直接通过PmWiki邮件列表?咨询或通过问题跟踪系统反馈。
PmWiki安装
1. 下载
下载一个稳定版PmWiki压缩包。
- zip压缩包 (pmwiki-latest.zip)
- gzipped包 (pmwiki-latest.tgz)
下载最新测试版请参阅:Sub版本页面。
2. 解压缩
对(pmwiki-latest.tgz
或pmwiki-latest.zip
)进行解压缩。你将会得到一个最新版本的PmWiki文件夹,他们通常包括下面内容:
README.txt 须知,一篇介绍文档 pmwiki.php PmWiki核心文件 local/ 配置文件夹(包含大量配置文件) cookbook/ 插件文件夹,你可以通过插件列表下载到 docs/ 简短的文档说明,同时包含一个叫“sample-config.php”简单的配置文件示例,初次安装,你需要把它改名为“config.php”,并移动到“local/”目录下 pub/ 公开的文件 pub/css/ 额外的CSS样式表文件[1] pub/guiedit/ 包含有自带编辑器图片、样式的文件夹 pub/skins/ 主题文件夹,详见:custom scripts/ PmWiki的部分脚本 wikilib.d/ 包含PmWiki自带文档的页面,你可以直接在自己网站上学习它。
通常情况下,解压PmWiki压缩包后,你会得到一个类似pmwiki-x.y.z格式的文件夹。你需要将它上传至你的网站空间中。(例如上传至 网站空间的public_html这样的目录中)。
3. 新建目录
大多数情况下PmWiki为你自动新建目录。 打开类似http://example.com/wiki/pmwiki.php这样的网址(此处以安装PmWiki在域名“wiki”子目录为例),你的wiki.d/ 文件夹就会自动被创建了。
这里有两个免费的Ftp工具: Filezilla和WinSCP来供你上传使用。
777
"可写权限。
2777
权限。
重要: 通常情况下,你只需要将“wiki.d”设置成"755
"权限就可以了
如果PmWiki不工作,你也可以试试给pmwiki.php设置755权限。
4. 初始化配置
请参阅:初始化配置来设置PmWiki。你也可以阅读发行说明?了解更多信息。
5. 安装中文语言包
如果您需要中文语言包。
- 请从语言包列表中选择(i18n-zhcn.zip(中文语言包))下载,并按照语言包安装手册进行安装。
- 在中文语言包中,有“scripts”和“wikilib.d”两个文件夹。覆盖到应的PmWiki目录中就可以了。
- 请在配置文件“local/config.php”中添加一行
XLPage('zhcn','PmWikiZhCn.XLPage');
就可以了。更详细的语言包安装教程详见:中文语言包。
注意
- PmWiki文件默认是不包含index.php 文件的。你无需重命名pmwiki.php,只需新建一个index.php 并添加下面一行代码就可以了(不要忘了这个"
?>
"闭合标签):<?php include_once('pmwiki.php');
不要把pmwiki.php 直接改名成index.php 是因为这么做不利于你的后续版本升级。而且更加符合国人的办法,其实是直接开启“伪静态化”。
- 当你需要将PmWiki安装在Windows系统中时,请参考Cookbook:SimultaneousEdits来开启simultaneous edits?。
- 需要更多帮助请参考常见故障解答。
扩展阅读:
我可以把pmwiki.php改名为index.php吗?
不可以,正确的做法是新建一个“index.php”文件,并加入一下代码。
<?php include_once('pmwiki.php');
如何开启伪静态化?
详见:伪静态化页面。
我可以离线使用本地便携版的PmWiki吗?
当然可以,请参阅:本地桌面离线版页面或Cookbook:WikiOnAStick。