差别

这里会显示出您选择的修订版和当前版本之间的差别。

--- about:editing_guide [2026/07/21 17:09] – 创建 - 外部编辑 127.0.0.1
+++ about:editing_guide [2026/07/31 15:13] (当前版本) – 外部编辑 127.0.0.1
@@ 行 1: / 行 1: @@
-====== 编辑指南 ======
+====== Wiki 编辑教程 ======
-===== 基本原则 =====
+本教程面向获得编辑权限的维护者，介绍页面编辑、DokuWiki 常用语法、图片上传、创建页面和新建分类的方法。
-  * 先写读者真正需要完成的事情，再补背景。
+===== 一、编辑前先了解 =====
-  * 日期、费用、政策与联系方式必须附来源和核实日期。
-  * 学生经验要明确标为经验，不能冒充校方规定。
-  * 不发布身份证号、学号、宿舍人员名单、私人手机号等个人信息。
-  * 图片上传前去除敏感元数据并压缩；第一版仅允许 JPG、PNG、WebP，单文件不超过 2 MiB。
-===== 发布流程 =====
+  * **页面**：一个可独立访问的词条，例如 `study:gpa`。
+  * **分类（命名空间）**：用英文冒号分隔的页面集合，例如 `study:*`。
+  * **分类首页**：分类中的 `start` 页面，例如 `study:start`。
+  * **分类侧栏**：分类中的 `sidebar` 页面，例如 `study:sidebar`。
-发现缺失 → 在 [[internal:drafts|草稿区]] 编写 → 审核来源与时效 → 移入正式栏目 → 公开发布。
+页面 ID 建议只使用小写英文字母、数字和下划线。不要使用空格，不要随意改动已经被大量引用的页面 ID。
-普通生活经验可由栏目维护者直接修改；学校政策、收费、日期、考试与奖助学金规则应先审核。
+===== 二、编辑现有页面 =====
-===== 页面头部 =====
+  - 登录后打开要修改的页面。
+  - 点击右侧的“编辑本页”图标；也可以使用页面标题旁的“编辑本段”。
+  - 修改内容后填写“编辑摘要”，简要说明改了什么。
+  - 先点击“预览”，检查标题、链接、列表和表格。
+  - 确认无误后保存。
-新建页面时使用系统自动加载的模板，至少填写状态、校区、最后核实日期、维护小组和信息来源。
+建议一次只处理一个主题。涉及政策、费用、时间、联系方式或办理流程时，应附官方来源和核对日期。
+===== 三、标题与段落 =====
+DokuWiki 使用等号表示标题，等号越多，标题层级越高：
+<code>
+====== 页面标题 ======
+===== 一级小节 =====
+==== 二级小节 ====
+=== 三级小节 ===
+</code>
+每个页面只使用一个最高级标题。普通段落之间留一个空行，不要用连续空格模拟缩进。
+===== 四、文字格式 =====
+<code>
+**粗体**
+//斜体//
+__下划线__
+''等宽文字''
+<del>删除线</del>
+</code>
+强制换行可在行末使用两个反斜杠：
+<code>
+第一行\\
+第二行
+</code>
+只有确实需要时才使用强制换行，普通段落优先留空行。
+===== 五、列表 =====
+无序列表使用两个空格加星号：
+<code>
+  * 第一项
+  * 第二项
+    * 子项目
+</code>
+有序列表使用两个空格加减号：
+<code>
+  - 第一步
+  - 第二步
+    - 子步骤
+</code>
+不要手动输入“1.”、“2.”模拟步骤，否则插入新步骤后编号不会自动更新。
+===== 六、链接 =====
+==== 站内页面 ====
+<code>
+[[study:gpa|GPA 计算]]
+[[campus:start|校园生活]]
+[[study:gpa#常见误区|跳到 GPA 页的常见误区]]
+</code>
+==== 外部链接 ====
+<code>
+[[https://www.ahu.edu.cn/|安徽大学官网]]
+</code>
+链接文字要能说明目的，避免使用“点这里”。保存前检查链接是否为红色；红色链接表示目标页面不存在。
+===== 七、图片与附件 =====
+  - 在编辑器中点击媒体管理器。
+  - 选择与页面相同或相关的分类上传文件。
+  - 文件名使用小写英文、数字和下划线。
+  - 插入图片时填写替代文字，说明图片内容。
+<code>
+{{:campus:building.jpg?800|教学楼外观}}
+{{:study:course_table.pdf|课程安排附件}}
+</code>
+数字表示图片显示宽度。不要上传含有身份证号、手机号、宿舍门牌、人脸等敏感信息的图片；转载图片必须确认授权并标明来源。
+===== 八、引用、代码与原样文本 =====
+引用或重要提醒可使用引用符号：
+<code>
+> 政策与办理时间请以学校最新通知为准。
+</code>
+代码块：
+<nowiki>
+<code bash>
+echo "example"
+</code>
+</nowiki>
+需要展示 DokuWiki 语法而不让它被解析时，使用：
+<code>
+<nowiki>[[study:gpa|这段不会变成链接]]</nowiki>
+</code>
+===== 九、表格 =====
+表头使用 `^`，普通单元格使用 `|`：
+<code>
+^ 项目 ^ 说明 ^
+| 地点 | 龙河校区 |
+| 状态 | 以最新通知为准 |
+</code>
+表格适合对比短信息。长篇说明应改用标题、段落或列表，避免在手机上出现过宽表格。
+===== 十、脚注与分隔线 =====
+脚注写法：
+<code>
+这是一条需要补充说明的信息((脚注内容写在这里。))。
+</code>
+水平分隔线：
+<code>
+----
+</code>
+分隔线不要滥用，通常标题层级已经足够区分内容。
+===== 十一、新建普通页面 =====
+推荐先在现有页面中添加链接：
+<code>
+[[study:new_topic|新主题]]
+</code>
+保存后点击红色链接，再选择“创建此页”。这样可以避免输错页面 ID，也能保证新页面至少有一个入口。
+新页面应包含：
+  * 清晰且唯一的页面标题。
+  * 一段说明适用范围的开头。
+  * 可执行的步骤或经过整理的信息。
+  * 相关页面链接。
+  * 政策类内容的来源和核对日期。
+===== 十二、新建分类 =====
+假设要创建 `services` 分类：
+==== 1. 创建分类首页 ====
+先创建 `services:start`：
+<code>
+====== 校园服务 ======
+本分类收录校内办事与公共服务。
+  * [[services:student_center|学生服务中心]]
+  * [[services:repair|报修]]
+</code>
+==== 2. 创建分类侧栏 ====
+再创建 `services:sidebar`：
+<code>
+**[[services:start|校园服务]]**
+  * [[services:student_center|学生服务中心]]
+  * [[services:repair|报修]]
+----
+  * [[start|返回 Wiki 首页]]
+</code>
+DokuWiki 会在 `services:*` 页面中优先显示这个侧栏。
+==== 3. 创建分类内页面 ====
+创建 `services:student_center`、`services:repair` 等页面，并确保侧栏中的每个链接都有实际内容。
+==== 4. 添加全站入口 ====
+编辑根侧栏 `sidebar` 和首页 `start`，加入 <nowiki>[[services:start|校园服务]]</nowiki>。如果不添加全站入口，读者很难发现新分类。
+==== 5. 检查权限 ====
+新分类可能继承上级权限。若需要限制编辑或阅读，联系管理员调整 ACL；不要通过隐藏链接代替权限控制。
+===== 十三、移动、重命名与删除 =====
+DokuWiki 默认不一定提供完整的页面移动功能。需要重命名时：
+  - 先创建新 ID 的页面并复制内容。
+  - 更新所有侧栏和正文链接。
+  - 检查“反向链接”中是否还有旧链接。
+  - 确认无引用后，再清空旧页面内容完成删除。
+删除或批量移动分类前应先备份，并由管理员处理。
+===== 十四、内容质量与安全 =====
+  * 不写无法核实的政策结论，不把往年规则描述成当前规则。
+  * 不公开邀请码、账号、密码、手机号、身份证号或内部文件。
+  * 不提供绕过课程、考试、门禁、网络或安全规定的方法。
+  * 学生经验应明确写成“经验”，并允许其他维护者修正。
+  * 引用外部图片和文字时遵守版权要求。
+===== 十五、发布前检查 =====
+  - 标题层级是否连续？
+  - 页面 ID 和分类是否正确？
+  - 是否存在红色的意外链接？
+  - 图片是否有替代文字和来源？
+  - 表格在手机端是否容易阅读？
+  - 政策、费用、时间和联系方式是否附来源与核对日期？
+  - 编辑摘要是否说明了本次变化？
+完成后保存页面，并再次打开确认最终显示效果。