An open book on Git for two kinds of readers: people who have never used it, and computer science students who need to use it for real. It follows one small firmware project and one change inside it, from the first line you edit to a tagged release. Every step is shown twice, as a Git command and in Sourcetree, with GitHub as the hosting platform. Each chapter has commit graphs, term and know-how boxes, optional deep dives into how Git works inside, and a hands-on section that uses the practice project included in this repository.
| 章 | 繁體中文 | English | 日本語 | 한국어 |
|---|---|---|---|---|
| 0 | Git 全景 | The Big Picture | Git の全体像 | Git의 전체 그림 |
| 1 | 準備工具 | Setting Up Your Tools | ツールの準備 | 도구 준비 |
| 章 | 繁體中文 | English | 日本語 | 한국어 |
|---|---|---|---|---|
| 2 | 三個區域 | The Three Areas | 3 つの領域 | 세 가지 영역 |
| 3 | Commit 的真面目 | What a Commit Really Is | コミットの正体 | 커밋의 정체 |
| 4 | 分支 | Branches | ブランチ | 브랜치 |
| 5 | 合併與衝突 | Merging and Conflicts | マージとコンフリクト | 병합과 충돌 |
| 章 | 繁體中文 | English | 日本語 | 한국어 |
|---|---|---|---|---|
| 9 | 後悔藥 | Undoing Things | 取り消しとやり直し | 되돌리기 |
| 10 | 好習慣 | Good Habits | よい習慣 | 좋은 습관 |
| 繁體中文 | English | 日本語 | 한국어 | |
|---|---|---|---|---|
| A | 術語總表 | Glossary | 用語集 | 용어집 |
| B | 現場行話 | Team Jargon | 現場の言い回し | 현장 용어 |
| C | 指令與 Sourcetree 對照表 | Commands and Sourcetree | コマンドと Sourcetree の対応表 | 명령어와 Sourcetree 대응표 |
| D | 延伸閱讀 | Further Reading | 参考文献 | 참고 자료 |
| Path | What to read |
|---|---|
| 🌱 New to Git | The main text and hands-on sections in order; skip the deep dives |
| 🎓 Computer science students | The whole book in order, including the deep dives |
| 🚀 Start using Git today | Chapters 0, 1, 2, 4 and 6 |
| 👥 Getting ready to join a team | Chapters 6–8 and Appendix B |
| 🚑 Something went wrong | Chapter 9 and Appendix C |
To follow along from any chapter, clone this repository and run bash practice/setup.sh <chapter>. It creates a practice repository in the state that chapter starts from.
- Found a mistake? Open an issue with the "Erratum" template.
- Want to add content or figures? Read the contributing guide and the style guide.
- Want to translate the book into another language? Read the translation guide.
The original text is written in Traditional Chinese, and the other languages are translations of it. If this book helps you, please give it a ⭐ star so that more people can find it.
This book is based on public documentation and common practice. It is not affiliated with the Git project, GitHub or Sourcetree. Sourcetree and GitHub are used only as examples of a graphical client and a hosting platform. Their screens change between versions and operating systems, so the book uses simplified diagrams instead of screenshots.
The text and images are licensed under CC BY-NC-SA 4.0. You may share, adapt and translate them for non-commercial purposes, as long as you give credit and share your work under the same license.