Latest revision as of 22:54, 25 July 2026

管理员操作指南

本站的页面样式、表单和模板由 Git 发布；首页目录配置、模块卡片和产品二级页由 MediaWiki 数据库保存。日常维护请使用表单，不要直接修改服务器文件。

登录与管理入口

访问管理员登录，使用具有 sysop 权限的账号登录。
打开目录管理后台。
首页模块顺序、模块卡片和产品页分别使用对应表单维护。

调整首页模块

在目录管理后台点击“编辑首页模块顺序”。
使用“添加模块”或删除按钮增减模块。
拖动模块右侧的排序手柄调整顺序。
模块标题会同时成为首页标题和 Citizen 左侧目录项。
保存后刷新首页确认结果。

调整模块卡片

在目录管理后台选择目标模块。
使用模块表单新增、编辑、删除或拖动卡片。
卡片的“目标页面”可以指向已有产品页；同一产品页允许被多张卡片引用。
从模块表单移除卡片不会删除目标产品页。

创建或编辑产品页

在目录管理后台输入产品页面名称并打开产品表单。
填写型号、模块、图片、介绍、参数、硬件说明、使用说明和常见问题。
图片字段可直接上传并显示预览；上传仍受 200MiB、文件类型和 ClamAV 检查限制。
保存后将页面名称填入对应卡片的“目标页面”字段。

删除与恢复

从表单移除模块或卡片只是从首页下线，不会级联删除页面或文件。
彻底删除页面请使用页面工具中的“删除”；删除记录可由管理员恢复。
删除产品页前，应先移除所有指向该页的首页卡片，避免出现红色链接。

Git 管理边界

Git 管理：主页外壳、CSS、侧栏、表单定义、模板和本指南。
Wiki 数据库管理：首页目录配置、各模块卡片配置、产品二级页和管理员后续上传文件。
初始演示数据只播种一次；正常 Git 发布不会覆盖管理员已经保存的目录和产品数据。

@@ Line 1: / Line 1: @@
 = 管理员操作指南 =
-本页说明如何维护技术文档中心。访客只能阅读和下载，以下操作需要使用管理员账号登录。
+本站的页面样式、表单和模板由 Git 发布；首页目录配置、模块卡片和产品二级页由 MediaWiki 数据库保存。日常维护请使用表单，不要直接修改服务器文件。
-== 登录与编辑 ==
+== 登录与管理入口 ==
-# 打开 [[Special:UserLogin|管理员登录]]，输入管理员账号。
+# 访问 [[Special:UserLogin|管理员登录]]，使用具有 <code>sysop</code> 权限的账号登录。
-# 进入目标页面，选择“编辑”使用 VisualEditor，或选择“编辑源代码”修改 Wiki 文本。
+# 打开 [[Project:产品目录管理|目录管理后台]]。
-# 填写编辑摘要并保存。所有修改都会进入页面历史，可以比较或回退。
+# 首页模块顺序、模块卡片和产品页分别使用对应表单维护。
-== 新建产品文档 ==
+== 调整首页模块 ==
-# 在浏览器地址中打开计划使用的新页面标题。
+# 在目录管理后台点击“编辑首页模块顺序”。
-# 插入模板“产品信息”，填写型号、类别、主控、接口、版本和更新时间。
+# 使用“添加模块”或删除按钮增减模块。
-# 按“产品概述、主要特性、快速开始、资料下载、常见问题”的结构编写正文。
+# 拖动模块右侧的排序手柄调整顺序。
-# 在页面底部加入对应分类，例如 <code><nowiki>[[Category:芯片与MCU]]</nowiki></code>。
+# 模块标题会同时成为首页标题和 Citizen 左侧目录项。
+# 保存后刷新首页确认结果。
-== 上传与更新附件 ==
+== 调整模块卡片 ==
-# 通过 [[Special:Upload|上传资料]] 上传 PDF、图片、Office、TXT、ZIP/7Z、DWG 或 DXF。
+# 在目录管理后台选择目标模块。
-# 单文件不得超过 200MiB；所有附件必须通过扩展名、MIME 和 ClamAV 检查。
+# 使用模块表单新增、编辑、删除或拖动卡片。
-# 在产品页插入“下载项”模板并填写 MediaWiki 文件名。
+# 卡片的“目标页面”可以指向已有产品页；同一产品页允许被多张卡片引用。
-# 更新已有资料时进入文件页，使用“上传该文件的新版本”，不要删除旧记录。
+# 从模块表单移除卡片不会删除目标产品页。
-== 维护首页和导航 ==
+== 创建或编辑产品页 ==
-* 首页：编辑 [[Main_Page]]。
+# 在目录管理后台输入产品页面名称并打开产品表单。
-* 侧边导航：编辑 [[MediaWiki:Sidebar]]。
+# 填写型号、模块、图片、介绍、参数、硬件说明、使用说明和常见问题。
-* 全站样式：仅 interface-admin 可编辑 [[MediaWiki:Common.css]]。
+# 图片字段可直接上传并显示预览；上传仍受 200MiB、文件类型和 ClamAV 检查限制。
-* 模板：[[Template:产品信息]]、[[Template:下载项]]、[[Template:文档状态]]。
+# 保存后将页面名称填入对应卡片的“目标页面”字段。
-== 版本回退 ==
+== 删除与恢复 ==
-进入页面的“查看历史”标签，比较目标版本，确认差异后执行回退。附件历史在文件页单独维护。
+* 从表单移除模块或卡片只是从首页下线，不会级联删除页面或文件。
+* 彻底删除页面请使用页面工具中的“删除”；删除记录可由管理员恢复。
+* 删除产品页前，应先移除所有指向该页的首页卡片，避免出现红色链接。
-== 安全注意事项 ==
+== Git 管理边界 ==
-* 不上传来源不明的压缩包或可执行程序。
+* Git 管理：主页外壳、CSS、侧栏、表单定义、模板和本指南。
-* 不在页面正文中保存密码、API 密钥或内部账号。
+* Wiki 数据库管理：首页目录配置、各模块卡片配置、产品二级页和管理员后续上传文件。
-* 完成初次验收后立即修改管理员初始密码。
+* 初始演示数据只播种一次；正常 Git 发布不会覆盖管理员已经保存的目录和产品数据。
 [[Category:站点帮助]]