陋室 - 用户贡献 [zh]

项目:站点分类树评估

2026-05-21T03:30:39Z

Move page script：Move page script移动页面帮助:站点分类树评估至项目:站点分类树评估，不留重定向：页面归档到项目命名空间（不保留重定向）

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

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

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

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

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

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

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

项目:站点分类树评估

2026-05-21T03:06:52Z

Move page script：Move page script移动页面帮助:站点分类树评估（2026-05-18）至帮助:站点分类树评估：统一帮助命名空间标题命名规范

本页记录以“[[:Category:站点分类]]”为根节点的分类体系阶段性评估结果与后续治理优先级。

== 评估时间 ==
* 2026-05-18

== 范围与方法 ==
* 范围：从“分类:站点分类”递归可达的分类树。
* 方法：使用维护脚本 <code>maintenance/run.php sql.php</code> 进行只读统计。

== 关键结果 ==
* 根树分类节点总数：176
* 空分类总数：109
* 空分类中已标注“骨架分类”：109
* 空分类（叶子）中已标注“待建设分类”：109
* 树最大深度（统计上限深度 8）：8
* 多父类现象：存在（大量节点 parent_count >= 2，属于当前站点的多维组织策略，非立即错误）

== 已完成治理动作 ==
* 保留空分类，不执行删除。
* 新增并启用隐藏治理分类：
** [[:Category:骨架分类]]
** [[:Category:待建设分类]]
* 为根树空分类批量补充治理标注（骨架/待建设）。
* 完成模板域补充分类（讨论系统模板）与随想域下沉分类（社会议题随想、媒体叙事随想）。

== 后续优先级建议 ==
=== P1：保持骨架分类策略 ===
* 新建方向优先复用既有骨架分类，避免同义分类并行。
* 新增空分类默认纳入“骨架分类”；叶子空分类纳入“待建设分类”。

=== P2：控制多父类复杂度 ===
* 对 parent_count >= 3 的高频分类做抽样复核，逐步明确“主父类 + 辅助父类”边界。
* 不做一次性大改，按专题小批次收敛。

=== P3：季度复核 ===
* 建议每季度复核一次：
** 空分类数量与覆盖率
** 新增分类命名一致性
** 被弃用分类是否仍有成员

[[Category:分类维护]]

帮助:MediaWiki安装指南

2026-05-21T03:06:41Z

Move page script：Move page script移动页面帮助:MediaWiki 安装至帮助:MediaWiki安装指南：统一帮助命名空间标题命名规范

'''说明''' 本指南结合 MediaWiki 官方文档与实际部署经验，概述通用安装流程，并结合本站（learn.houjue.digital）当前环境给出可直接复用的参数与命令。请始终以 [https://www.mediawiki.org/wiki/Manual:Installing_MediaWiki 官方安装指南] 为权威来源，并根据自己的环境调整命令与路径。

== 环境准备 ==
=== 系统与组件 ===
本站当前运行环境如下（可按需替换为你的实际版本）：
* 操作系统：Debian 12 (bookworm)
* Web 服务器：Nginx 1.22.x
* PHP：8.2.x（PHP-FPM）
* 数据库：MariaDB 10.11.x

常用版本检查命令：
<syntaxhighlight lang="bash">
cat /etc/os-release
nginx -v
php -v
mysql --version
</syntaxhighlight>

=== 更新与依赖 ===
根据本站当前部署（Debian 12 + Nginx + PHP 8.2 FPM + MariaDB），建议按以下方式更新与安装依赖：
<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
# 多媒体与差异对比工具
sudo apt install ffmpeg poppler-utils imagemagick php-wikidiff2 -y
</syntaxhighlight>

如需启用 Lua/时间线/乐谱等扩展，可按需补充：
<syntaxhighlight lang="bash">
# Scribunto
sudo apt install php-luasandbox -y
# EasyTimeline/Score 等
sudo apt install perl ploticus lilypond ghostscript -y
</syntaxhighlight>

说明：本站使用 Nginx + PHP-FPM，如需 Apache 请改用对应包与配置；PHP-FPM 请确保与 Nginx 配置匹配。

== 安装步骤 ==
=== 1. 下载 MediaWiki（通用流程） ===
从官方 https://releases.wikimedia.org 下载当前稳定版本。示例命令：
<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>

本站实际路径：<code>/var/www/mediawiki</code>，Web 用户为 <code>www-data</code>。

=== 2. 创建数据库与用户（通用流程） ===
登录数据库创建专用数据库与账号：
<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>

本站实际数据库配置（见 <code>/var/www/learn.php</code>）：
* 数据库：<code>learn</code>
* 用户：<code>learn</code>
* 主机：<code>localhost</code>

=== 3. 运行安装向导（通用流程） ===
在浏览器打开 <code>https://<你的域名或IP>/mw-config/</code>，安装向导会依次要求填写环境检测、数据库信息、站点名称、管理员账号、上传目录等。
完成后会生成 <code>LocalSettings.php</code>，请放到 MediaWiki 根目录。

本站实际配置：
* <code>$wgServer = "https://learn.houjue.digital";</code>
* <code>$wgScriptPath = "";</code>
* <code>$wgArticlePath = "/wiki/$1";</code>
* 上传目录：<code>/sgcos/images</code>（映射为 <code>/images</code>）

=== 4. 完成安装与安全加固（通用流程） ===
上传 LocalSettings 后即可通过站点访问。
* 锁定安装目录：<code>chmod -R 700 /var/www/mediawiki/mw-config</code>
* 确保 <code>LocalSettings.php</code> 权限为 600，Web 服务器可读。
* 关闭 config 目录写权限：
<syntaxhighlight lang="bash">
chmod a-w /var/www/mediawiki/config
</syntaxhighlight>

== 后续依赖与扩展 ==
=== php-wikidiff2 ===
改善差异显示，安装命令：
<syntaxhighlight lang="bash">
sudo apt install php-wikidiff2 -y
</syntaxhighlight>
配置：
<syntaxhighlight lang="php">
$wgDiffEngine = 'wikidiff2';
$wgDiff3 = '/usr/bin/diff3';
</syntaxhighlight>

=== php-luasandbox 与 Scribunto ===
安装 Lua 沙箱：
<syntaxhighlight lang="bash">
sudo apt install php-luasandbox -y
</syntaxhighlight>
启用扩展：
<syntaxhighlight lang="php">
wfLoadExtension('Scribunto');
$wgScribuntoEngineConf['luasandbox']['memoryLimit'] = 50 * 1024 * 1024;
</syntaxhighlight>

=== 多媒体工具 ===
* ffmpeg：<code>sudo apt install ffmpeg -y</code>
* poppler-utils（PDF 处理）：<code>sudo apt install poppler-utils -y</code>
* Composer（依赖管理）：<code>curl -sS https://getcomposer.org/installer | php && mv composer.phar /usr/local/bin/composer</code>
* EasyTimeline/Score/PdfHandler 等扩展可根据需要分别安装 ploticus、perl、lilypond、ghostscript、imagemagick 等依赖。

== HTTPS 与短链接 ==
本站使用 Nginx，短链接与 HTTPS 参考：
<syntaxhighlight lang="nginx">
# 强制 HTTPS
return 301 https://$host$request_uri;

# MediaWiki 路由（示例，需结合你的站点结构）
location /wiki/ {
try_files $uri $uri/ /index.php?$args;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
</syntaxhighlight>

配合以下 LocalSettings：
<syntaxhighlight lang="php">
$wgScriptPath = '';
$wgArticlePath = '/wiki/$1';
</syntaxhighlight>

== 性能与维护 ==
* 使用缓存（APCu/Redis）加速页面与消息
* 启用 <code>$wgMainCacheType</code>、<code>$wgParserCacheType</code> 等缓存参数
* 定期运行维护脚本：
<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 rebuildtextindex.php
php /var/www/mediawiki/maintenance/run.php runJobs.php
</syntaxhighlight>

== 故障排查 ==
* 页面渲染成 WikiText：检查 PHP-FPM/Nginx 是否正常、LocalSettings 是否可读
* 安装向导无法完成：检查文件夹权限，确保 <code>mw-config</code> 可写且临时可执行
* 文件上传失败：核实上传目录与权限（本站为 <code>/sgcos/images</code>）以及 PHP 限制与 <code>$wgFileExtensions</code> 设置
* 数据库连接出错：确认凭据、字符集（utf8mb4）及正确的数据库主机

{{Template:站点帮助文档}}

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

2026-05-21T03:06:12Z

Move page script：Move page script移动页面帮助:需要配置的格式至帮助:扩展语法与格式示例：统一帮助命名空间标题命名规范

== 重定向 (Redirect) ==
用于将页面指向其它页面。

示例语法：
<syntaxhighlight lang="wikitext">
#REDIRECT [[目标页面]]
</syntaxhighlight>

效果说明：保存后访问该页会自动跳转到目标页面。
== timeline ==
使用 EasyTimeline 或 <nowiki><timeline></nowiki> 语法展示事件。

=== 示例（可视化时间线） ===
<timeline>
# All measures are in pixels

ImageSize = width:160 height:550
PlotArea = left:50 right:0 bottom:10 top:10
AlignBars = justify

DateFormat = yyyy
Period = from:1917 till:1991
TimeAxis = orientation:vertical
ScaleMajor = unit:year increment:5 start:1920

# there is no automatic collision detection,
# so shift texts up or down manually to avoid overlap

Define $dx = 25 # shift text to right side of bar

PlotData=
bar:Leaders color:red width:25 mark:(line,white) align:left fontsize:S

from:start till:1924 shift:($dx,15) text:Vladimir~Ilyich~[[Special:MyLanguage/Lenin|Lenin]]
from:1924 till:1953 shift:($dx,5) text:[[Special:MyLanguage/Stalin|Josef~Stalin]]
from:1953 till:1964 shift:($dx,5) text:Nikita~[[Special:MyLanguage/Khrushchev|Khrushchev]]
from:1964 till:1982 shift:($dx,5) text:Leonid~[[Special:MyLanguage/Brezhnev|Brezhnev]]
from:1982 till:1984 shift:($dx,-12) text:Yuri~[[Special:MyLanguage/Andropov|Andropov]]
from:1984 till:1985 shift:($dx,4) text:Konstantin~[[Special:MyLanguage/Chernenko|Chernenko]] fontsize:XS
from:1985 till:end shift:($dx,10) text:Mikhail~[[Special:MyLanguage/Gorbachev|Gorbachev]]
</timeline>

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:EasyTimeline
== ImageMap ==
ImageMap 扩展允许在图片中定义可点区域，适合交互式说明。

=== 示例 ===
<imagemap>
File:The Last Supper - Leonardo Da Vinci - High Resolution 32x16.jpg|thumb|center|500px|alt=''The Last Supper'' by Leonardo da Vinci - Clickable Image|Image map example. Clicking on a person in the picture causes the browser to load the appropriate article.

poly 550 2550 750 2400 1150 2300 1150 2150 1200 2075 1500 2125 1525 2300 1350 2800 1450 3000 1700 3300 1300 3475 650 3500 550 3300 450 3000 [[w:Bartholomew the Apostle|Bartholomew]]
poly 1575 2300 1625 2150 1900 2150 1925 2500 1875 2600 1800 2750 1600 3250 1425 3100 1400 2800 1375 2600 [[w:James, son of Alphaeus|James Minor]]
poly 1960 2150 2200 2150 2350 2500 2450 2575 2375 2725 2375 2900 2225 3100 2225 3225 1600 3225 1825 2700 1975 2450 1925 2300 [[w:Saint Andrew|Andrew]]
poly 2450 2575 2775 2500 2700 2650 2800 2700 2600 3000 2600 3250 2300 3250 2200 3200 2300 3000 [[w:Saint Peter|Peter]]
poly 2750 2500 2950 2400 3125 2600 3175 2700 3300 2850 3700 3200 3750 3200 3650 3350 3400 3200 3000 3350 2600 3325 2750 2800 2900 2700 2700 2650 [[w:Judas Iscariot|Judas]]
poly 3000 2350 3300 2350 3350 2660 3560 2600 3565 2690 3250 2800 3125 2575 [[w:Saint Peter|Peter]]
poly 3332 2338 3528 2240 4284 3024 4074 3332 3864 3290 3780 3150 3668 3192 3598 3024 3374 2870 3388 2772 3542 2800 3668 2702 3542 2590 3430 2604 3350 2600 3300 2500[[w:John the Apostle|John]]
poly 4775 2184 4915 2128 5055 2212 5083 2352 5111 2464 5181 2604 5307 2744 5573 3052 5615 3192 5657 3290 5573 3402 5461 3332 5335 3248 4495 3248 4439 3388 4243 3388 4075 3360 4173 3136 4327 3010 4509 2730 4663 2520 4733 2394 [[w:Jesus]]
poly 5900 2100 5900 2150 5800 2400 5800 2500 5675 2589 5480 2671 5438 2507 5425 2301 5589 2452 5630 2301 5650 2100 [[w:Thomas the Apostle|Thomas]]
poly 5918 2150 6041 2109 6137 2246 6192 2411 6110 2589 6110 2726 6192 2822 6302 2740 6589 3109 5658 3178 5575 2918 5300 2698 5233 2589 5274 2438 5370 2507 5521 2685 5617 2671 5712 2575 5822 2507 5808 2287 5822 2175 [[w:James, son of Zebedee|James Greater]]
poly 6137 2013 6439 2013 6863 2260 7110 2515 6726 2675 6507 2548 6425 2630 6356 2753 6548 2849 6699 2781 7082 2794 7178 3109 6699 3178 6548 2986 6397 2835 6165 2775 6110 2589 6233 2438 6302 2383 6151 2287 6096 2164 [[w:Philip the Apostle|Philip]]
poly 7635 2123 7800 2013 8000 2055 8025 2287 7950 2438 8000 2698 8055 2918 7959 3164 7233 3164 7124 2972 7124 2794 6548 2794 6384 2781 6384 2671 6493 2575 6750 2650 7075 2550 7219 2400 7625 2300 [[w:Matthew the Apostle|Matthew]]
poly 8325 2096 8600 2109 8635 2493 8615 2726 8439 2781 8274 2740 8125 2835 8151 2931 8400 2975 8411 3068 8589 3041 8617 3205 7987 3260 8124 3027 7987 2644 7904 2493 7959 2425 8096 2356 [[w:Judas Thaddaeus|Jude]]
poly 8800 2150 8900 2125 9055 2150 9125 2397 9400 2475 9550 2931 9625 3301 9151 3397 8535 3219 8726 3014 8466 3068 8411 2918 8178 2931 8124 2835 8329 2753 8535 2794 8726 2603 8725 2342 [[w:Simon the Zealot|Simon]]
</imagemap>

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:ImageMap
* https://meta.wikimedia.org/wiki/ImageMapEdit_Howto
* https://www.familysearch.org/en/wiki/Help:Image_maps
* https://commons.wikimedia.org/wiki/Commons:Image_map_resources/zh
* https://en.wikipedia.org/wiki/Category:Wikipedia_image_maps
* https://meta.wikimedia.org/wiki/User:Dapete/ImageMapEdit#English
* https://www.maschek.hu/imagemap/
* https://www.image-maps.com/
* https://summerstyle.github.io/summer/
== inputbox ==
InputBox 扩展可以生成搜索或创建界面，便于用户快速跳转。

示例语法：
<syntaxhighlight lang="wikitext">
<inputbox>
type=search
arialabel=Search the Wiki
</inputbox>
</syntaxhighlight>

示例效果：
<inputbox>
type=search
arialabel=Search the Wiki
</inputbox>

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:InputBox
== syntaxhighlight ==
用于高亮展示代码。

示例语法：

<nowiki>
<syntaxhighlight lang="bash">
php -v
mysql --version
</syntaxhighlight>
</nowiki>

示例效果：
<syntaxhighlight lang="bash">
php -v
mysql --version
</syntaxhighlight>

== mapframe ==
Kartographer 扩展提供交互地图。当前站点未接入 Kartotherian 兼容地图服务时，地图可能无法显示或仅显示占位。

示例语法：
<syntaxhighlight lang="wikitext">
<mapframe latitude="39.9042" longitude="116.4074" zoom="12" width="600" height="400">
</mapframe>
</syntaxhighlight>

示例效果（若地图未显示，请检查 Kartographer 地图服务配置）：
<mapframe latitude="39.9042" longitude="116.4074" zoom="12" width="600" height="400">
</mapframe>

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:Kartographer
* https://www.openstreetmap.org/
== math ==
Math 扩展支持 LaTeX 与化学符号，适合数学与科学内容展示。

=== 示例（公式） ===
<math>
x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}
</math>

=== 示例（化学式） ===
<chem>Hg^2+ ->[I-] HgI2 ->[I-] {[Hg^{II}I4]^2-}</chem>

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:Math
== score ==
Score 扩展渲染乐谱，需配套 LilyPond 与 ffmpeg。

=== 示例 ===
<score vorbis="1">

\relative g' {

\key g \major \time 2/4

g8. b16 d8 d8 \bar "|" e4 d4 \bar "|" b8. g16 \times 2/3 {d'8 d d} \bar "|" b4 g4 \bar "|" \times 2/3 {d8 d d} \times 2/3 {d8 d d} \bar "|" g4 r8 d8 \bar "|" \break

g4. g8 \bar "|" g8. g16 d8 e16 fis16 \bar "|" g4 g4 \bar "|" r8 b8 g8 a16 b16 \bar "|" d4 d4 \bar "|" \break

b8. b16 g8. b16 \bar "|" d8. b16 a4 \bar "|" a2 \bar "|" e'4^> d4^> \bar "|" a4^> b4^> \bar "|" \break

d8^> b8^> r8 d8 \bar "|" b8 a16 b16 g4 \bar "|" b4 r4 \bar "|" d,8. e16 g8 g8 \bar "|" b8. b16 d8 d8 \bar "|" \break

a8 a16 a16 e4 \bar "|" a4. d,8 \bar "|" ^\< g4. g8 \bar "|" b4. b8 \! \bar "|" d2 \bar "|" \break

g,8. b16 d8 d8 \bar "|" e4 d4 \bar "|" b8. g16 \times 2/3 {d'8 d d} \bar "|" b8 r8 g8 r8 \bar "|" d4^> g4^> \bar "|" \break

b8. g16 \times 2/3 {d'8 d d} \bar "|" b8 r8 g8 r8 \bar "|" d4^> g4^> \bar "|" d4^> g4^> \bar "|" d4^> g4^> \bar "|" g4^> r4 \bar "|."

}

\addlyrics {

　　　　　　　　　　　　　　　　　　　　起

来！不愿做奴隶的人们！把我们的血肉，

筑成我们新的长城！中华民族

到了最危险的时候，每个人被迫着发出

最后的吼声。起来！起来！起来！

我们万众一心，冒着敌人的炮火前进！

冒着敌人的炮火前进！前进！前进！进！

}

</score>

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:Score
* https://lilypond.org/doc/v2.24/Documentation/web/manuals
== hiero ==
WikiHiero 支持古埃及象形文字排版。

示例语法：
<syntaxhighlight lang="wikitext">
<hiero>A1</hiero>
</syntaxhighlight>

示例效果：
<hiero>A1</hiero>

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:WikiHiero
== PdfHandler ==
PdfHandler 扩展提供 PDF 预览与嵌入，适合文档展示。

示例语法：
<syntaxhighlight lang="wikitext">
[[File:EXCEL 2016 QUICK START GUIDE.PDF|thumb|500px|EXCEL 2016 QUICK START GUIDE.PDF]]
</syntaxhighlight>

示例效果：
[[File:EXCEL 2016 QUICK START GUIDE.PDF|thumb|500px|EXCEL 2016 QUICK START GUIDE.PDF]]

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:PdfHandler
== TimedMediaHandler ==
TimedMediaHandler 和相关工具链支持音视频上传与预览。

以下示例使用维基共享资源（Commons）中的公共文件，理论上可直接显示：

示例语法：
<syntaxhighlight lang="wikitext">
[[File:Example.ogg|thumb|音频示例（Commons）]]
[[File:Example.ogg|30px]]
[[File:Big Buck Bunny - closing credits.webm|300px|thumb|视频示例（Commons）]]
</syntaxhighlight>

示例效果：
[[File:Example.ogg|thumb|音频示例（Commons）]]

[[File:Big Buck Bunny - closing credits.webm|300px|thumb|视频示例（Commons）]]

=== 参见 ===
* https://www.mediawiki.org/wiki/Extension:TimedMediaHandler