Matrix Product Toolkit | PmWikiZhCn / PmWiki安装手册

这个页面将介绍如何下载安装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这样的目录中)。

注意：建议你把"pmwiki-x.y.z"文件夹重命名为类似"pmwiki" 或"wiki"这样简洁好记的名字。

3. 新建目录

大多数情况下PmWiki为你自动新建目录。打开类似http://example.com/wiki/pmwiki.php这样的网址（此处以安装PmWiki在域名“wiki”子目录为例），你的wiki.d/ 文件夹就会自动被创建了。

这里有两个免费的Ftp工具： Filezilla和WinSCP来供你上传使用。

3a. 你也可以自己新建wiki.d/文件夹，并给它"777"可写权限。

3b. 在有些系统（Unix）中，你可能需要给wiki.d/和pmwiki.php 设置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。