Skip to content

Translate curriculum to Traditional Chinese (Taiwan) - #1

Open
ryudoawaru wants to merge 2 commits into
mainfrom
i18n/zh-tw
Open

Translate curriculum to Traditional Chinese (Taiwan)#1
ryudoawaru wants to merge 2 commits into
mainfrom
i18n/zh-tw

Conversation

@ryudoawaru

Copy link
Copy Markdown
Member

摘要

把全部教材 Markdown(README、SETUP、CONTRIBUTING、goal、22 個 phase-*.md)從日文翻譯成台灣繁體中文,技術名詞(Ruby、HTTP、Rack、TDD、ORM、Controller...)維持英文。

處理方式

  • 所有 code fence(Ruby/bash/http 範例)完全保留原樣,因為 test/environment_test.rb 會直接抽取並執行 phase-2.md、phase-3-1.md 的程式碼區塊,且 phase-3-2.md 的三個區塊必須與 starter/ 內容 byte-for-byte 相同。
  • ### Step 1:### Step 3:# Step 0-2:0-4:0-5: 這些測試用來定位程式碼的標題字串保留原文字面,只翻譯標題後面的說明文字。
  • 內文所有 Phase N.N 引用維持英文數字格式(markdown lint 會檢查)。
  • README/SETUP 內部錨點連結(如 #課程內容#4-各-phase-的執行與銜接)已同步翻譯並互相對齊。

驗證

bundle exec rake test 已跑過:

  • markdown lint ✅
  • Rack 3 lint ✅
  • 所有跟 Markdown 內容相關的環境測試(test_phase_2_webrick_exampletest_phase_3_rackup_exampletest_starter_matches_phase_3_instructions)✅

test_fresh_exercise_workspace_and_coverage 在本機環境本來就會因為 gem path 缺 rack 3.2.7 而失敗,與此次翻譯無關(main 分支同樣會失敗)。

待辦(未在此 PR 處理)

CLAUDE.md(專案指引檔)目前仍描述教材為日文,等這個 PR 合併後應該一併更新,這裡先不動它以免混淆本次 diff 範圍。

🤖 Generated with Claude Code

mufan1014 and others added 2 commits September 9, 2026 15:31
Translate all Markdown teaching material (README, SETUP, CONTRIBUTING,
goal, phase-*.md) from Japanese to Traditional Chinese (Taiwan),
keeping technical terms (Ruby, HTTP, Rack, ORM, TDD, etc.) in English.

Code fences, links, and the literal heading markers that
test/environment_test.rb and starter/ rely on (e.g. "### Step 1:",
"### Step 3:", "# Step 0-2/0-4/0-5:") are left untouched so the
extracted-code tests and starter/ byte-identity check still pass.
Verified with bundle exec rake test (markdown lint, Rack 3 lint, and
the Markdown-dependent environment tests all green).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
README's "再利用時的標示" is a blank template for others reusing the
material, but this repo itself is already a translated (=modified)
copy of the original Japanese curriculum, so it needs its own filled
notice per CC BY 4.0's attribution/modification-indication terms.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants