如何使用LocalSettings.php文件自定义MediaWiki

来自菜鸟教程
跳转至:导航、​搜索

介绍


MediaWiki 是一个开源 wiki 应用程序,它允许您创建可自定义的 wiki 站点。 最初由 WikiMedia Foundation 为满足 Wikipedia 的需求而开发,可适用于个人和小型组织。

本指南假定您已经在您的 VPS 上安装了 MediaWiki,并且已经使用您的 Web 浏览器完成了初始配置步骤。 如果不是这种情况,请按照此处的说明 安装 MediaWiki

在之前的指南中,我们在 Ubuntu 12.04 上安装了 MediaWiki。 在本文中,我们将介绍一些可以通过 LocalSettings.php 文件完成的基本配置。

您可以通过 Web 界面编辑首选项吗?


尽管可以通过普通的 wiki Web 界面管理许多首选项更改和站点管理任务,但有些更改需要在服务器上编辑文本文件。

作为安全措施,无法从 Web 界面访问 LocalSettings.php 文件。 要编辑该文件,请通过 SSH 连接到您的 VPS 以便手动编辑该文件。

MediaWiki 在哪里存储默认值?


默认设置保存在一个名为 DefaultSettings.php 的文件中。

您永远不应该编辑 DefaultSettings.php,但查看它可能非常有价值。 由于我们不会编辑文件,因此在寻呼机中打开它:

less /etc/mediawiki/includes/DefaultSettings.php

如果您在此文件中看到要更改的值,请记下它。 稍后,您可以将该值添加到 LocalSettings.php 文件中。

如何编辑默认值?


配置应在 LocalSettings.php 文件中完成。 它看起来与 DefaultSettings.php 非常相似,但更短。 键入以下命令以打开文件进行编辑:

sudo nano /etc/mediawiki/LocalSettings.php

该文件是用 PHP 编程语言编写的,但语法相对容易理解。 在大多数情况下,您将看到以下语法:

$变量名=“变量值”;

此文件具有许多不同的配置设置,但并非所有可用设置都在此处定义。 通常,只有那些值与 DefaultSettings.php 中的默认值相矛盾的设置才会在此处找到。

如果您想更改在 DefaultSettings.php 中找到的任何设置,请在 LocalSettings.php 中查找变量。 如果不存在,则将其添加到底部。

常用配置设置


在进行任何更改之前,请继续备份配置文件,以防出现预期不正常的情况:

sudo cp /etc/mediawiki/LocalSettings.php /etc/mediawiki/LocalSettings.php.bak

重新打开 LocalSettings.php 文件以编辑以下值。

sudo nano /etc/mediawiki/LocalSettings.php

如何更改站点名称


您在初始配置期间为您的站点选择了一个名称。 您可以通过编辑两个变量来更改站点名称:wgSitenamewgMetaNamespace

 $wgSitename = “新站点名称”;  $wgMetaNamespace = “ New_Site_Name ”;

第二个变量为引用 wiki 本身的页面设置名称空间。 它不能包含空格,所以我们使用下划线代替。

如何更改网站语言


如果您需要更改站点的语言编码,可以修改 wgLanguageCode 变量的值:

$wgLanguageCode = “语言代码”;

此实例中的“language_code”指的是此文件中定义的任何值:

less /etc/mediawiki/languages/Names.php

更改语言后,您需要运行脚本来实现更改:

cd /etc/mediawiki/maintenance
sudo php rebuildmessages.php --rebuild

如何允许图片上传


在我们允许在 wiki 上上传图片之前,我们想从“imagemagick”套件中安装一些额外的图片处理软件:

sudo apt-get install imagemagick

重新打开 LocalSettings.php 文件。

sudo nano /etc/mediawiki/LocalSettings.php

要允许您的 wiki 用户将自己的图像上传到页面,您可以将 wgEnableUploads 变量更改为“true”:

$wgEnableUploads = true;

取消注释接下来的两个变量以将 MediaWiki 配置为使用 imagemagick 来调整图像大小、转换和操作。

$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";

这些设置将使用户能够使用缩略图进行上传。

默认情况下,这些设置允许以“png”、“gif”和“jpeg/jpg”格式上传。 如果您想允许其他格式,请将 wgFileExtensions 变量添加到文件底部,如下所示:

$wgFileExtensions = array('png', 'gif', 'jpg', 'jpeg', ' pdf ', ' additional_format ', ' … ')

注意:任何接受用户内容的网站都存在一定程度的风险! 确保您了解允许用户上传的含义,并采取适当的措施来减轻这些危险。

如何允许 WikiCommons 图像


您可能希望设置为“true”的另一个变量是 wgUseInstantCommons

这允许您的 wiki 自动配置对 Wikimedia Commons 中内容的访问。 这些可以合并到您自己的页面中。

$wgUseInstantCommons = true;

要使用来自 Wikimedia Commons 的图像,请在以下位置找到您想使用的图像:

http://commons.wikimedia.org/

导航到您的图像。 在 URL 中,从 File: 复制到 URL 的末尾。

[[File:“%3Ca]] https://assets.digitalocean.com/articles/mediawiki_config/wikimedia_url.png ” alt =“MediaWiki 文件 URL” />

现在,打开或编辑页面,只需将您复制的内容粘贴在双括号内

[[File:Parson_Russell_Terrier_Puppy_3_Months_Old.jpg]]

该图像将在您的页面上可用。

如果您想制作缩略图,请在文件名后面加上竖线字符 (|) 和“thumb”。

[[File:Parson_Russell_Terrier_Puppy_3_Months_Old.jpg|thumb]]

WikiMedia 图像将显示在您的 wiki 上:

[[File:“%3Ca]] https://assets.digitalocean.com/articles/mediawiki_config/commons_image.png ” alt =“MediaWiki Commons 示例图片” />

如何更改 Wiki 徽标


一项通常要求的信息是如何将页面左上角的徽标更改为与您的站点相关的内容。

默认情况下,wiki 页面显示以下图像:

[[File:“%3Ca]] https://assets.digitalocean.com/articles/mediawiki_config/default_logo.png ” alt =“MediaWiki 默认徽标” />

首先,将要用作徽标的文件复制到 VPS 上的相应目录中:

scp /path/to/local/image.png用户名@server_ip :/etc/mediawiki/skins/common/images/

现在,您的 wiki 服务器上已拥有该图像。 更改 wgLogo 的路径以反映图像名称:

$wgLogo = "$wgStylePath/common/images/ image_name.png

您的徽标现在将替换以前的消息。

如何配置电子邮件选项


要接收管理电子邮件,包括错误报告,请在 wgEmergencyContact 变量之后包含您的电子邮件。

 $wgEmergencyContact = “ your_email  @地址 .com ”

您还需要将 wgPasswordSender 电子邮件配置为指向实际的电子邮件地址,以便用户在遇到问题时可以回复电子邮件。

 $wgPasswordSender = “密码_电子邮件 @地址 .com ”

结论


您现在应该知道如何配置位于 LocalSettings.php 文件中的一些常用设置。

默认情况下,LocalSettings.php 中不存在许多可用于 MediaWiki 的配置设置。 请记住阅读位于 /etc/mediawiki/includes/DefaultSettings.php 的默认设置文件以发现更多配置选项。 该文件的评论很好。 更多关于特定变量的信息可以在这里找到。

贾斯汀·艾林伍德