Jump to content

手册:在Windows上运行MediaWiki

本頁使用了標題或全文手工轉換
From mediawiki.org
This page is a translated version of the page Manual:Running MediaWiki on Windows and the translation is 98% complete.

此页面的内容主要被Manual:Running MediaWiki on Windows Subsystem for Linux 取代。

此页面将为您提供有关使用标准安装方法在Microsoft Windows系统上安装MediaWiki 的信息。 对于仅限Windows的托管环境,建议使用WIMP堆栈(使用IIS),而不是1.18版的Apache(WAMP堆栈),以进行手动安装。

Nginx,apache和IIS的替代方案,如果您跨其他主机操作系统支持MediaWiki和/或已经在使用Nginx进行内部托管,则可能很有用。

所需软件

获取所需的软件

虽然这些产品在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,它们与Wordpress或其他软件bitnami支持一起工作。 有关指令[5]和更新的支持数据,请参阅Bitnami本身。 如果您打算仅使用长期稳定支持的mediawiki版本,这可能是一个不错的选择。 不保证支持旧版本。

WAMP

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

WIMP

See https://learn.microsoft.com/en-us/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis

可选软件

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,因为它已知不稳定。 在MediaWiki中,在LocalSettings.php设置$wgUseImageMagickfalse来禁用ImageMagick。

下载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.exe" --export-filename $output -w $width $input',
);

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

数学公式支持

参见 Texvc#Windows