Manual:Running MediaWiki on Debian or Ubuntu/zh

这个页面讲解如何在Debian GNU/Linux或Ubuntu服务器上安装MediaWiki. 下面是以Debian为例进行说明，也适用于Ubuntu和Raspbian，不一样的地方会特别标明.

介绍
该安装过程需要知道从终端发出命令（例如安装应用程序）和使用文本编辑器（例如图形：gedit、kate；文本：nano、emacs、vim）.

当需要进行文本编辑时，可以通过按Alt-F2并键入来在图形桌面上执行

gksudo gedit 文件名

或者，可以从终端进行编辑

sudo nano 文件名

当然，可以使用kate代替gedit或vi/emacs而不是nano.

确保您的Debian系统是最新的
通过运行来仔细检查Debian是否是最新的：

or in one line

安装LAMP软件栈
Ubuntu使LAMP（Apache、PHP和MySQL）在安装过程中可供安装. 在安装步骤中，请确保选择安装LAMP服务器. 或者，您可以使用以下命令从标准安装中安装所有这些软件包：

可选的有用软件包
这些包不是必需的，但可能有用，具体取决于安装：

你可以通过 安装以上的任意一个包.

如果你想安装所有这些： 如果安装php-apcu，则必须重新加载apache配置，以避免在运行配置脚本时出现警告消息：

安装MediaWiki
这可以通过浏览器或命令行完成
 * 下载官方压缩包.

cd /tmp/ wget https://releases.wikimedia.org/mediawiki//mediawiki-.tar.gz


 * 解压到你的Web目录里

配置MySQL
但在继续安装最初的MediaWiki之前，您需要先执行某些步骤！

你不得不：


 * 创建一个新的mysql用户（new_mysql_user）：

#sudo mysql -u root -p并输入mysql root用户的密码（如果你没有配置密码，它将为空，所以只需按回车键）

mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED'; mysql> quit;


 * 创建一个新的mysql数据库my_wiki：

# sudo mysql -u root mysql> CREATE DATABASE my_wiki; mysql> use my_wiki; Database changed


 * 授予新的mysql用户访问新创建的mysql数据库my_wiki：

mysql> GRANT ALL ON my_wiki.* TO 'new_mysql_user'@'localhost'; Query OK, 0 rows affected (0.01 sec) mysql>quit;

可选操作：配置PHP
编辑你的 PHP 配置文件，php.ini. 在Ubuntu Trusty和Debian Jessie上，这个文件位于.

On Ubuntu Xenial and Debian Stretch (PHP 7), it is located at.

最大上传文件大小
假设要将各种文件上传到Wiki作为内容，则必须调整上传文件的最大大小限制. 大约在文件上传小节的下半部分. 修改以下语句： 将上传大小上限调整到至少20M. 将来你需要上传更大的文件时，你可能需要再次调整这个值.

内存限制
一些 PHP 脚本运行时需要很多内存. 要增加脚本可以使用的最大内存量，请向下翻页约21％，并从中更改以下条目（如果找到） 到 如果已设置为128M或更高，请保持原样.

配置MediaWiki
将浏览器导航到http://localhost/mediawiki（对于某些安装，可能是http://localhost/mediawiki/config或http://wiki.hostname.com/config），并按照给定的步骤进行操作.

If this gives a 404 error then working a symbolic link should solve it:

sudo ln -s /var/lib/mediawiki /var/www/html/mediawiki

This can solve a lot of problems by specifically identifying the source of any errors.
 * Pay close attention for "Checking environment..." in MediaWiki installation script.

It may complain that php extensions like mbstring and xml are missing even you have installed them. Please manually activate them by using:

sudo phpenmod mbstring sudo phpenmod xml sudo systemctl restart apache2.service

Fill out all the field in the configuration form and press to continue button. You will have to use your username and password provided in the mysql configuration section:

mysql> CREATE USER 'new_mysql_user'@'localhost' IDENTIFIED BY 'THISpasswordSHOULDbeCHANGED';

Under Database Config, you may change the database name and DB username to new values, but you must turn on "Use superuser account", name: debian-sys-maint giving the mysql root password you configured earlier.

The configuration process will prompt you to download a LocalSettings.php that must be saved to the parent directory of the new wiki. The configuration page will give the exact directory/filename that must be moved:

sudo mv ~/Downloads/LocalSettings.php /var/lib/mediawiki/

And navigate your browser to http://localhost/mediawiki (or http://server_ip_address/mediawiki or  http://server_ip_address/mediawiki/index.php) to see your new wiki.

完成！ 你现在有了一个可正常运行的 Wiki

基本信息
MediaWiki is configured by the LocalSettings.php file, usually found in. has detailed information that may be useful. The following are changes that appear to be universally helpful

To edit LocalSettings.php use

gksudo gedit /var/lib/mediawiki/LocalSettings.php

or from a terminal

sudo nano /var/lib/mediawiki/LocalSettings.php

文件上传
参见.

更改 Logo
参见.

MediaWiki 扩展
The current tarball for MediaWiki comes with a package of 15 or so of the most popular extensions, but there are literally hundreds more.

Instructions on how to enable extensions can be found at.

美化 URLs
To use /wiki/* instead of /wiki/index.php/* on Debian, follow the recommended short URL guide using  as the script path instead of   and placing the rewrites in /etc/apache2/conf-enabled/mediawiki.conf.

參見

 * Canonical maintains a MediaWiki page with more information
 * Debian MediaWiki page
 * Ubuntuguide.org provides detailed instructions for setting up MediaWiki on Ubuntu and Kubuntu, including multiple wikis and nested subwikis.
 * Start to end Mediawiki Setup Guide at ofswiki.org, closely referencing official docs, support for multiple distros including Debian/Ubuntu, automation and a minimal style