共建指南
共建指南
欢迎参与神经多样性 Wiki 共建。无需安装任何软件,可全程在浏览器完成。
目录
谁需要读这份指南
- 内容共建者:新建或编辑 wiki 页面
- 审校者:修正错误、补充信息、改进表述
- 繁体协作者:请前往 ndwiki-hant 阅读 COLLABORATING.md
不需要编程背景。你只需要熟悉 Markdown 基本语法。
修改已有页面
- 打开 wiki 仓库文件列表
- 找到你要修改的
.md文件,点进去 - 点右上角笔形图标(Edit this file)
- 在网页编辑器里修改内容
- 改完后点 Commit changes → 选择 "Create a new branch" → 点 Propose changes
- 等待维护者审核合并
新建页面
- 打开 wiki 仓库文件列表
- 进入对应文件夹:
01-基础/→ 范式、术语、运动02-批判分析/→ 政治经济学、意识形态03-历史脉络/→ 历史脉络04-体验与实践/→ 研究、教育、干预05-诊断与现象/→ ASD、ADHD、述情障碍等06-测试/→ 量表与工具authors/→ 作者works/→ 参考文献
- 点 Add file → Create new file
- 复制 TEMPLATE.md 作为起点,填入内容
- 点 Commit changes → 选择 "Create a new branch" → 点 Propose changes
页面规范
术语约定:写作和翻译时可查阅术语翻译对照表,统一使用"本wiki译名"列的中文术语(如"神经殊异"而非"神经发散"、"孤独谱系"而非"自闭症")。术语表中列出的"其他常见中文译名"和"同义英文术语"可添加到页面
aliases字段以便检索。
必需 Frontmatter
每个页面开头必须包含 YAML frontmatter:
---
title: 页面标题
description: 完整句子描述页面内容——含主语,供搜索结果和HTML meta使用
aliases: [英文/缩写, 中文别名, ...] ← 首个别名应为英文或缩写(决定部署 URL 路径)
tags: [类型标签, 领域标签]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
命名规则
| 页面类型 | 格式 | 示例 |
|---|---|---|
| 概念页 | 中文,无分隔符 | 神经多样性教育.md |
| 作者页 | FirstName-LastName.md(连字符分隔) | Robert-Chapman.md |
| 著作页 | AuthorYear.md | Chapman2023.md |
| 测试页 | 缩写(连字符分隔) | AQ-Child.md、RAADS-R.md |
- 文件名避免特殊符号
# ? / \ : * " < > | - 英文概念保留英文原名,中文译名放入
aliases
Wikilinks
使用 Obsidian wikilink 格式链接到其他 wiki 页面:
[[页面名]] → 链接到另一个 wiki 页面
[[页面名显示文字]] → 链接到页面,但显示不同文字
[[页面名#章节]] → 链接到页面的特定章节
优先链接已有页面。链接到尚不存在的页面会自动创建"待写页面",方便后续补充。
著作页额外要求
所有 works/ 目录下的页面必须包含:
- Frontmatter
citation_apa字段:
citation_apa: "Author, A. A. (Year). Title. Journal, Volume(Issue), Pages. https://doi.org/xx"
- 正文引用行:标题下方紧跟
引用:行,方便读者复制:
# 标题
引用:Author, A. A. (Year). Title. Journal, Volume(Issue), Pages. https://doi.org/xx
标签
| 类型标签 | 说明 |
|---|---|
concept | 概念与批判分析 |
author | 作者页 |
work | 著作页 |
test | 测试/量表 |
| 领域标签 | 说明 |
|---|---|
neurodiversity | 神经多样性 |
autism | 孤独谱系 |
adhd | ADHD |
disability | 残障 |
capitalism | 资本主义批判 |
education | 教育 |
完整标签体系见主仓库 wiki-schema.md。
Markdown 速查
# 一级标题(页面标题)
## 二级标题
### 三级标题
**加粗文字**
*斜体文字*
- 无序列表
- 无序列表 2
1. 有序列表
2. 有序列表 2
> 引用文字
| 表格 | 列2 |
|-----|-----|
| 内容 | 内容 |
[[页面名]] → 链接到另一个 Wiki 页面
[[页面名显示文字]] → 链接到页面,但显示不同文字
注意事项
- 文件名:不要用特殊符号
# ? / \ : * " < > | - 内部链接:用
[[页面标题]],不要用[页面标题](url) - 描述字段:一句话概括页面内容,会显示在搜索结果和页面列表中
- 不确定放哪个文件夹?放根目录就行,维护者会帮你归类
- 一个页面聚焦一个主题,主题过大的页面应拆分为多个子页面
- 优先概括和总结,不要直接复制大段原文
署名
如果你新建或大幅编辑了某个页面,欢迎在页面底部署名,可链接到你的个人网站、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,维护者会反馈。
Q: 可以用英文写页面吗?
A: 本 Wiki 以中文为主。英文概念和术语可在正文中保留原文,但页面正文应为中文。
Q: 我想共建繁体中文页面?
A: 繁体内容请提交至 ndwiki-hant 仓库,而非本仓库。详见 COLLABORATING.md。
Q: 没有 Git 经验可以参与吗?
A: 可以!GitHub 网页版支持直接在浏览器中编辑文件。按照上述步骤操作即可,全程不需要命令行。