陋室 - 用户贡献 [zh]

模板:站点帮助文档/sandbox

2026-05-21T03:20:10Z

Maintenance script：更新帮助导航链接至新标题，移除旧重定向引用

<div class="navbox">

{| class="wikitable"
|+ [[:Category:站点帮助文档|站点帮助文档]]
|-
|阅读
|[[Help:移动优化|移动优化]]
|-
|编辑
|[[Help:维基化|维基化]] · [[Help:快速指南|快速指南]] · [[Help:编辑页面|编辑页面]] · [[Help:图片指南|图片指南]] · [[Help:编辑摘要|编辑摘要]] · [[Help:编辑冲突|编辑冲突]]
|-
|高级编辑
|[[Help:站点分类|站点分类]] · [[Help:站点模板|站点模板]] · [[Help:模板编写指南|模板编写指南]] · [[Help:模板样式|模板样式]] · [[Help:解析函数|解析函数]]
|-
|协作
|[[Help:历史与回退|历史与回退]] · [[Help:保护页面|保护页面]]
|-
|个人定制
|[[Help:定制消息|定制消息]] · [[Help:Gadget|Gadget]]
|-
|管理
|[[Help:学习指南|学习指南]] · [[Help:怎样的页面才会被计算为"文章页"|怎样的页面才会被计算为"文章页"]] · [[帮助:MediaWiki安装指南|MediaWiki安装指南]] · [[帮助:扩展语法与格式示例|扩展语法与格式示例]]

|}

</div>

{{Navbox/sandbox|target=Template:站点帮助文档/sandbox|parent=Template:站点帮助文档/sandbox}}

<includeonly>[[Category:站点帮助文档]]</includeonly>

<noinclude>沙盒版本：用于模板改造与兼容性测试。</noinclude>

模板:站点帮助文档

2026-05-21T03:20:06Z

Maintenance script：更新帮助导航链接至新标题，移除旧重定向引用

<div class="navbox">

{| class="wikitable"
|+ [[:Category:站点帮助文档|站点帮助文档]]
|-
|阅读
|[[Help:移动优化|移动优化]]
|-
|编辑
|[[Help:维基化|维基化]] · [[Help:快速指南|快速指南]] · [[Help:编辑页面|编辑页面]] · [[Help:图片指南|图片指南]] · [[Help:编辑摘要|编辑摘要]] · [[Help:编辑冲突|编辑冲突]]
|-
|高级编辑
|[[Help:站点分类|站点分类]] · [[Help:站点模板|站点模板]] · [[Help:模板编写指南|模板编写指南]] · [[Help:模板样式|模板样式]] · [[Help:解析函数|解析函数]]
|-
|协作
|[[Help:历史与回退|历史与回退]] · [[Help:保护页面|保护页面]]
|-
|个人定制
|[[Help:定制消息|定制消息]] · [[Help:Gadget|Gadget]]
|-
|管理
|[[Help:学习指南|学习指南]] · [[Help:怎样的页面才会被计算为"文章页"|怎样的页面才会被计算为"文章页"]] · [[帮助:MediaWiki安装指南|MediaWiki安装指南]] · [[帮助:扩展语法与格式示例|扩展语法与格式示例]]

|}

</div>

{{Navbox|target=Template:站点帮助文档|parent=Template:站点帮助文档}}

<noinclude>[[Category:站点模板]]</noinclude>
<noinclude>[[Category:导航盒]]</noinclude>
<includeonly>[[Category:站点帮助文档]]</includeonly>

<noinclude>{{/Doc}}</noinclude>

帮助:页面分类与归类规范

2026-05-21T03:19:35Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页规定页面底部分类的归类方法与边界，确保分类可检索、可维护。

== 适用范围 ==
* 主命名空间内容页
* 模板命名空间页面
* 分类命名空间页面

== 归类总则 ==
* 每个正式内容页至少应有 1 个主分类。
* 分类应与正文强相关，避免堆叠弱相关标签。
* 分类顺序保持稳定，非必要不频繁改动。

== 模板相关归类 ==
* 模板页自身分类放在 <nowiki><noinclude></nowiki>。
* 需要作用到调用页的分类放在 <nowiki><includeonly></nowiki>。
* 禁止在主模板裸放 <nowiki>[[Category:...]]</nowiki>。

== 特殊页面处理 ==
* 首页、测试页等可按项目规则单独约定。
* 维护状态建议使用隐藏分类承载。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:编辑页面

2026-05-21T03:19:32Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页介绍本站常用编辑方式及推荐工作流。

== 编辑方式 ==
{| class="wikitable"
! 方式 !! 适用人群 !! 优点 !! 注意点
|-
| 可视化编辑 || 新手与内容编辑 || 上手快、所见即所得 || 复杂模板场景可能不稳定
|-
| 源代码编辑 || 熟悉语法的维护者 || 可精准控制结构与模板 || 需要掌握 wikitext
|}

== 推荐流程 ==
# 进入编辑前先阅读页面首段与当前结构。
# 小步提交，避免一次改动过大。
# 保存前填写清晰的编辑摘要。
# 保存后检查差异页是否符合预期。

== 避免冲突 ==
* 长时间编辑建议先复制草稿到本地。
* 如页面活跃，先在讨论页说明改动范围。
* 冲突处理见 [[帮助:编辑冲突]]。

== 发布前检查 ==
* 标题层级是否连续。
* 内链和分类是否正确。
* 模板参数是否完整。
* 表格在移动端是否可读。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:编辑摘要

2026-05-21T03:19:29Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

编辑摘要用于说明本次改动的目的和范围，是协作透明度的关键信息。

== 为什么要写编辑摘要 ==
* 便于他人快速理解你的修改意图。
* 降低回退和误解风险。
* 方便在历史记录中追踪问题。

== 编写原则 ==
* 简洁：一句话说明核心改动。
* 具体：写明“改了什么”，避免“已更新”这类空泛描述。
* 可检索：必要时写入页面段落、模板名或分类名。

== 推荐写法 ==
* <code>修正“安装步骤”中的 PHP 版本说明</code>
* <code>新增“移动端宽表处理”示例</code>
* <code>将分类从“待建设分类”调整为“骨架分类”</code>

== 不推荐写法 ==
* <code>改了下</code>
* <code>更新</code>
* <code>。</code>

== 与其他功能的配合 ==
* 大改动建议先用“显示预览”。
* 高风险改动建议先在讨论页说明。
* 若是微小格式修复，可勾选“小编辑”。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:编辑冲突

2026-05-21T03:19:27Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

当两位或以上用户同时编辑同一页面并先后保存时，后保存者可能遇到编辑冲突。

== 何时发生 ==
* 你打开编辑页后，其他人先提交了新版本。
* 你的改动与新版本改动区域发生重叠。

== 处理步骤 ==
# 阅读冲突页面提示，确认“当前版本”和“你的版本”。
# 将你的有效改动手动合并到最新版本。
# 使用“显示更改”检查合并结果。
# 填写编辑摘要并重新保存。

== 降低冲突风险 ==
* 大改动前先在讨论页说明范围。
* 分批提交，避免长时间一次性编辑。
* 高活跃页面优先小步快跑。

== 相关页面 ==
* [[帮助:编辑页面]]
* [[帮助:编辑摘要]]

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:维护脚本

2026-05-21T03:19:23Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页列出站点常用维护脚本及适用场景。执行前请先备份数据库。

== 常用脚本 ==
<syntaxhighlight lang="bash">
# 更新数据库结构
php maintenance/run.php update.php --quick

# 重建最近更改
php maintenance/run.php rebuildrecentchanges.php

# 刷新链接关系
php maintenance/run.php refreshLinks.php

# 重建全文索引
php maintenance/run.php rebuildtextindex.php

# 执行队列任务
php maintenance/run.php runJobs.php
</syntaxhighlight>

== 使用建议 ==
* 维护窗口执行，避免业务高峰。
* 先在测试环境验证脚本副作用。
* 记录执行时间、参数和结果，便于追踪。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:维基化

2026-05-21T03:19:14Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

维基化是将原始文本整理为可维护、可协作的 wiki 页面结构。

== 目标 ==
* 结构清晰：读者能快速定位信息。
* 语法规范：减少渲染异常与维护成本。
* 可追溯：来源明确、改动可审计。

== 基本结构 ==
# 首段摘要：用 1 段说明主题与边界。
# 分级标题：按 <code>==</code>、<code>===</code> 逐级展开，不跳级。
# 参考资料：关键事实建议附来源。

== 常用维基语法 ==
=== 标题 ===
<syntaxhighlight lang="wikitext">
== 二级标题 ==
=== 三级标题 ===
</syntaxhighlight>

=== 列表 ===
<syntaxhighlight lang="wikitext">
* 无序项
# 有序项
</syntaxhighlight>

=== 参考文献 ===
<syntaxhighlight lang="wikitext">
文字内容<ref>来源信息</ref>
== 参考资料 ==
<references />
</syntaxhighlight>

=== 表格 ===
<syntaxhighlight lang="wikitext">
{| class="wikitable"
! 字段 !! 说明
|-
| 示例 || 内容
|}
</syntaxhighlight>

== 质量检查清单 ==
* 是否存在断裂标题层级。
* 是否存在无来源的关键事实。
* 是否存在过度装饰、口语化表达或无关内容。
* 内链与分类是否正确。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

项目:站点分类树评估

2026-05-21T03:19:11Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页记录“分类:站点分类”根树的阶段性评估结果与治理建议。

== 评估日期 ==
* 2026-05-18

== 评估范围与方法 ==
* 范围：从“分类:站点分类”递归可达的分类树。
* 方法：使用维护脚本进行只读统计。

== 关键结果 ==
* 根树分类节点总数：176
* 空分类总数：109
* 树最大深度（统计上限 8）：8
* 多父类现象：存在（当前策略允许的多维组织）

== 已执行动作 ==
* 保留空分类，不执行批量删除。
* 建立隐藏治理分类：
** [[:Category:骨架分类]]
** [[:Category:待建设分类]]

== 后续建议 ==
# 先治理高频访问路径上的空分类。
# 建立季度复评机制，持续跟踪结构质量。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:移动优化

2026-05-21T03:19:07Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页说明如何提高页面在手机与平板端的可读性。

== 基本原则 ==
* 优先保证内容不出现横向溢出。
* 长表格与长代码块要可滚动。
* 重要信息应在小屏首屏可见。

== 常见问题 ==
=== 宽表格撑破布局 ===
可在容器中包裹表格：
<syntaxhighlight lang="html">
<div style="overflow-x:auto;">
{| class="wikitable"
! 列 1 !! 列 2
|-
| 内容 || 内容
|}
</div>
</syntaxhighlight>

=== 代码块过宽 ===
* 控制单行长度。
* 必要时分段展示。

=== 图片过大 ===
* 指定合理宽度（如 <code>300px</code>）。
* 为移动端重点页面避免超宽原图直接内联。

== 编辑检查清单 ==
* 在移动端皮肤下预览一次。
* 确认无横向滚动条覆盖正文。
* 检查表格、图片、模板是否仍可读。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:模板改造与发布规范

2026-05-21T03:19:05Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页规定模板改造、测试、发布和回滚的标准流程。

== 改造前 ==
# 明确模板类型与使用范围。
# 明确分类行为（模板自身分类 / 调用页分类）。
# 对照相关规范：[[帮助:模板定义与结构规范]]、[[帮助:页面分类与归类规范]]。

== 改造中 ==
# 在 <code>sandbox</code> 实现改动。
# 同步更新 <code>/Doc</code>（参数、示例、注意事项）。
# 在 <code>testcases</code> 补充典型用例。
# 涉及样式改动时同步更新 <code>styles.css</code>。

== 发布前检查 ==
* 渲染是否兼容主要调用页面。
* 分类是否按预期落位。
* 历史调用是否出现参数回归。

== 发布与回滚 ==
* 使用明确编辑摘要说明影响范围。
* 若出现严重回归，优先回滚到稳定版本并记录原因。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:模板定义与结构规范

2026-05-21T03:19:02Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页用于统一模板工程的定义、结构和约束。

== 适用范围 ==
* <code>模板:名称</code>
* <code>模板:名称/Doc</code>
* <code>模板:名称/sandbox</code>
* <code>模板:名称/testcases</code>
* <code>模板:名称/styles.css</code>

== 结构规范 ==
* 主模板负责展示与轻量分发。
* 文档统一放在 <code>/Doc</code> 并由主模板挂载。
* 样式统一放在 <code>/styles.css</code>，通过 <nowiki><templatestyles /></nowiki> 引入。
* 发布前必须有 <code>sandbox</code> 与 <code>testcases</code>。

== 参数规范 ==
* 参数命名稳定、语义明确。
* 复杂参数在文档页给出示例。
* 新增别名需在文档页明确说明。

== 分类规范 ==
* 模板自身分类进入 <nowiki><noinclude></nowiki>。
* 调用页分类进入 <nowiki><includeonly></nowiki>。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:模板使用指南

2026-05-21T03:18:58Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页汇总本站常用模板的调用方式与使用边界。

== 使用原则 ==
* 先看模板文档页（通常是 <code>/Doc</code>）。
* 参数名称按文档填写，避免自造参数。
* 复杂模板先在沙盒验证后再上线。

== 常见模板场景 ==
=== 导航模板 ===
用于页面底部导航或同类页面联动。

=== 维护模板 ===
用于标注“待补充”“待核实”等状态。

=== 信息框模板 ===
用于结构化展示关键字段。

== 示例 ==
<syntaxhighlight lang="wikitext">
{{模板名
| 参数1 = 值1
| 参数2 = 值2
}}
</syntaxhighlight>

== 排错建议 ==
* 模板不显示：检查模板名、参数名和括号闭合。
* 分类异常：检查模板中 <code>noinclude/includeonly</code> 区块。
* 样式错乱：检查 <code>styles.css</code> 是否被正确加载。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:扩展语法与格式示例

2026-05-21T03:18:38Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页汇总本站常用扩展语法的最小可用示例，便于快速复制与排错。

== 重定向（Redirect） ==
用于将当前页面跳转到目标页面。
<syntaxhighlight lang="wikitext">
#REDIRECT [[目标页面]]
</syntaxhighlight>

== 代码高亮（SyntaxHighlight） ==
<syntaxhighlight lang="wikitext">
<syntaxhighlight lang="bash">
php -v
mysql --version
</syntaxhighlight>
</syntaxhighlight>

== 输入框（InputBox） ==
<syntaxhighlight lang="wikitext">
<inputbox>
type=search
arialabel=Search the Wiki
</inputbox>
</syntaxhighlight>

== 时间线（EasyTimeline） ==
<syntaxhighlight lang="wikitext">
<timeline>
DateFormat = yyyy
Period = from:2000 till:2026
PlotData =
bar:阶段 from:2000 till:2010 text:起步
bar:阶段 from:2010 till:2020 text:建设
bar:阶段 from:2020 till:2026 text:优化
</timeline>
</syntaxhighlight>

== 图片热区（ImageMap） ==
<syntaxhighlight lang="wikitext">
<imagemap>
File:Example.jpg|thumb|300px|示例
rect 0 0 150 100 [[帮助:图片指南]]
</imagemap>
</syntaxhighlight>

== 地图（Kartographer / mapframe） ==
<syntaxhighlight lang="wikitext">
<mapframe latitude="39.9042" longitude="116.4074" zoom="12" width="600" height="400" />
</syntaxhighlight>
说明：若地图不显示，请检查 Kartographer 与地图服务配置。

== 公式与化学式（Math） ==
<syntaxhighlight lang="wikitext">
<math>x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}</math>
<chem>Hg^2+ ->[I-] HgI2</chem>
</syntaxhighlight>

== 乐谱（Score） ==
<syntaxhighlight lang="wikitext">
<score>
\relative c' { c d e f | g2 g }
</score>
</syntaxhighlight>

== 古埃及象形文字（WikiHiero） ==
<syntaxhighlight lang="wikitext">
<hiero>A1</hiero>
</syntaxhighlight>

== PDF 预览（PdfHandler） ==
<syntaxhighlight lang="wikitext">
[[File:Example.pdf|thumb|500px|PDF 示例]]
</syntaxhighlight>

== 音视频（TimedMediaHandler） ==
<syntaxhighlight lang="wikitext">
[[File:Example.ogg|thumb|音频示例]]
[[File:Example.webm|thumb|300px|视频示例]]
</syntaxhighlight>

== 使用建议 ==
* 先在沙盒页验证语法，再发布到正式页面。
* 扩展渲染失败时，先检查扩展是否启用、依赖是否安装。
* 对外链资源优先使用稳定来源。

== 参考 ==
* https://www.mediawiki.org/wiki/Category:Extensions
* https://www.mediawiki.org/wiki/Help:Formatting

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:快速指南

2026-05-21T03:18:31Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页面向首次使用本站的编辑者，帮助你在最短时间完成一次规范编辑。

== 1. 创建页面 ==
=== 方式一：红链创建（推荐） ===
<syntaxhighlight lang="wikitext">
[[新页面名称]]
</syntaxhighlight>
点击红链后即可进入创建页面。

=== 方式二：搜索创建 ===
在搜索框输入目标标题，若页面不存在会出现创建入口。

== 2. 编辑页面 ==
* 可视化编辑：适合文字与基础排版。
* 源代码编辑：适合模板、表格和复杂结构。

== 3. 常用语法 ==
<syntaxhighlight lang="wikitext">
== 二级标题 ==
* 无序列表
# 有序列表
[[内部链接]]
[https://example.com 外部链接]
</syntaxhighlight>

== 4. 添加分类 ==
在页面底部添加：
<syntaxhighlight lang="wikitext">
[[Category:分类名称]]
</syntaxhighlight>

== 5. 保存前检查 ==
* 是否填写编辑摘要。
* 是否预览并确认样式。
* 是否补齐必要来源与内链。

== 6. 常见入口 ==
* [[帮助:编辑页面]]
* [[帮助:编辑摘要]]
* [[帮助:图片指南]]
* [[帮助:模板使用指南]]

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:学习指南

2026-05-21T03:18:28Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页提供站点编辑者的学习路径，帮助你从入门走向可独立协作。

== 学习方向 ==
=== 内容编辑方向 ===
适合希望建设条目、整理知识结构的编辑者。

建议先学：
* 页面结构与标题层级
* 引用与来源标注
* 分类与内链组织

=== 模板与样式方向 ===
适合希望维护模板、改进展示样式的编辑者。

建议先学：
* 模板参数与 <code>noinclude/includeonly</code>
* TemplateStyles 与样式隔离
* 模板文档与测试页编写

=== 自动化方向 ===
适合需要批量维护、数据治理的编辑者。

建议先学：
* 维护脚本基础
* 差异比对与回滚流程
* 批量修改的风险控制

== 推荐顺序 ==
# 先完成 [[帮助:快速指南]]
# 再阅读 [[帮助:维基化]] 与 [[帮助:编辑页面]]
# 进阶阅读模板和分类规范相关页面

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:图片指南

2026-05-21T03:18:22Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页说明如何在本站上传、插入和维护图片资源。

== 上传图片 ==
# 打开 [[Special:Upload|上传文件]]。
# 选择文件并填写描述信息。
# 标注来源、作者和许可信息。
# 确认文件名规范后提交。

== 文件命名建议 ==
* 使用可读、可检索的描述性名称。
* 避免 <code>IMG_001.jpg</code> 这类无语义名称。
* 不在文件名中使用含义不明的缩写。

== 页面插图 ==
<syntaxhighlight lang="wikitext">
[[File:Example.jpg|thumb|300px|示例说明]]
</syntaxhighlight>

常用参数：
* <code>thumb</code>：缩略图样式
* <code>300px</code>：显示宽度
* 最后一段文本：图片说明

== 图片画廊 ==
<syntaxhighlight lang="wikitext">
<gallery>
File:Example1.jpg|说明 1
File:Example2.jpg|说明 2
</gallery>
</syntaxhighlight>

== 版权与合规 ==
* 仅上传你有权使用的文件。
* 来源不明或版权不明的文件不要上传。
* 引用第三方资源时需标明授权条件。

== 维护建议 ==
* 定期清理重复、低质量或失效文件。
* 文件描述页保持完整，便于长期复用。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:咨询台

2026-05-21T03:18:20Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页用于集中受理站点使用问题、内容纠错与功能建议。

== 使用范围 ==
* 账号与权限问题
* 页面编辑与语法问题
* 内容纠错与规范咨询
* 模板、分类与站点功能建议

== 提问格式 ==
请尽量按以下结构提交：
# 问题页面链接
# 问题现象（最好包含截图或报错文本）
# 你的预期结果
# 已尝试操作

== 处理流程 ==
# 维护者确认问题分类
# 给出处理建议或直接修复
# 处理完成后标记结论

== 常见问题 ==
=== 如何注册账号？ ===
当前由管理员统一开通。请联系站点管理员。

=== 如何开始编辑？ ===
参考 [[帮助:快速指南]] 与 [[帮助:编辑页面]]。

=== 遇到编辑冲突怎么办？ ===
参考 [[帮助:编辑冲突]]。

{{Template:站点帮助文档}}
[[Category:常见问题]]
[[Category:帮助文档]]

帮助:分类命名与层级规范

2026-05-21T03:18:17Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页规定站点分类命名和层级组织规则，用于保证分类体系长期稳定可维护。

== 适用范围 ==
* 分类页面创建与重命名
* 分类树结构调整
* 分类合并与拆分

== 命名规则 ==
* 优先使用语义清晰、长期稳定的名称。
* 同一语义只保留一套主名称，避免近义并存。
* 中文语境优先中文命名，技术名词可保留标准英文写法。

== 层级规则 ==
* 上位分类描述“更宽主题”，下位分类描述“更具体主题”。
* 避免无意义深层嵌套。
* 非必要不建立循环归类。

== 禁止事项 ==
* 仅大小写或符号差异的重复分类。
* 无边界定义的交叉分类泛滥。

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:MediaWiki安装指南

2026-05-21T03:18:10Z

Maintenance script：帮助命名空间规范化：移除一级标题并修正渲染安全写法

本页给出通用安装流程，并提供本站当前环境可复用的参数示例。实际部署请以官方文档为准。

== 参考环境 ==
* 操作系统：Debian 12
* Web 服务器：Nginx
* PHP：8.2（PHP-FPM）
* 数据库：MariaDB 10.11

== 1. 安装系统依赖 ==
<syntaxhighlight lang="bash">
sudo apt update && sudo apt upgrade -y
sudo apt install nginx mariadb-server php8.2-fpm php8.2-cli php8.2-mysql php8.2-gd php8.2-mbstring php8.2-xml php8.2-curl php8.2-zip php8.2-intl php8.2-apcu unzip git -y
</syntaxhighlight>

== 2. 下载并解压 MediaWiki ==
<syntaxhighlight lang="bash">
cd /var/www
wget https://releases.wikimedia.org/mediawiki/1.45/mediawiki-1.45.0.tar.gz
tar -xzvf mediawiki-1.45.0.tar.gz
mv mediawiki-1.45.0 mediawiki
</syntaxhighlight>

== 3. 创建数据库与账号 ==
<syntaxhighlight lang="sql">
CREATE DATABASE my_wiki CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'wikiuser'@'localhost' IDENTIFIED BY '强密码';
GRANT ALL PRIVILEGES ON my_wiki.* TO 'wikiuser'@'localhost';
FLUSH PRIVILEGES;
</syntaxhighlight>

== 4. 运行安装向导 ==
访问：<code>https://你的域名/mw-config/</code>

完成后将生成的 <code>LocalSettings.php</code> 放入站点根目录。

== 5. 关键配置示例 ==
<syntaxhighlight lang="php">
$wgScriptPath = '';
$wgArticlePath = '/wiki/$1';
</syntaxhighlight>

== 6. 常用安装后维护 ==
<syntaxhighlight lang="bash">
php /var/www/mediawiki/maintenance/run.php update.php
php /var/www/mediawiki/maintenance/run.php rebuildrecentchanges.php
php /var/www/mediawiki/maintenance/run.php refreshLinks.php
php /var/www/mediawiki/maintenance/run.php runJobs.php
</syntaxhighlight>

== 7. 安全与排错 ==
* 确保 <code>LocalSettings.php</code> 权限最小化。
* 上传失败时检查 PHP 上传大小限制与目录权限。
* 页面无法渲染时优先检查 PHP-FPM 与 Nginx 日志。

== 官方文档 ==
* https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki

{{Template:站点帮助文档}}
[[Category:帮助文档]]

帮助:页面分类与归类规范

2026-05-21T03:11:13Z