# 贡献指南 · Contributing

感谢你关注《颂钵疗愈师培训 7.0（大字版）》开源教材！本仓库以 **CC BY-NC-SA 4.0**（署名—非商业性使用—相同方式共享）协议发布，欢迎以各种方式参与共建。

> Thanks for your interest in this open-source singing-bowl healing textbook. The project is released under **CC BY-NC-SA 4.0**. Contributions of all kinds are welcome.

---

## 一、你可以如何贡献

| 方式 | 说明 |
|:-----|:-----|
| **提交 Issue** | 发现错别字、事实错误、排版问题，或希望补充内容，请直接开 Issue，并标明章节 / 行号。 |
| **提交 Pull Request** | Fork 本仓库，修改后发起 PR。建议一个 PR 只做一类改动（如“修正第二章排版”）。 |
| **翻译共建** | 参与英文版（见 `TRANSLATION.md`）或其他语言版本的翻译。 |
| **分享传播** | 在非商业场景下转发、教学、二次创作（须署名并以相同协议共享）。 |

---

## 二、内容规范

1. **保持章节结构**：教材按“初识 → 理论 → 实践 → 智慧 → 自然疗法”五阶推进。新增内容请归入对应章节，遵循已有的 `第一章 / 第一节 / 一、` 层级。
2. **Markdown 约定**
   - 标题使用 `#`–`####` 层级，避免跳级。
   - 图片统一放在 `docs/media/` 目录，正文用 `![说明](media/xxx.png)` 引用，并尽量补全 `说明`（替代文本）。
   - 表格使用 GitHub 风格（`| 列 | 列 |` + 分隔行 `| --- | --- |`），**每行单元格数需一致**。
3. **中英文间距**：中文与拉丁字母 / 数字之间保留一个半角空格，例如 `颂钵 Sound Healing`、`CC BY-NC-SA 4.0 协议`。
4. **目录锚点**：若新增 / 重命名标题，请同步更新文件顶部“目录”以及落地页（`index.html`）的导航。锚点规则：小写、去除标点（含全角括号）、空格转连字符。
5. **署名与协议**：二次创作须保留原作者“润泽（五感六觉）”署名，并以 **CC BY-NC-SA 4.0** 相同协议发布；**不得用于商业用途**。

---

## 三、目录结构

```
singing-bowl-healer-training/
├── docs/
│   ├── 颂钵疗愈师培训7.0.md     # 教材正文（主文件）
│   └── media/                   # 全书配图（250+ 张）
├── en/                          # 英文版（建设中，见 TRANSLATION.md）
├── assets/                      # 社交预览图、微信二维码
├── index.html                   # GitHub Pages 落地页（含目录导航 / 搜索 / 暗色模式）
├── README.md                    # 仓库说明
├── CONTRIBUTING.md              # 本文件
├── TRANSLATION.md               # 翻译贡献指南
└── LICENSE                      # CC BY-NC-SA 4.0
```

---

## 四、提交前自检

- [ ] 文档可正常渲染（无破损表格、无残留 `<img>`/`<table>` 原始标签）
- [ ] 中英文之间已加空格
- [ ] 新增标题已加入顶部“目录”与 `index.html` 导航
- [ ] 图片已放入 `docs/media/` 且路径正确
- [ ] 未提交任何密钥 / 个人隐私信息（参见 `SECURITY.md`）

---

## 五、行为准则

请友善、耐心地交流。疗愈是关乎人身心的事，讨论时请保持专业与尊重；涉及健康的内容务必标注“不构成医疗建议”。

再次感谢你的参与 🌀