手册:在 Windows 上运行 MediaWiki

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:Running MediaWiki on Windows and the translation is 100% complete.

Other languages:
Baso Minangkabau • ‎Deutsch • ‎English • ‎dansk • ‎español • ‎français • ‎italiano • ‎polski • ‎português do Brasil • ‎русский • ‎中文 • ‎日本語 • ‎한국어
安装指导
FreeBSD
GNU/Linux
- ALT Linux
- Arch Linux
- Damnsmalllinux
- Debian or Ubuntu
- Fedora
- Gentoo
- Mandriva
- Red Hat Enterprise Linux
- Slackware
Mac OS X
NetWare
Solaris
- Solaris 11 / opensolaris
- Solaris 10
Windows
- Windows Server 2016
一键
- Uniform Server
- XAMPP
Sourceforge.net

此页面将为您提供有关使用标准安装方法在Microsoft Windows系统上安装MediaWiki 的信息。 对于仅限Windows的托管环境,建议使用WIMP堆栈(使用IIS),而不是1.18版的Apache(WAMP堆栈),以进行手动安装。,apache和IIS的替代方案,如果您跨其他主机操作系统支持MediaWiki和/或已经在使用Nginx进行内部托管,则可能很有用。

所需软件

条件 配置要求概述

确保还要检查MediaWiki附带的发行注记是否符合要求。

缩略图TeX-support文本需要扩展程序支持 Parsoid(用于可视化编辑器)及其他服务亦有各自配置需求。

获取所需的软件

虽然这些产品在Windows下配置起来并不困难,但它可能“非常”难以安装(困难到WIMP需要30分钟),并且如果全新的话,一次配置Apache+MySQL+PHP一个产品阿帕奇/MySQL/ PHP。在这种情况下,强烈建议寻找可以安装和使用的LAMP或WAMP预制组合。这些将为您节省99%的手动配置每个包的麻烦。缺点是其中一些被削减或修改版本,这使得单个组件升级变得困难,而其他组件严重过时。

XAMPP

最受欢迎的是XAMPP:

WebPI

Microsoft Web Platform Installer可以为您安装必需的先决条件。 参见博客

Bitnami

  • Bitnami是一套免费的开源软件兼容安装程序。 它支持Nginx堆栈[1]、Microsoft WAMP [2]、一个通用LAMP堆栈[3]和XAMPP(它不会自行安装,只有XAMPP特定的bitnami安装程序工作[4])。 Bitnami在其中任何一个上安装Mediawiki 1.23,它们与Wordpress或其他软件bitnami支持一起工作。 有关指令[5]和更新的支持数据,请参阅Bitnami本身。 如果您打算仅使用长期稳定支持的mediawiki版本,这可能是一个不错的选择。 不保证支持旧版本。 参见Manual:Running MediaWiki on Windows/bitnami了解此方法的使用方法。

WAMP

参见 http://www.wampserver.com/en/

WIMP

在Azure上:[6]

安装 MediaWiki

对于有经验的用户,这里是安装说明的快速版。但是大多数用户仍然需要阅读浏览全部文章.

  1. 检查您的系统是否符合附近列出的最低配置要求 安装要求 页面有更详细的说明。
  2. 下载 MediaWiki (下载公开稳定版的直接链接)并将其解压到您服务器上可被Web浏览的目录中

使用浏览器访问MediaWiki被解压的目录并按照提示操作 安装指南通常位于http://domain/directory/mw-config/index.php。 将 directory 换成您MediaWiki的解压位置 如果是本地安装的话将 domain 替换成localhost。 如果您是在本地安装的,并且稍后想通过domain访问,您需要将LocalSettings.php 由localhost改为 domain. 如果是在远程服务器上安装,将 domain 替换为您的域名 (如: www.myserver.com).

  1. 根据屏幕提示 完成后面的步骤

上述内容只是一个简要说明,也许会出错,所以,如果有任何不确定的地方,建议你还是阅读下面的完整安装说明。

可选软件

Diffutils

Diffutils(包含diff3)可以从这里下载,File(文件类型检查器)可以从这里下载。

要在MediaWiki中激活diffutils的使用,你必须忽略它们在安装过程中不会被找到的事实(如果你在你的路径中安装了diff,它们实际上可能会被找到)并打开LocalSettings.php进行以下更改:

$wgDiff3 = "/usr/bin/diff3";

$wgDiff3 = "C:/Program Files/GnuWin32/bin/diff3.exe";

并替换:

$wgMimeDetectorCommand = "file.exe -bi"; #use external mime detector (linux)

$wgMimeDetectorCommand = "C:/Program Files/GnuWin32/bin/file.exe -bi"; # 使用外部mime探测器

请注意,您必须将“C://Program……”替换为安装工具的实际位置。

ImageMagick

注意:PHP现在默认启用GD,可用于缩略图。GD不需要使用任何配置或修改。因此,强烈建议“不要”安装ImageMagick,因为它已知不稳定。事实上,MW1.15.1中不存在下面提到的$wgImageMagickConvertCommand和Image.php。但是,在MW 1.23中,您必须通过将$wgUseImageMagick设置为false来禁用LocalSettings.php中的ImageMagick。
注意: XAMPP v1.7.7 VC9和MediaWiki v1.18.1的设置

“Q8”ImageMagick版本每通道使用8位,而“Q16”版本每通道使用16位。此处是Windows上ImageMagick的下载页面。要使图像缩略图工作,您需要打开includes/Image.php,找到以$cmd=$wgImageMagickConvertCommand .开头的行,并删除escapeshellarg()函数,然后执行相同操作下一行,以便命令变量构建如下:

 $cmd  =  $wgImageMagickConvertCommand .
       " -quality 85 -background white -geometry {$width} ".
       ($this->imagePath) . " " .
       ($thumbPath);

另外,检查以确保localsettings.php中的$wgImageMagickConvertCommand指向:

(你的imagemagick文件夹路径)/convert.exe
  • 使用.exe扩展名!如果省略,它将无法工作。
  • 使用路径不带空格作为ImageMagick的安装路径或使用路径的短名称。

另一种方法是将ImageMagick路径添加到Windows PATH变量中,只需在LocalSettings.php中设置$wgImageMagickConvertCommand,如下所示(请注意,您仍必须修改Image.php,如上所示)):

$wgImageMagickConvertCommand = "convert.exe";

确保Internet Guest帐户(通常为IUSR MACHINENAME)具有ImageMagick bin目录的读取和执行权限。如果没有这个,您可能会看到一个PHP shell执行错误,类似于找不到convert.exe文件时发生的错误。

Inkscape

Inkscape可以用作替代SVG缩略图工具。这里是Windows上Inkscape的下载页面。以下是在LocalSettings.php文件中启用Inkscape作为SVG thumnailer的一些示例设置:

# Image Converter
$wgSVGConverter = 'Inkscape';

$wgSVGConverters = array(
	'Inkscape' => '"/Program Files/Inkscape/inkscape.com" -z -w $width -f $input -e $output',
);

# Image converter path
$wgSVGConverterPath = '/Program Files/Inkscape';

数学公式支持

参见 [[7]]。