Skip to content

Commit 2d0c603

Browse files
shumingyang-opencodeshumingyang-opencode
committed
Deepen all 8 GitHub units: branches, PR, Issues, Pages, Actions, open source + glossary
1 parent 0d1bdb7 commit 2d0c603

14 files changed

Lines changed: 1039 additions & 1158 deletions

‎about.html‎

Lines changed: 16 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -3,92 +3,57 @@
33
<head>
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
6-
<title>關於本站 · GitHub 繁中教學站</title>
7-
<meta name="description" content="關於本站的緣起、授權與建置方式。">
6+
<title>關於本站 · GitHub 繁體中文教學站</title>
7+
<meta name="description" content="GitHub 教學站關於頁">
88
<link rel="icon" type="image/svg+xml" href="assets/favicon.svg">
99
<link rel="stylesheet" href="assets/site.css">
1010
</head>
1111
<body>
1212
<div class="container">
13-
1413
<header>
1514
<h1>關於本站</h1>
1615
<p class="subtitle">緣起、授權與建置方式</p>
1716
</header>
18-
1917
<nav class="topnav">
2018
<a href="index.html">首頁</a>
2119
<a href="map.html">概念地圖</a>
2220
<a href="learning-path.html">學習路線</a>
2321
<a href="docs/index.html">單元教學</a>
22+
<a href="glossary.html">術語表</a>
2423
<a href="about.html">關於</a>
25-
</nav>
26-
27-
<div class="back-link"><a href="index.html">← 回首頁</a></div>
28-
24+
</nav><div class="back-link"><a href="index.html">← 回首頁</a></div>
2925
<div class="guide">
3026
<h2>這個網站是什麼</h2>
31-
<p>
32-
一份把 <strong>GitHub 平台</strong>從帳號、第一個 repo，教到開源貢獻的繁體中文教學網站。
33-
目標讀者是<strong>初階工程師與學生</strong>——你聽過 GitHub，甚至逛過別人的 repo，
34-
但想系統性地學會使用它完成真實工作。
35-
</p>
36-
<p>
37-
本站採用<strong>中英對照</strong>：中文解說為主，技術名詞與指令保留英文，
38-
讓你同時學會「怎麼做」與「怎麼說」。
39-
</p>
40-
27+
<p>一份把 <strong>GitHub 平台</strong>從帳號、第一個 repo，到開源貢獻做成<strong>中英對照深度教學</strong>的繁體中文網站。目標讀者是<strong>初階工程師與學生</strong>——你聽過 GitHub，甚至逛過別人的 repo，但想系統性地學會使用它完成真實工作。</p>
28+
<p>每個單元都採用「<strong>定義/原理 → 教學步驟 → Worked Example → 常見錯誤 → 練習</strong>」的深度結構，並附「看完這單元你應該能說出」的驗收清單。</p>
4129
<h2>為什麼要學 GitHub</h2>
4230
<ul>
4331
<li>現代開發的事實標準——工作、開源、作品集都在這。</li>
4432
<li>整合版本控制、協作、自動化與部署於一體。</li>
4533
<li>會 GitHub = 能參與全球任何開源專案。</li>
4634
</ul>
47-
4835
<h2>本站建置</h2>
4936
<ul class="timeline">
50-
<li>決定主題與課程大綱（8 單元、中英對照、從使用到開源）</li>
37+
<li>規劃 8 單元深度課程（認識 → 上手 → 協作 → 自動化 → 開源）</li>
5138
<li>承襲既有教學站的深色 × 霓虹設計語言與架構慣例</li>
52-
<li>建立首頁、概念地圖、學習路線與單元教學架構</li>
53-
<li>逐單元撰寫內容，持續擴充與修正</li>
39+
<li>每個單元設計「定義/原理 + 步驟 + Worked Example + 練習 + 看完應能說出」結構</li>
40+
<li>新增術語表速查頁</li>
5441
</ul>
55-
5642
<h2>本站本身就是 GitHub 的產物</h2>
57-
<p>
58-
你正在看的這站，以及 Markdown / YAML / JSON 教學站，都是由 OpenCode 撰寫、
59-
用 <code>git</code> 版本管理、推送到 GitHub，再透過 <strong>GitHub Pages</strong> 免費部署上線。
60-
學完<a href="docs/unit-06-github-pages.html">單元 6</a>，你也能做到。
61-
</p>
62-
43+
<p>你正在看的這站，以及 Markdown / YAML / JSON 教學站，都是由 OpenCode 撰寫、用 <code>git</code> 版本管理、推送到 GitHub，再透過 <strong>GitHub Pages</strong> 免費部署上線。學完<a href="docs/unit-06-github-pages.html">單元 6</a>，你也能做到。</p>
6344
<h2>授權</h2>
64-
<div class="license-box">
65-
<strong>本站教學內容</strong>（繁體中文解說）為本站原創，以
66-
<strong>CC-BY-4.0</strong> 授權釋出——歡迎引用、改作、分享，惟需標示來源。
67-
<br><br>
68-
文中技術名詞與操作引用自
69-
<a href="https://docs.github.com/" rel="noopener">GitHub Docs</a>
70-
與 <a href="https://git-scm.com/doc" rel="noopener">Git 官方文件</a>。
71-
</div>
72-
45+
<div class="license-box"><strong>本站教學內容</strong>（繁體中文解說）為本站原創，以 <strong>CC-BY-4.0</strong> 授權釋出。文中技術名詞與操作引用自 <a href="https://docs.github.com/" rel="noopener">GitHub Docs</a> 與 <a href="https://git-scm.com/doc" rel="noopener">Git 官方文件</a>。</div>
7346
<h2>技術資訊</h2>
7447
<div class="file-tree">github-tech-zh-tw/
7548
├── index.html <span class="f">課程總覽</span>
7649
├── map.html <span class="f">概念地圖</span>
7750
├── learning-path.html <span class="f">學習路線</span>
7851
├── about.html <span class="f">關於本站</span>
79-
├── docs/ <span class="dir">單元教學</span>
80-
│ ├── index.html <span class="f">單元一覽</span>
81-
│ └── unit-01…08 <span class="f">8 篇教學頁</span>
52+
├── glossary.html <span class="f">📖 術語表</span>
53+
├── docs/ <span class="dir">8 深度單元</span>
8254
├── assets/site.css <span class="f">單一共享樣式</span>
8355
└── .nojekyll <span class="f">GitHub Pages 直出</span></div>
8456
<p class="hint">本站為純靜態 HTML，無建置步驟，直接部署於 GitHub Pages。</p>
85-
</div>
86-
87-
<footer>
88-
這是 GitHub 繁體中文教學站 · 由 OpenCode 建置<br>
89-
<span class="footer-license">本站教學內容（繁體中文解說）為本站原創，採 CC-BY-4.0；技術名詞與操作引用自 <a href="https://docs.github.com/" rel="noopener">GitHub Docs</a> 與 <a href="https://git-scm.com/doc" rel="noopener">Git 官方文件</a>。</span>
90-
</footer>
91-
92-
</div>
93-
</body>
94-
</html>
57+
</div><footer>這是 GitHub 繁體中文教學站 · 由 OpenCode 建置<br>
58+
<span class="footer-license">本站教學內容（繁體中文解說）為本站原創，採 CC-BY-4.0；技術名詞與操作引用自 <a href="https://docs.github.com/" rel="noopener">GitHub Docs</a>與 <a href="https://git-scm.com/doc" rel="noopener">Git 官方文件</a>。</span></footer>
59+
</div></body></html>

‎docs/index.html‎

Lines changed: 26 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -3,82 +3,67 @@
33
<head>
44
<meta charset="UTF-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
6-
<title>單元教學 · GitHub 繁中教學站</title>
7-
<meta name="description" content="GitHub 8 單元循序漸進教學目錄。">
6+
<title>單元教學 · GitHub 繁體中文教學站</title>
7+
<meta name="description" content="GitHub 8 單元教學目錄">
88
<link rel="icon" type="image/svg+xml" href="../assets/favicon.svg">
99
<link rel="stylesheet" href="../assets/site.css">
1010
</head>
1111
<body>
1212
<div class="container">
13-
1413
<header>
1514
<h1>單元教學</h1>
16-
<p class="subtitle">8 個單元，從認識 GitHub 到開源貢獻</p>
15+
<p class="subtitle">8 個深度單元，每單元含 Worked Example 與練習</p>
1716
</header>
18-
1917
<nav class="topnav">
2018
<a href="../index.html">首頁</a>
2119
<a href="../map.html">概念地圖</a>
2220
<a href="../learning-path.html">學習路線</a>
23-
<a href="index.html">單元教學</a>
21+
<a href="../docs/index.html">單元教學</a>
22+
<a href="../glossary.html">術語表</a>
2423
<a href="../about.html">關於</a>
25-
</nav>
26-
27-
<div class="back-link"><a href="../index.html">← 回首頁</a></div>
28-
24+
</nav><div class="back-link"><a href="../index.html">← 回首頁</a></div>
2925
<div class="card-grid">
3026
<a class="card lv-emerald" href="unit-01-github-intro.html">
3127
<div class="c-name">單元 1 · GitHub 是什麼</div>
32-
<div class="c-zh">Git vs GitHub、平台功能總覽、帳號與認證。What &amp; Why.</div>
33-
<div class="c-tags"><span class="c-tag">概念</span><span class="c-tag">L0</span></div>
28+
<div class="c-zh">Git vs GitHub、平台功能總覽、帳號與認證、社群價值</div>
29+
<div class="c-tags"><span class="c-tag">概念</span></div>
3430
</a>
35-
<a class="card lv-cyan" href="unit-02-first-repo.html">
31+
<a class="card lv-emerald" href="unit-02-first-repo.html">
3632
<div class="c-name">單元 2 · 第一個 Repo</div>
37-
<div class="c-zh">repo、clone、add/commit/push、README、.gitignore。</div>
38-
<div class="c-tags"><span class="c-tag">上手</span><span class="c-tag">L1</span></div>
33+
<div class="c-zh">建立 repo、clone、add/commit/push、README、.gitignore</div>
34+
<div class="c-tags"><span class="c-tag">上手</span></div>
3935
</a>
4036
<a class="card lv-amber" href="unit-03-branches-merge.html">
4137
<div class="c-name">單元 3 · 分支與合併</div>
42-
<div class="c-zh">branch、merge、pull、衝突處理。</div>
43-
<div class="c-tags"><span class="c-tag">協作</span><span class="c-tag">L2</span></div>
38+
<div class="c-zh">分支原理、branch/checkout、merge、pull、衝突處理</div>
39+
<div class="c-tags"><span class="c-tag">協作</span></div>
4440
</a>
4541
<a class="card lv-amber" href="unit-04-pull-request.html">
4642
<div class="c-name">單元 4 · Pull Request 協作</div>
47-
<div class="c-zh">PR 流程、code review、保護分支、關聯 issue。</div>
48-
<div class="c-tags"><span class="c-tag">協作</span><span class="c-tag">L2</span></div>
43+
<div class="c-zh">PR 流程、code review、squash·rebase·merge、保護分支</div>
44+
<div class="c-tags"><span class="c-tag">協作</span></div>
4945
</a>
5046
<a class="card lv-fuchsia" href="unit-05-issues-project.html">
5147
<div class="c-name">單元 5 · Issues 與專案管理</div>
52-
<div class="c-zh">Issues、labels、milestones、Projects、Wiki。</div>
53-
<div class="c-tags"><span class="c-tag">管理</span><span class="c-tag">L3</span></div>
48+
<div class="c-zh">Issue 寫法、template、labels、milestones、Projects、Discussion</div>
49+
<div class="c-tags"><span class="c-tag">管理</span></div>
5450
</a>
5551
<a class="card lv-fuchsia" href="unit-06-github-pages.html">
5652
<div class="c-name">單元 6 · GitHub Pages</div>
57-
<div class="c-zh">靜態網站部署——本站與前三個教學站就是活教材。</div>
58-
<div class="c-tags"><span class="c-tag">部署</span><span class="c-tag">L3</span></div>
53+
<div class="c-zh">個人站/專案站、三種啟用方式、自訂網域、限制</div>
54+
<div class="c-tags"><span class="c-tag">部署</span></div>
5955
</a>
6056
<a class="card lv-fuchsia" href="unit-07-github-actions.html">
6157
<div class="c-name">單元 7 · GitHub Actions</div>
62-
<div class="c-zh">CI/CD、workflow、secrets、常用 action。</div>
63-
<div class="c-tags"><span class="c-tag">自動化</span><span class="c-tag">L3</span></div>
58+
<div class="c-zh">workflow 結構、on 觸發、job/step、常用 action、Secrets、status checks</div>
59+
<div class="c-tags"><span class="c-tag">自動化</span></div>
6460
</a>
6561
<a class="card lv-violet" href="unit-08-open-source-best-practices.html">
6662
<div class="c-name">單元 8 · 開源協作與最佳實踐</div>
67-
<div class="c-zh">Fork、contribute、License、社群禮儀、gh CLI、安全。</div>
68-
<div class="c-tags"><span class="c-tag">開源</span><span class="c-tag">L4</span></div>
63+
<div class="c-zh">License、CONTRIBUTING、CODE_OF_CONDUCT、Release、Fork 貢獻、gh CLI、安全</div>
64+
<div class="c-tags"><span class="c-tag">開源</span></div>
6965
</a>
7066
</div>
71-
72-
<div class="callout info">
73-
<strong>建議路線：</strong>第一次學建議照 <a href="../learning-path.html">學習路線</a> 依序進行；
74-
只想快速發布網站的讀者可先跳<a href="unit-06-github-pages.html">單元 6</a>。
75-
</div>
76-
77-
<footer>
78-
這是 GitHub 繁體中文教學站 · 由 OpenCode 建置<br>
79-
<span class="footer-license">本站教學內容（繁體中文解說）為本站原創，採 CC-BY-4.0；技術名詞與操作引用自 <a href="https://docs.github.com/" rel="noopener">GitHub Docs</a> 與 <a href="https://git-scm.com/doc" rel="noopener">Git 官方文件</a>。</span>
80-
</footer>
81-
82-
</div>
83-
</body>
84-
</html>
67+
<div class="callout info"><strong>建議路線：</strong>第一次學照 <a href="../learning-path.html">學習路線</a> 依序；只想快速發布網站的讀者可先跳<a href="unit-06-github-pages.html">單元 6</a>。</div><footer>這是 GitHub 繁體中文教學站 · 由 OpenCode 建置<br>
68+
<span class="footer-license">本站教學內容（繁體中文解說）為本站原創，採 CC-BY-4.0；技術名詞與操作引用自 <a href="https://docs.github.com/" rel="noopener">GitHub Docs</a>與 <a href="https://git-scm.com/doc" rel="noopener">Git 官方文件</a>。</span></footer>
69+
</div></body></html>

0 commit comments

Comments
 (0)