共建指南

欢迎参与神经多样性 Wiki 共建。无需安装任何软件，可全程在浏览器完成。

#谁需要读这份指南

• 内容共建者：新建或编辑 wiki 页面
• 审校者：修正错误、补充信息、改进表述
• 繁体协作者：请前往 ndwiki-hant 阅读 COLLABORATING.md

不需要编程背景。你只需要熟悉 Markdown 基本语法。

#先判断贡献规模

本仓库是简体中文页面镜像，方便在浏览器中进行轻量协作；完整的来源归档、结构维护、日志、索引和简繁同步位于 ndwiki-cn 主仓库。

#可以直接在本仓库提交

• 错别字、措辞、格式和失效链接修正；
• 已有页面的局部补充或事实纠正；
• 来源已经在主仓库归档，并且不改变目录、标签和导航的单页修改或新增。

#请改向主仓库提交

• 一次新增或重构多个相互关联的页面；
• 批量新增文献页、作者页或研究资料；
• 建立完整专题，或改变目录、页面边界、导航和标签体系；
• 来源尚未进入主仓库 sources/；
• 涉及医疗安全、自伤、自杀等需要重点来源复核的内容；
• 会引起大规模繁体同步的改动。

页面数量不是唯一标准。只要需要批量来源归档、结构设计或跨仓库同步，就属于 LLM Wiki 的“专题级摄入”，需要在主仓库中让原始资料、知识页面、schema、知识地图、wiki-log.md 和 llm-wiki sync 保持一致。

#已经在本仓库提交了大型 PR

不需要重写或立即关闭 PR。请保留现有 PR，再基于已有内容向 ndwiki-cn 建立 PR，或先向维护者提供来源文件和来源清单。两个 PR 可以相互链接；主仓库版本完成后，当前 PR 再标记为由主仓库 PR 取代。

#修改已有页面

1. 打开 wiki 仓库文件列表
2. 找到你要修改的 .md 文件，点进去
3. 点右上角笔形图标（Edit this file）
4. 在网页编辑器里修改内容
5. 改完后点 Commit changes → 选择 "Create a new branch" → 点 Propose changes
6. 等待维护者审核合并

#新建页面

下面的步骤只适用于来源已经在主仓库归档、结构边界清晰的单页新增。完整专题、批量页面或需要新来源的页面，请向 ndwiki-cn 提交。

1. 打开 wiki 仓库文件列表
2. 进入对应文件夹：
3. 01-基础/ → 范式、术语、运动
4. 02-批判分析/ → 政治经济学、意识形态
5. 03-历史脉络/ → 历史脉络
6. 04-实践应用/ → 研究、教育、干预
7. 05-诊断与现象/ → ASD、ADHD、述情障碍等
8. 06-测试/ → 量表与工具
9. authors/ → 作者
10. works/ → 参考文献
11. 点 Add file → Create new file
12. 复制 TEMPLATE.md 作为起点，填入内容
13. 点 Commit changes → 选择 "Create a new branch" → 点 Propose changes

#页面规范

术语约定：写作和翻译时可查阅术语翻译对照表，尽可能统一使用"本wiki译名"列的中文术语（如"神经殊异"而非"神经发散"、"孤独谱系"而非"自闭症"）。术语表中列出的"其他常见中文译名"和"同义英文术语"可添加到页面 aliases 字段以便检索。

#必需 Frontmatter

每个页面开头必须包含 YAML frontmatter：

---
title: 页面标题
description: 完整句子描述页面内容——含主语，供搜索结果和HTML meta使用
aliases:

  - 英文/缩写
  - 中文别名
tags:

  - 类型标签
  - 领域标签
sources:

  - YYYY-MM-DD/源文件名
created: YYYY-MM-DD
updated: YYYY-MM-DD
---

aliases、tags 和 sources 使用块状列表。sources 必须指向 ndwiki-cn 中实际归档的原始资料；如果需要新增来源，请从主仓库提交。

#命名规则

• 文件名避免特殊符号 # ? / \ : * " < > |
• 英文概念保留英文原名，中文译名放入 aliases

#Wikilinks

使用 Obsidian wikilink 格式链接到其他 wiki 页面：

[[页面名]]              → 链接到另一个 wiki 页面
[[页面名|显示文字]]     → 链接到页面，但显示不同文字
[[页面名#章节]]         → 链接到页面的特定章节

优先链接已有页面。链接到尚不存在的页面会自动创建"待写页面"，方便后续补充。

#著作页额外要求

所有 works/ 目录下的页面必须包含：

1. Frontmatter citation_apa 字段：

citation_apa: "Author, A. A. (Year). Title. Journal, Volume(Issue), Pages. https://doi.org/xx"

1. 正文引用行：标题下方紧跟 引用： 行，方便读者复制：

# 标题

引用：Author, A. A. (Year). Title. Journal, Volume(Issue), Pages. https://doi.org/xx

#标签

完整标签体系见主仓库 wiki-schema.md。

#Markdown 速查

# 一级标题（页面标题）
## 二级标题
### 三级标题

**加粗文字**
*斜体文字*

- 无序列表
- 无序列表 2

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

> 引用文字

| 表格 | 列2 |
|-----|-----|
| 内容 | 内容 |

[[页面名]]          → 链接到另一个 Wiki 页面
[[页面名|显示文字]]  → 链接到页面，但显示不同文字

#注意事项

• 文件名：不要用特殊符号 # ? / \ : * " < > |
• 内部链接：用 [[页面标题]]，不要用 [页面标题](url)
• 描述字段：一句话概括页面内容，会显示在搜索结果和页面列表中
• 不确定放哪个文件夹？可以先提交草稿 PR 或 Issue，请维护者协助判断
• 一个页面聚焦一个主题；如果需要拆分为多个相互关联页面，请改走主仓库的专题级摄入流程
• 优先概括和总结，不要直接复制大段原文

#署名

如果你新建或大幅编辑了某个页面，欢迎在页面底部署名，可链接到你的个人网站、GitHub 主页或社交媒体：

> 贡献者：[你的名字](https://your-website.com)

多人贡献时用顿号分隔：

> 贡献者：[张三](https://zhangsan.dev)、[李四](https://github.com/lisi)

署名行放在页面正文末尾、wikilinks 之前。此字段非强制——署名与否由贡献者自行决定。

#开源与自行部署

本 Wiki 及其全部内容以 CC BY-NC-SA 4.0 协议发布。你可以：

• 自行部署：fork 本仓库，用 Obsidian、Hugo、Quartz 或任何 Markdown 兼容工具发布你自己的版本
• 修改内容：修改、翻译、改编任何页面，衍生作品须以相同协议（CC BY-NC-SA）发布
• 非商业使用：用于教学、研究、个人学习、机构内部知识库等场景

要求：注明原始来源（链接回本仓库或 neuroxyz.cn/wiki），禁止商用。

#FAQ

#Q: 我不确定我的内容是否适合 Wiki？

A: 只要与神经多样性相关——概念解释、研究动态、人物介绍、文献摘要——都欢迎。不确定内容范围时可以先提交草稿 PR 或 Issue；不确定仓库时，少量页面修改可以先在这里讨论，多个页面或新来源请优先选择主仓库。

#Q: 为什么大型专题不能直接合并到这个仓库？

A: 本仓库只包含页面镜像。大型专题还需要归档原始来源、建立 sources 追溯、更新 schema 和知识地图、记录操作日志、运行索引同步并生成繁体版本；这些环节只能在完整的 ndwiki-cn 主仓库中统一完成。

#Q: 可以用英文写页面吗？

A: 本 Wiki 以中文为主。英文概念和术语可在正文中保留原文，但页面正文应为中文。

#Q: 我想共建繁体中文页面？

A: 繁体内容请提交至 ndwiki-hant 仓库，而非本仓库。详见 COLLABORATING.md。

#Q: 没有 Git 经验可以参与吗？

A: 可以！GitHub 网页版支持直接在浏览器中编辑文件。按照上述步骤操作即可，全程不需要命令行。