查看“︁编辑指南”︁的源代码

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

<blockquote class="custom-blockquote-warning">
  若您意图于本维基添加、修改、搬运、扩写或重构任何内容，请务必阅读并遵守本指南所述内容。
</blockquote>

# 说明

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

本指南只处理 **页面编辑与格式问题**。若您计划新增设定、修改既有设定、参与互评、处理争议或推进时间线，请同时阅读[**共创指南**](/共创指南)。

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

# 开始编辑

### 了解维基

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

### 操作方式

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

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

编辑完成后点击保存即可。页面历史版本会保留在系统中。

# 基础语法

### Markdown

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

您可在 Markdown 编辑器左下角点击问号图标查看快捷参考，也可参阅[**Wiki.js 官方 Markdown 指南**](https://docs.requarks.io/editors/markdown)。

### HTML

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

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

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

# 页面命名与路径

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

例如：

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

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

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

# 页面结构

同一子分类下的页面应遵循统一的基础结构，以确保信息完整、风格一致。若某个页面被标记为**模板参考**，编辑同类页面时应优先参照该页面。

页面正文不必在开头重复当前页面标题，因为页面标题已经显示于页面上方。页面内进行层级标记时，由于索引表会索引一级和二级标题，建议在一级标题下续接三级标题，以免层级索引过重。

# 行文规范

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

基本规范如下：

* 中文、英文、数字与单位之间应空一格，如 `DND 3.5E`、`221 纪年`、`10 gp`、`DC 20`。
* 段落之间应空一行，以形成清晰间距。
* 已确定的专有名词应保持一致，不要随意创造同义写法。
* 概念首次出现时可添加内链；同一页面内反复出现的同一概念，不必每次都链接。
* 编辑意图可用 HTML 注释说明，如 `<!-- 此处等待东部地区设定补充后再修订 -->`。

# 内部链接

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

推荐写法：

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

不推荐写法：`[点击这里](/弥恩诸世/世界总览)`。

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

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

# 页面状态模板

页面状态模板用于提醒读者和编辑者：该页面目前是否稳定、是否可引用、是否需要讨论或修订。状态模板通常用于标记具体分类下的**子页面**，而不要在导航页或总览页等会受到频繁访问的页面使用。

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


基本格式：

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

例如：`【【草稿|罗莎|今天吃了草莓芭菲】】`

### 共创流程模板

* **提案**
【【提案】】

* **草稿**
【【草稿】】

* **待互评**
【【待互评】】

* **修订中**
【【修订中|罗莎】】

* **确认中**
【【确认中】】

* **已锚定**
【【已锚定|编录组】】

### 维护与性质模板

* **需要改进**
【【需要改进|罗莎|快来个人帮我写点东西吧】】

* **占位**
【【占位|罗莎】】

* **模板参考**
【【模板参考】】

* **精选**
【【精选】】

* **消歧义**
【【消歧义】】`

* **剧透警告**
【【剧透警告】】

* **非正史**
【【非正史】】

* **跑团记录**
【【跑团记录】】

* **废案归档**
【【废案归档】】

*  **DND3.5E**
【【DND3.5E】】

*  **DND5R**
【【DND5R】】

*  **通用规则**
【【通用规则】】

# 术语提示

术语提示用于在不打断正文阅读的情况下解释概念。它适合用于世界观专有名词、规则术语、组织简称或读者可能不熟悉的概念。术语只会索引页面的标题文本，请确保引用了正确的标题。

* 本页内术语：`{{术语名}}`
* 跨页面术语：`{{术语名|/页面路径}}`
* 示例：`弥恩的奥术体系依赖 {{魔网|/弥恩诸世/世界总览/概念/魔网}} 运行。`

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

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

# 特殊引用框

为契合当前的页面主题风格，建议使用优化后的引用框。

* 标准引用：
```
<blockquote class="custom-blockquote-default">
内容
</blockquote>
```
* 提示引用：
```
<blockquote class="custom-blockquote-tip">
内容
</blockquote>
```
* 注意引用：
```
<blockquote class="custom-warning">
内容
</blockquote>
```

# 引用块

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

* 基本引用：`{{Quote|引用内容|来源}}`
  示例：{{Quote|这是一段引用文本。|《引用源》}}

* 带补充说明：`{{Quote|引用内容|来源|补充说明}}`
  示例：`{{Quote|这是一段引用文本。|《引用源》|引用说明}}`

* 带样式参数：`{{Quote|引用内容|来源|补充说明|style= ;}}`
  示例：`{{Quote|这是一段引用文本。|引用源|引用说明|style=color:#8a5a00;}}`

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

# 剧透与隐藏文字

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

* 语法：`普通文本之后是 ((这是一段隐藏内容))。`
* 示例：((这是一段隐藏文本))

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

# 折叠区块

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

基本格式：

```html
<div class="faccordion">
  
  ### 第一章
  
  ### 第二章

</div>
```

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

# 资产管理

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

专属于单个页面的资产，建议存放于与该页面同路径的资产文件夹内。例如：页面 `/弥恩诸世/人物汇总/某人` 的肖像可存为 `/弥恩诸世/人物汇总/某人/portrait.png`。

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

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

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

推荐命名：

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

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

# 分类与标签

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

**分类** 由页面路径决定，主要用于内容归档和层级导航，例如 `/弥恩诸世/人物汇总/人物名` 或 `/弥恩诸世/政权组织/组织/组织名`。

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

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

常用标签类型：

* 内容类型：`概念`、`人物`、`地点`、`组织`、`事件`、`物品`、`生物`、`规则`、`跑团记录`
* 主题领域：`政治`、`宗教`、`历史`、`科技`、`经济`、`文化`、`军事`、`魔法`、`地理`
* 世界观关联：`灾厄`、`弥恩诸世`、`南部`、`北部`、`摄理政府`、`圣庭`、`魔网`

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

# 版本与署名

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

* 普通编辑记录：`2026-04-24：罗莎 创建页面初稿。`
* 跑团来源说明：`本页面部分内容整理自《漠北远征》跑团记录。`

# 编辑检查清单

发布页面前，请至少确认：

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

# 补充

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

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