编辑指南

我按你已经确定的共创流程，把这版编辑指南改成更偏“实际编辑规范”的文档：共创原则只作为前提，不重复共创指南；语法部分补上了你新增的 **页面状态模板、引用块、术语提示、剧透黑块、折叠区块**。这些新增语法来自你已经注入的 JS/CSS 方案：页面模板语法使用 `【【模板名|签名|留言】】`，引用块使用 `模板:Quote`，术语提示、黑块文字和手风琴也都在现有脚本与样式中实现。

Wiki.js 官方文档说明其 Markdown 编辑器支持 CommonMark 并包含 GitHub Flavored Markdown 扩展；Wiki.js 也提供多种编辑器，其中 Code 编辑器是原始 HTML 编辑器，官方并不建议将其作为新内容的常规写作方式。([Wiki.js][1])

````markdown id="ndzhv0" 欢迎参与 **自新博物馆世设维基** 的编纂工作。本维基旨在系统化记录架空世界的设定，并为协作创作、资料整理、公开展示与 TRPG 游戏提供稳定的文本基础。

请务必在编辑前阅读本指南，以确保您所编辑的内容符合本维基的基本规范。

1. 说明

本文档是本维基的 **编辑指南**，主要规定页面创建、命名路径、Markdown 语法、页面编写、标签使用与资产管理等基本要求，以维护维基结构与内容风格的一致性。

本指南只处理“如何编辑页面”的技术性与格式性问题。若您计划新增设定、修改既有设定、参与互评、处理争议或推进时间线，请同时阅读 [**共创指南**](/共创指南)。共创指南规定的是设定进入公共世界的流程；本指南规定的是页面如何被正确书写。

如有疑问或建议，请在页面讨论区留言，或前往 [**项目协作群**](https://qm.qq.com/q/F0m6zn9UU8) 交流。

---

1. 开始编辑

1. 1. 了解维基

在编辑前，请先理解对应世界观的主要基调与基准设定。自新博物馆世设维基并非单纯的信息堆放处，而是面向多个架空世界的协作资料库。每个页面都应当服务于其所属世界的整体叙事、结构与可读性。

若您尚不熟悉某一世界，请先阅读其 **世界总览**、**历史沿革**、**地理总览** 或相关索引页面，再开始创建新条目。对于可能影响多个页面的内容，应先在讨论区或协作群中征求意见。

1. 1. 操作方式

在已有页面右上角点击“编辑”即可进入编辑界面。创建新页面时，请使用顶部的“创建页面”按钮，并严格按照本指南的“页面命名与路径”规范填写路径。

除非您明确知道自己正在处理原始 HTML 页面，否则请优先使用 **Markdown 编辑器**。Markdown 语法简洁、易于审阅，也更适合多人协作。原始 HTML 编辑器主要用于迁移旧页面或处理特殊布局，不建议作为常规写作方式。

编辑完成后点击保存即可。页面历史版本会保留在系统中，但这并不意味着可以随意覆盖他人内容。涉及事实变化、设定判断或大段重写的修改，应先遵循共创指南中的讨论流程。

1. 基础语法

1. 1. Markdown

本维基推荐使用 **Markdown** 作为主要编辑语言。Markdown 适合编写标题、段落、列表、链接、表格、引用与代码块，能够在保持文本清晰的同时降低排版成本。

常用语法如下：

```markdown

1. 一级标题
   1. 二级标题
      1. 三级标题

这是一段正文。

• • 加粗文本**
• 斜体文本*

- 无序列表 - 无序列表

1. 有序列表 2. 有序列表

[链接文字](/页面路径)

> 引用文字

| 表头 | 表头 | |---|---| | 内容 | 内容 | ````

标题层级应当按顺序使用，不宜为了视觉效果跳级。一般页面标题由系统页面名承担，正文中从 `#` 或 `##` 开始均可，但同一页面内应保持一致。

1. 1. HTML

Markdown 中可以嵌入少量 HTML，以实现复杂布局或调用本站已配置的特殊样式。例如折叠区块、提示框或复杂表格可以使用 HTML 辅助完成。

但请注意：不要在普通页面中随意加入 `<style>`、`<script>` 或大量内联样式。全站可复用的样式和脚本应由管理者统一维护；单页临时样式容易破坏维基风格，也会增加后续维护难度。

如需新增可复用的视觉样式、页面组件或模板语法，请先在协作群中讨论，再交由管理者统一加入全站 CSS 或 HTML 注入。

1. 页面命名与路径

页面路径即页面分类。路径应采用清晰、稳定的树状结构，基本格式为：

```markdown /世界名/分类/条目名 ```

例如：

```markdown /弥恩诸世/人物汇总/人物名 /弥恩诸世/人文地理/地点/地点名 /弥恩诸世/政权组织/组织/组织名 /弥恩诸世/历史沿革/事件名 /弥恩诸世/神明与信仰/神明名 ```

路径应以页面的长期归属为依据，而不是以一时用途或当前编辑者习惯为依据。请避免在根目录创建大量独立页面，也不要使用过深嵌套。一般情况下，路径层级建议不超过三级；若确需更深层级，应确认该分类确有长期扩展价值。

页面名称应简明、准确，尽量使用设定中的正式名称。若存在同名或近似名称，应建立消歧义页，而不是用随意后缀区分。

1. 页面结构

同一分类下的页面应尽量遵循统一结构，以便读者快速比较和检索信息。页面不必机械套用模板，但应至少包含能够说明条目性质的基本内容。

一般条目可以采用如下顺序：

```markdown

1. 条目名

简要介绍该条目的性质、地位与重要性。

1. 1. 概要

说明此条目是什么，以及它在所属世界中为何重要。

1. 1. 基本信息

列出必要的结构化信息，如所属地区、活跃时间、相关势力、相关人物等。

1. 1. 正文

根据条目类型展开说明。

1. 1. 相关页面

- [相关页面](/页面路径) ```

人物、组织、政权、地区、历史事件、神明、规则等页面可以根据需要使用不同结构，但同一子分类下的页面应保持相近的信息组织方式。若某个页面被标记为 **模板参考**，编辑同类页面时应优先参照该页面。

1. 行文规范

页面文字应自然、流畅、准确。叙述语气应符合所属世界的基调，同时保持维基文本应有的清晰性。除非页面本身是世界内文献、角色独白或跑团记录，一般不宜使用过于口语化、情绪化或立场过强的表达。

中文、英文、数字与单位之间应适度空格。例如：

```markdown DND 3.5E 221 纪年 30 日 10 gp DC 20 ```

已经确定的专有名词应保持一致，不要随意创造同义写法。若一个概念已有正式页面，首次出现时可以添加内链；同一页面内反复出现的同一概念，不必每次都链接，以免影响阅读。

页面中若需要说明编辑意图，可使用 HTML 注释：

```html ```

注释应简短明确，不应用来写争论内容或私人留言。需要讨论的问题应转移至讨论区或协作群。

1. 内部链接

内部链接应服务于阅读，而不是为了堆砌索引。通常情况下，重要概念、人物、地区、政权、历史事件在正文首次出现时添加链接即可。

推荐写法：

```markdown [弥恩诸世](/弥恩诸世/世界总览) [帝国监护政府](/弥恩诸世/政权组织/政权/帝国监护政府) ```

不推荐写法：

```markdown [点击这里](/弥恩诸世/世界总览) ```

链接文字应直接说明目标页面内容，避免使用“这里”“这个页面”等含糊表达。

若目标页面尚未创建，可以先保留普通文本，或在确有必要时建立占位页，并使用页面状态模板标明“占位”。

1. 页面状态模板

页面状态模板用于标记页面在共创流程中的位置。它们不是正文内容的一部分，而是提醒读者和编辑者：该页面目前是否稳定、是否可引用、是否需要讨论或修订。

语法格式为：

```markdown 【【模板名】】 【【模板名|编辑者签名】】 【【模板名|编辑者签名|补充说明】】 ```

共创流程中的主要状态如下：

```markdown 【【提案|署名|本页面为初步构想，尚未进入草稿阶段。】】

【【草稿|署名|内容仍在整理中，请勿视为稳定设定。】】

【【待互评|署名|请重点检查是否与既有时间线和地区设定冲突。】】

【【修订中|署名|正在根据互评意见调整内容。】】

【【确认中|署名|若无重大争议，本页面将在确认期结束后锚定。】】

【【已锚定|署名|事实性修改请先依照共创指南发起讨论。】】 ```

其他常用状态如下：

```markdown 【【需要改进|署名|页面缺少历史背景和相关页面链接。】】

【【占位|署名|此页面仅为后续条目预留路径。】】

【【模板参考|署名|同类页面可参照此页面结构。】】

【【精选|署名|此页面可作为高质量范例。】】

【【消歧义】】

【【剧透警告|署名|本文涉及尚未公开的跑团结局。】】

【【非正史|署名|此内容不进入主时间线。】】

【【跑团记录|署名|本页面整理自某次 TRPG 战役。】】

【【废案归档|署名|此设定已废弃，仅保留参考。】】 ```

页面状态模板一般置于页面正文开头。若一个页面同时需要多个提示，应控制数量，优先保留最能说明页面状态的模板。例如“跑团记录”与“剧透警告”可以并用，但“草稿”“修订中”“确认中”通常不应同时出现。

1. 术语提示

术语提示用于在不打断正文阅读的情况下解释概念。它适合用于世界观专有名词、规则术语、组织简称或读者可能不熟悉的概念。

本页内术语引用：

```markdown 模板:魔网 ```

跨页面术语引用：

```markdown 模板:魔网 ```

当读者将鼠标悬停在术语上时，页面会尝试显示对应标题下的内容。若点击术语，则会跳转至对应页面或本页对应段落。

术语提示应适度使用。若一个概念对理解当前段落至关重要，优先考虑使用普通内链或直接解释；若只是补充说明，则可以使用术语提示。

1. 引用块

引用块用于表现题词、世界内文献、人物引言、史书摘录或章节开头的风格化文本。

基本语法：

```markdown 模板:Quote ```

带补充说明：

```markdown 模板:Quote ```

带样式参数：

```markdown 模板:Quote ```

一般情况下，不建议使用 `style=` 参数。引用块样式已由全站 CSS 统一控制，只有在页面具有明确视觉需求时，才应使用少量内联样式。

1. 剧透与隐藏文字

如页面涉及尚未公开的跑团内容、关键谜底、人物结局或重大剧情反转，应先使用 **剧透警告** 页面模板，再视情况隐藏具体文本。

黑块文字语法如下：

```markdown 普通文本之后是 ((这是一段隐藏内容))。 ```

该语法适用于短句或少量关键词，不适合隐藏大段正文。若需要隐藏整段或整节内容，应考虑拆分为单独页面，或在标题处明确标注剧透。

1. 折叠区块

折叠区块适合用于较长的资料列表、可选阅读内容、跑团记录分幕、规则补充或多版本文本。折叠区块使用 HTML 写法。

示例：

```html

1. 1. 1. 第一节：背景

这里写背景内容。

1. 1. 1. 第二节：经过

这里写经过内容。

1. 1. 1. 第三节：结果

这里写结果内容。

```

折叠区块内的标题会自动成为可点击项目。请注意，折叠区块不应滥用。若正文信息本身就是页面主干，应直接展示；只有在内容较长、可选阅读或会打断主线时，才建议折叠。

1. 普通引用与代码块

普通引用可使用 Markdown 引用语法：

```markdown > 这是一段普通引用。 ```

代码、规则文本、路径示例或语法示例应使用代码块，避免被系统解析：

````markdown ```markdown 【【草稿|署名|说明】】 模板:术语 ``` ````

若需要展示 HTML 示例，也应放入代码块，而不是直接写入正文，以免被页面渲染。

1. 表格

表格适合整理规则数据、人物信息、政权属性、时间线或标签示例。

示例：

```markdown | 项目 | 内容 | |---|---| | 所属世界 | 弥恩诸世 | | 条目类型 | 政权 | | 当前状态 | 草稿 | ```

表格应保持简洁。若一个表格需要横向滚动或包含大量段落，应考虑拆分为多个小表格，或改写为正文段落。

1. 资产管理

图片、地图、图标等资产应优先上传至本维基，尽量避免直接引用外部链接。外部图片可能因网络波动、权限变化、防盗链或原站删除而失效，不适合作为长期资料库的稳定资源。

专属于单个页面的资产，建议存放于与该页面同路径的资产文件夹内。例如：

```markdown 页面：/弥恩诸世/人物汇总/某人 图片：/弥恩诸世/人物汇总/某人/portrait.png ```

多页面共用的公共资产，应上传至统一的资产目录，并按类型建立子目录。例如：

```markdown /asset/symbols/logo.png /asset/maps/mien-world-map.png /asset/icons/status-anchor.png ```

资产文件名应尽量使用英文小写字母、数字和连字符。不要使用空格、特殊符号或含义不明的随机文件名。

推荐命名：

```markdown mien-world-map.png north-desert-border.png aleseya-symbol.png ```

不推荐命名：

```markdown 新建图片.png 地图最终版！！.png QQ截图20260424.png ```

上传后请尽量不要随意重命名位于资产文件夹内的文件。若确需重命名，应同步检查所有引用该资产的页面，避免图片失效。

1. 分类与标签

页面路径承担“分类”功能，标签承担“横向关联”功能。二者不应混淆。

• • 分类** 由页面路径决定，主要用于内容归档和层级导航。例如：

```markdown /弥恩诸世/人物汇总/人物名 /弥恩诸世/政权组织/组织/组织名 ```

• • 标签** 是对页面内容的关键词描述，主要用于跨分类检索、主题聚合与关联发现。一个页面可以拥有多个标签，但不宜过多。

标签应遵循具体、通用、稳定的原则。不要使用过于主观或只适用于单页的标签。编辑前可先浏览已有页面标签，尽量复用既有标签，避免创建含义相同但写法不同的新标签。

1. 1. 标签类别建议

内容类型标签用于标记页面的基础性质。大多数页面都应至少拥有一个内容类型标签，例如：

```markdown 概念 人物 地点 组织 事件 物品 生物 规则 跑团记录 ```

主题领域标签用于标记页面涉及的主要内容方向，例如：

```markdown 政治 宗教 历史 科技 经济 文化 军事 魔法 地理 ```

世界观关联标签用于标记页面与特定世界要素的联系，例如：

```markdown 灾厄 弥恩诸世 南部 北部 摄理政府 圣庭 魔网 ```

每个页面的标签建议控制在 3 至 8 个之间。标签应与页面主旨高度相关，不应因为某个概念在页面中被顺带提及，就为其添加标签。

1. 版本与署名

页面历史会记录编辑行为，但重要页面仍建议在正文末尾或页面讨论中说明主要贡献者、整理者与资料来源。多人协作页面尤其应保留贡献记录，以便后续修订时追溯文本来源。

推荐写法：

```markdown

1. 1. 编辑记录

- 2026-04-24：XXX 创建页面初稿。 - 2026-04-25：YYY 补充历史部分。 - 2026-04-26：ZZZ 根据互评意见修订。 ```

若页面内容来自跑团记录，应注明战役名称与整理者：

```markdown 本页面部分内容整理自《战役名》跑团记录，由 XXX 整理。 ```

若页面大量使用 AI 辅助整理，也建议注明：

```markdown 本文初稿曾使用 AI 辅助整理，并由 XXX 完成人工校订。 ```

1. 编辑检查清单

发布页面前，请至少确认以下事项：

• 页面路径是否符合分类规范；
• 页面标题是否使用正式名称；
• 页面是否符合所属世界基调；
• 页面状态是否需要模板标记；
• 是否存在未经讨论的重大设定变更；
• 是否添加了必要的内部链接；
• 是否避免了过度链接和过多标签；
• 图片与资产是否使用稳定路径；
• 若涉及跑团内容，是否标明剧透或非正史状态；
• 若涉及他人创作，是否获得许可或注明来源。

1. 补充

本指南旨在维护维基文本的结构性与一致性，并不试图限制合理的创作表达。若您认为现有格式无法满足某类页面的需要，可以提出补充建议。涉及页面结构、模板语法、全站 CSS 或脚本功能的修改，应先在项目协作群中讨论，再由管理者统一调整。

```

contentReference[oaicite:2]{index=2}

```

[1]: https://docs.requarks.io/en/editors/markdown?utm_source=chatgpt.com "Markdown - Wiki.js - requarks.io"