Latest revision as of 22:21, 10 August 2026

管理员操作指南

本站把“程序与界面”和“日常内容”分开管理：

Git 管理：扩展版本、发布脚本、模板、表单、CSS、JavaScript、首页外壳和本指南。
Wiki 数据库管理：Citizen 全站主菜单、首页分类顺序、分类内模块顺序、模块内产品卡片、产品内容及管理员上传文件。

日常维护只使用网页表单，不需要登录服务器或修改代码。

登录与统一入口

访问管理员登录。
打开产品目录管理。
访客可以查看主菜单和内容，但不能打开保存、创建或上传接口。

管理首页分类

在管理页点击“管理首页分类与排序”。
“添加分类”可新增一级分类；拖动分类块可排序。
每个分类需要一个独立配置页，例如 Project:首页分类/Displays。
从表单移除分类仅从首页下线，分类配置页和下级内容不会删除。

管理分类中的模块

在管理页的“当前首页结构”中找到分类，点击“管理……中的模块”。
添加或拖动模块块，维护模块标题、标签栏、介绍和模块配置页。
模块标题自动成为首页正文标题和 Citizen 左侧目录项。
从分类移除模块仅下线引用，模块配置页、卡片及产品页保留。

管理模块中的产品卡片

在管理预览中找到模块，点击“管理……的产品”。
每张卡片选择一个不同的“目标产品页面”，同一产品页不能在首页重复使用。
卡片标题、型号和图片始终跟随目标产品页；需要修改时，直接编辑该产品。
拖动卡片块排序；移除卡片不会删除目标产品页。

创建和一键编辑产品

在管理页输入稳定的产品页面网址名称，点击“创建或编辑产品”。
以后在产品页顶部点击“编辑产品”，即可直接打开同一个表单。
“产品标题”是页面显示标题，可以随时修改；浏览器网址、页面名称和历史不变。
基本信息、图片和介绍默认展开，其余区域可按需展开。
简介、产品要点、硬件说明、使用说明和 FAQ 使用类似 Word 的可视化编辑器。选中文字后点击工具栏中的“Text color”按钮可设置字体颜色；色板顶部的“默认颜色”可清除自定义颜色并恢复网页默认字体颜色。
图片字段可直接上传和预览，仍受 200 MiB、文件类型和 ClamAV 检查限制。

添加产品视频

打开产品页并点击“编辑产品”，展开“产品视频”。
旧版英文产品页使用 ProductPage 表单，对应区域名称为“Video”，其中依次填写 Video Title、Video URL、Video Cover 和 Video Description。
填写完整的 YouTube 视频 URL，例如 https://www.youtube.com/watch?v=M7lc1UVf-VE。
按需填写视频标题、上传或选择视频封面，并使用可视化编辑器填写视频说明。
保存后，产品页只显示 16:9 的内嵌播放器；手机端会按页面宽度等比例缩放。
视频 URL 留空时，整个播放器自动隐藏；删除已有 URL 并保存即可下线视频。

播放器统一显示在 Introduction／产品介绍之前；前台不生成 Video／产品视频章节标题和目录项，也不显示视频封面、标题、说明或“Open on YouTube”详情卡。表单中的这些已有字段继续保留，避免删除历史数据。

视频播放器仅接受 YouTube 地址，并使用 YouTube 隐私增强域名加载。视频本体不上传到本站，因此不占用服务器上传空间和备份容量。

草稿、归档与恢复

“已发布”：产品页和自动同步卡片正常显示。
“草稿”或“已归档”：自动同步卡片从首页隐藏，产品页与历史继续保留。
分类、模块或卡片从表单移除后，可通过重新添加原配置页或产品页恢复。
彻底删除只使用 MediaWiki 删除功能；执行前应确认备份和引用关系。

管理 Citizen 全站主菜单

在管理页点击“管理全站主菜单”。
MenuEditor 会为 MediaWiki:Sidebar 提供图形化菜单编辑界面。
添加、删除或排序菜单项并保存；菜单会对访客和管理员全部显示。
主菜单属于 Wiki 数据库，正常 Git 发布不会覆盖在线修改。

注意事项

产品长文本区域建议使用编辑器工具栏，不要直接粘贴整页 HTML。
产品图片优先使用独立的主图、副图字段，避免在长文本中插入大图导致版式溢出。
每个首页卡片对应一个独立产品页；不要在多个卡片中重复选择同一产品。
保存后若暂未看到变化，先强制刷新；仍异常时检查文档状态及目标产品页面。

@@ Line 1: / Line 1: @@
 = 管理员操作指南 =
-本页说明如何维护技术文档中心。访客只能阅读和下载，以下操作需要使用管理员账号登录。
+本站把“程序与界面”和“日常内容”分开管理：
-== 登录与编辑 ==
+* Git 管理：扩展版本、发布脚本、模板、表单、CSS、JavaScript、首页外壳和本指南。
+* Wiki 数据库管理：Citizen 全站主菜单、首页分类顺序、分类内模块顺序、模块内产品卡片、产品内容及管理员上传文件。
-# 打开 [[Special:UserLogin|管理员登录]]，输入管理员账号。
+日常维护只使用网页表单，不需要登录服务器或修改代码。
-# 进入目标页面，选择“编辑”使用 VisualEditor，或选择“编辑源代码”修改 Wiki 文本。
-# 填写编辑摘要并保存。所有修改都会进入页面历史，可以比较或回退。
-== 新建产品文档 ==
+== 登录与统一入口 ==
-# 在浏览器地址中打开计划使用的新页面标题。
+# 访问 [[Special:UserLogin|管理员登录]]。
-# 插入模板“产品信息”，填写型号、类别、主控、接口、版本和更新时间。
+# 打开 [[Project:产品目录管理|产品目录管理]]。
-# 按“产品概述、主要特性、快速开始、资料下载、常见问题”的结构编写正文。
+# 访客可以查看主菜单和内容，但不能打开保存、创建或上传接口。
-# 在页面底部加入对应分类，例如 <code><nowiki>[[Category:芯片与MCU]]</nowiki></code>。
-== 上传与更新附件 ==
+== 管理首页分类 ==
-# 通过 [[Special:Upload|上传资料]] 上传 PDF、图片、Office、TXT、ZIP/7Z、DWG 或 DXF。
+# 在管理页点击“管理首页分类与排序”。
-# 单文件不得超过 200MiB；所有附件必须通过扩展名、MIME 和 ClamAV 检查。
+# “添加分类”可新增一级分类；拖动分类块可排序。
-# 在产品页插入“下载项”模板并填写 MediaWiki 文件名。
+# 每个分类需要一个独立配置页，例如 <code>Project:首页分类/Displays</code>。
-# 更新已有资料时进入文件页，使用“上传该文件的新版本”，不要删除旧记录。
+# 从表单移除分类仅从首页下线，分类配置页和下级内容不会删除。
-== 维护首页和导航 ==
+== 管理分类中的模块 ==
-* 首页：编辑 [[Main_Page]]。
+# 在管理页的“当前首页结构”中找到分类，点击“管理……中的模块”。
-* 侧边导航：编辑 [[MediaWiki:Sidebar]]。
+# 添加或拖动模块块，维护模块标题、标签栏、介绍和模块配置页。
-* 全站样式：仅 interface-admin 可编辑 [[MediaWiki:Common.css]]。
+# 模块标题自动成为首页正文标题和 Citizen 左侧目录项。
-* 模板：[[Template:产品信息]]、[[Template:下载项]]、[[Template:文档状态]]。
+# 从分类移除模块仅下线引用，模块配置页、卡片及产品页保留。
-== 版本回退 ==
+== 管理模块中的产品卡片 ==
-进入页面的“查看历史”标签，比较目标版本，确认差异后执行回退。附件历史在文件页单独维护。
+# 在管理预览中找到模块，点击“管理……的产品”。
+# 每张卡片选择一个不同的“目标产品页面”，同一产品页不能在首页重复使用。
+# 卡片标题、型号和图片始终跟随目标产品页；需要修改时，直接编辑该产品。
+# 拖动卡片块排序；移除卡片不会删除目标产品页。
-== 安全注意事项 ==
+== 创建和一键编辑产品 ==
-* 不上传来源不明的压缩包或可执行程序。
+# 在管理页输入稳定的产品页面网址名称，点击“创建或编辑产品”。
-* 不在页面正文中保存密码、API 密钥或内部账号。
+# 以后在产品页顶部点击“编辑产品”，即可直接打开同一个表单。
-* 完成初次验收后立即修改管理员初始密码。
+# “产品标题”是页面显示标题，可以随时修改；浏览器网址、页面名称和历史不变。
+# 基本信息、图片和介绍默认展开，其余区域可按需展开。
+# 简介、产品要点、硬件说明、使用说明和 FAQ 使用类似 Word 的可视化编辑器。选中文字后点击工具栏中的“Text color”按钮可设置字体颜色；色板顶部的“默认颜色”可清除自定义颜色并恢复网页默认字体颜色。
+# 图片字段可直接上传和预览，仍受 200 MiB、文件类型和 ClamAV 检查限制。
+== 添加产品视频 ==
+# 打开产品页并点击“编辑产品”，展开“产品视频”。
+# 旧版英文产品页使用 <code>ProductPage</code> 表单，对应区域名称为“Video”，其中依次填写 Video Title、Video URL、Video Cover 和 Video Description。
+# 填写完整的 YouTube 视频 URL，例如 <code>https://www.youtube.com/watch?v=M7lc1UVf-VE</code>。
+# 按需填写视频标题、上传或选择视频封面，并使用可视化编辑器填写视频说明。
+# 保存后，产品页只显示 16:9 的内嵌播放器；手机端会按页面宽度等比例缩放。
+# 视频 URL 留空时，整个播放器自动隐藏；删除已有 URL 并保存即可下线视频。
+播放器统一显示在 Introduction／产品介绍之前；前台不生成 Video／产品视频章节标题和目录项，也不显示视频封面、标题、说明或“Open on YouTube”详情卡。表单中的这些已有字段继续保留，避免删除历史数据。
+视频播放器仅接受 YouTube 地址，并使用 YouTube 隐私增强域名加载。视频本体不上传到本站，因此不占用服务器上传空间和备份容量。
+== 草稿、归档与恢复 ==
+* “已发布”：产品页和自动同步卡片正常显示。
+* “草稿”或“已归档”：自动同步卡片从首页隐藏，产品页与历史继续保留。
+* 分类、模块或卡片从表单移除后，可通过重新添加原配置页或产品页恢复。
+* 彻底删除只使用 MediaWiki 删除功能；执行前应确认备份和引用关系。
+== 管理 Citizen 全站主菜单 ==
+# 在管理页点击“管理全站主菜单”。
+# MenuEditor 会为 <code>MediaWiki:Sidebar</code> 提供图形化菜单编辑界面。
+# 添加、删除或排序菜单项并保存；菜单会对访客和管理员全部显示。
+# 主菜单属于 Wiki 数据库，正常 Git 发布不会覆盖在线修改。
+== 注意事项 ==
+* 产品长文本区域建议使用编辑器工具栏，不要直接粘贴整页 HTML。
+* 产品图片优先使用独立的主图、副图字段，避免在长文本中插入大图导致版式溢出。
+* 每个首页卡片对应一个独立产品页；不要在多个卡片中重复选择同一产品。
+* 保存后若暂未看到变化，先强制刷新；仍异常时检查文档状态及目标产品页面。
 [[Category:站点帮助]]