# ✍️ 献课指南 — 如何成为献课老师

> 不需要懂代码，跟着图文一步步来，十分钟就能完成第一次献课！

---

## 前提准备

你只需要：
- ✅ 一个 [Gitee](https://gitee.com) 账号（免费注册，2 分钟）
- ✅ 一份你想要分享的教案（Word、PDF、纯文本都可）

如果你还没有 Gitee 账号，请先访问 [gitee.com/signup](https://gitee.com/signup) 注册。

---

## 第一步：准备好你的教案

### 推荐格式：Markdown

智慧宫推荐使用 **Markdown** 格式编写教案，因为它：
- 纯文本，任何电脑都能打开
- 支持标题、列表、加粗、表格
- 可以直接在 Gitee 上在线编辑

**不会 Markdown？没关系！** 直接用记事本写纯文本也可以，园丁会帮你调整格式。

### 教案模板

```markdown
# [课题名称]

**学科**：数学 / 语文 / 英语 / 科学 / 其他
**年级**：小学三年级 / 初中一年级 / 高中二年级
**版本**：人教版 / 苏教版 / 北师大版 / 自编
**课时**：1 课时（45 分钟）
**献课老师**：[你的名字]
**共享协议**：CC BY-SA 4.0

---

## 教学目标

1. 知识与技能：……
2. 过程与方法：……
3. 情感态度价值观：……

## 教学重难点

- 重点：……
- 难点：……

## 教学过程

### 一、导入（5 分钟）
……

### 二、新授（25 分钟）
……

### 三、练习（10 分钟）
……

### 四、小结（5 分钟）
……

## 板书设计
……

## 教学反思
……

## 附件
- [课件 PPT 链接]
- [练习题 PDF 链接]
```

### 文件命名规范

```
学科_年级_课题名称.md

示例：
数学_三年级上_分数的初步认识.md
语文_五年级下_草船借箭.md
英语_初一_Unit3_My_School.md
```

---

## 第二步：借来一用（Fork 教案库）

1. 打开你想献课的学科教案库（如 [数学教案库](https://gitee.com/autumn-huayi/lessons-shuxue)）
2. 点击右上角的 **Fork** 按钮（我们称为“借来一用”）
3. 在弹出的页面中，点击 **Create fork**
4. 等待几秒钟，教案库就复制到你自己的 Gitee 名下了！

> 🎉 **现在你有了自己的教案库副本！** 接下来把你准备好的教案放进去。

---

## 第三步：放入你的教案

### 方法一：直接在网页上操作（推荐新手）

1. 在你 Fork 后的仓库中，进入 `lessons/` 目录（对应学科子目录）
2. 点击 **Add file** → **Create new file**
3. 在文件名输入框中，按规范命名，如 `数学_三年级上_分数的初步认识.md`
4. 在编辑器中粘贴你的教案内容
5. 点击 **Commit changes**（提交修改）

### 方法二：上传文件

1. 在你 Fork 后的仓库中，进入对应目录
2. 点击 **Add file** → **Upload files**
3. 拖拽你的 `.md` 文件（和附件）到上传区
4. 点击 **Commit changes**

---

## 第四步：献课（Pull Request）

1. 回到你 Fork 后的仓库主页
2. 你会看到一个提示：**"This branch is X commits ahead of HOW-education:main"**
3. 点击 **Contribute** → **Open pull request**
4. 填写献课说明：

```
标题：[献课] 数学_三年级上_分数的初步认识

描述：
- 学科：数学
- 年级：三年级上
- 版本：人教版
- 简要描述：这是一份关于分数初步认识的教学设计……
```

5. 点击 **Create pull request**

---

## 第五步：等待审核

- 园丁（管理员）会审核你的献课
- 如果需要修改，园丁会在研讨单中留言
- 审核通过后，你的教案会合并到主教案库中
- 🎉 **你的名字将永久出现在教案库的贡献列表中！**

---

## 常见问题

### ❓ 我不会用 Gitee，有没有更简单的方法？

目前 GitHhub 是最简单的方式。我们正在编写更详细的图文教程。  
你也可以把教案发给园丁，园丁帮你上传。

### ❓ 我的教案包含 PPT 课件，怎么上传？

PPT、PDF、图片等附件可以直接拖拽到 Gitee 的上传区。  
建议附件不要太大（单个文件 < 25MB）。

### ❓ 我可以修改别人的教案再献课吗？

当然可以！这正是开源的魅力。  
你借来一用（Fork）→ 修改优化 → 再献回来（Pull Request）。  
这叫做 **“请指正”** ，是社区最高级别的互动。

### ❓ 我的教案被用了，我怎么知道？

每个教案仓库都有 **传阅次数**（Traffic 统计），显示近 14 天被克隆/下载次数。  
你可以在仓库的 Insights → Traffic 中看到。

### ❓ 如果我的教案有错误，怎么修改？

直接在你的 Fork 仓库中修改文件，然后再次提交 Pull Request 即可。

---

## 联系我们

- 💬 [杏坛论坛](https://gitee.com/autumn-huayi/House-of-Wisdom/discussions) — 讨论教学心得
- 📋 [提交研讨单](https://gitee.com/autumn-huayi/House-of-Wisdom/issues) — 提问或报错

---

> 🍑 **每一次献课，都是一次点灯。**
