使用腾讯云轻量应用服务器搭建自己的百科:超详细的 MediaWiki 的安装、配置及优化指南(一)

本系列旨在向 MediaWiki 新用户提供一份完整的入门指南,本文详细介绍了 MediaWiki 的安装过程。

看到现有的中文教程比较老和杂乱,打算给新的 MediaWiki 用户弄个完整的入门教程,希望之后不会咕。

若你想为自己或公司的产品创建一份详细的说明书,或想将自己的知识分享给世界(并邀请他们一起建设内容),无疑,MediaWiki 将是一个不错的选择。本教程将会带你从 0 开始完成 MediaWiki 的安装、配置和优化。

 为什么选择 MediaWiki

MediaWiki 软件被包括维基百科在内的数以万计的网站和数以千计的公司和组织使用。它功能强大、多语言、免费开放、可扩展、可定制、可靠且开源。MediaWiki 可帮助您收集和组织知识并将其提供给人们,并且允许协作,每个人都能够贡献自己的知识帮助改进站点。

需求

硬件

  • 一台配置在 1C1G 及以上的腾讯云轻量应用服务器

软件

  • PHP 7.3.19 或 7.4.9

注意:MediaWiki 与 PHP 7.3.0 – 7.3.18 和 7.4.0 – 7.4.8不兼容。

  • PHP 必要扩展:
  • Perl 兼容正则表达式(PCRE) (MediaWiki 1.23 要求 PCRE 7.2+)
  • 会话(Session)
  • SQL
  • OpenSSL
  • json (MediaWiki 1.22+)
  • mbstring (从1.27版本起要求,早期版本只做推荐)
  • fileinfo (从1.30版本起要求)
  • intl (required since 1.36)
  • MySQL 5.5.8+

安装

方案1:手动安装

新建虚拟机
如果你对LNMP环境的配置感到厌烦,不妨试试宝塔面板,本教程之后将会在此环境下进行。选择宝塔面板应用镜像,待服务创建完成后按提示操作即可。

安装基础服务
PHP 扩展
按个人喜好安装基础服务,别忘记手动安装 PHP 扩展 `apcu`、`fileinfo` 和 `intl`,并在左侧 `禁用函数` 面板中启用 `putenv` 函数。

添加站点
添加站点,若是使用域名请在对应解析服务添加解析记录。

MediaWiki主页 找到合适的软件包(可能需要代理,这里提供一份 1.36.1 版本 镜像),复制链接并远程下载到站点目录。

#### 方案2:D o c k e r!

~~既然你愿意使用 Docker,那么你肯定是会的,多余的就不讲了。~~

这是 MediaWiki 在 DockerHub 的官方镜像

“` Shell
docker pull mediawiki
docker run –name mywiki -p 8080:80 -d mediawiki
“`
然后在本机 8080 端口访问 MediaWiki 并开始配置。

配置

好了!现在访问 `http://[你的域名或ip]/mw-config/index.php`,进入配置页面,根据提示完成站点的配置。

软件安装
选择语言。

软件安装1
若有报错,请按提示检查安装步骤;若无报错,则继续。

软件安装2
配置数据库,数据库主机一般选 `localhost`,数据库表前缀可以随意设置,这在单主机多 wiki 场景时有用;其它参数都由你之前创建站点时设置完成。

软件安装4
按提示设置站点名以及管理员账号,并且你想被多问一些问题。

软件安装5
配置编辑权限和扩展,扩展决定了你的 wiki 的可用功能,按需选择即可。

> 内置扩展的简单介绍:
> _这里仅简单介绍为数不多的内置扩展,若有需要,可在[官方扩展页](https://www.mediawiki.org/w/index.php?title=Category:All_extensions)找到更多信息。_
> 1. 特殊页面:
> 1. __`CiteThisPage`__ 能够添加一个特殊页面,为特定文章提供不同的引文格式。
> 2. __`Interwiki`__ 能够某个词条中调用其他词条的内容。
> 3. __`Nuke`__ 能够使管理员批量删除页面。
> 4. __`Renameuser`__ 能够授权用户重命名用户帐户。
> 5. __`ReplaceText`__ 能够允许管理员在 wiki 内容页面的文本和标题上进行全局字符串查找和替换。
> 2. 编辑器:
> 1. __`CodeEditor`__ 能够为编辑器中 JavaScript, CSS, JSON, Lua 的编辑提供了一些方便的功能,包括自动缩进和括号配对等功能。
> 2. __`VisualEditor`__ 能够提供一个富文本编辑器。
> 3. __`WikiEditor`__ 能够提供一个可扩展的 wikitext 编辑界面和许多功能模块。
> 3. 解析器钩
> 1. __`CategoryTree`__ 能够以树的形式提供 wiki 类别结构的动态视图。
> 2. __`Cite`__ 能够为页面添加脚注。
> 3. __`ImageMap`__ 能够为单张图片的不同区域自定义多个链接(例如地图照片)。
> 4. __`InputBox`__ 能够允许用户将 HTML 表单添加到 wiki 页面。
> 5. __`ParserFunctions`__ 能够在 wikitext 中提供逻辑和字符串的增强处理。
> 6. __`Poem`__ 能够提供适合诗歌的渲染格式。
> 7. __`Scribunto`__ 能够在 MediaWiki 内嵌入脚本语言,不过目前只支持 Lua。
> 8. __`TemplateData`__ 能够允许存储、检索和可视化有关模板的信息。
> 4. 媒体文件处理器
> 1. __`PdfHandler`__ 能够显示上传的PDF文件。
> 5. 垃圾阻止
> 1. __`ConfirmEdit`__ 能够为页面保存和其他用户操作添加验证码。
> 2. __`SpamBlacklist`__ 能够提供一个基于正则表达式的垃圾邮件过滤器。
> 3. __`ConfirmEdit`__ 能够禁止用户建立与正规表达式黑名单匹配的页面。
> 6. API
> 1. __`PageImages`__ 能够收集在有关页面上使用的图像的信息,它的目的是返回与文章相关的单个最合适的图像的缩略图。
> 7. 其他
> 1. __`Gadgets`__ 能够让用户使用一些基于 JavaScript 和 CSS 的小工具。
> 2. __`LocalisationUpdate`__ 能够让你可以随时更新 MediaWiki 讯息,而不需要升级 MediaWiki 软件。
> 3. __`MultimediaViewer`__ 能够为用户提供一个更好的图像浏览器,在用户单击图片时以全屏方式打开。
> 4. __`OATHAuth`__ 能够为登录提供二步验证。
> 5. __`SecureLinkFixer`__ 能够自动将 URL 重写为 HTTPS。
> 6. __`TextExtracts`__ 能够为纯文本提供摘要。

软件安装6
软件安装7
软件安装-上传配置文件

接下来等待配置完成,下载自动生成的配置文件 `LocalSettings.php`,并上传至站点根目录。

完成安装
好了,安装过程结束!试着编辑你的 wiki 吧!

____

下一章将会讲解关于的 MediaWiki 配置相关内容,在此之前,请试着熟悉 MediaWiki ~
本文以 署名-非商业性使用-相同方式共享 4.0 国际 (CC BY-NC-SA 4.0) 协议共享,转载请署名并保留来源。

本文来自开发者投稿,不代表腾讯云立场,转载请注明出处:https://computeinit.com/archives/4299

发表评论

登录后才能评论
交流群