共建指南

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

目录

谁需要读这份指南

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

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

修改已有页面

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

新建页面

  1. 打开 wiki 仓库文件列表
  2. 进入对应文件夹:
    • 01-基础/ → 范式、术语、运动
    • 02-批判分析/ → 政治经济学、意识形态
    • 03-历史脉络/ → 历史脉络
    • 04-体验与实践/ → 研究、教育、干预
    • 05-诊断与现象/ → ASD、ADHD、述情障碍等
    • 06-测试/ → 量表与工具
    • authors/ → 作者
    • works/ → 参考文献
  3. Add fileCreate new file
  4. 复制 TEMPLATE.md 作为起点,填入内容
  5. 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.mdChapman2023.md
测试页缩写(连字符分隔)AQ-Child.mdRAADS-R.md
  • 文件名避免特殊符号 # ? / \ : * " < > |
  • 英文概念保留英文原名,中文译名放入 aliases

使用 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

标签

类型标签说明
concept概念与批判分析
author作者页
work著作页
test测试/量表
领域标签说明
neurodiversity神经多样性
autism孤独谱系
adhdADHD
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 网页版支持直接在浏览器中编辑文件。按照上述步骤操作即可,全程不需要命令行。

Built with LogoFlowershow