{"id":13400962,"url":"https://github.com/jlord/git-it","last_synced_at":"2025-05-14T19:08:45.229Z","repository":{"id":12625970,"uuid":"15297233","full_name":"jlord/git-it","owner":"jlord","description":":computer: :mortar_board: Learn Git and GitHub. Try the new desktop version → ","archived":false,"fork":false,"pushed_at":"2022-03-08T12:43:37.000Z","size":2350,"stargazers_count":1988,"open_issues_count":23,"forks_count":515,"subscribers_count":207,"default_branch":"master","last_synced_at":"2025-05-14T19:08:43.407Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://github.com/jlord/git-it-electron","language":"HTML","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jlord.png","metadata":{"files":{"readme":"README-zhtw.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-18T23:50:01.000Z","updated_at":"2025-04-07T21:04:42.000Z","dependencies_parsed_at":"2022-08-07T07:00:28.459Z","dependency_job_id":null,"html_url":"https://github.com/jlord/git-it","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlord%2Fgit-it","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlord%2Fgit-it/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlord%2Fgit-it/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jlord%2Fgit-it/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jlord","download_url":"https://codeload.github.com/jlord/git-it/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254209859,"owners_count":22032897,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T19:00:57.367Z","updated_at":"2025-05-14T19:08:43.797Z","avatar_url":"https://github.com/jlord.png","language":"HTML","funding_links":[],"categories":["Infomation for people who are new to GitHub","HTML","others","Workshoppers"],"sub_categories":[],"readme":"# Git-it\n\n![ss](https://raw.githubusercontent.com/jlord/git-it/master/git-it-ss.png)\n\nGit-it 是一個帶領你學習 Git 和 GitHub 的 [workshopper](https://github.com/rvagg/workshopper) 程式。在終端機中執行，帶領使用者經過一個一個的關卡。[nodeschool.io](http://nodeschool.io) 有更多相關的資訊。\n\n---\n\n**開發者文件在請看 [CONTRIBUTING.md](https://github.com/jlord/git-it/blob/master/CONTRIBUTING.md)。**\n\n**將要在一個使用 Git-it 的活動當教練嗎？ 先用用看 Git-it，然後到 [TROUBLESHOOT.md](https://github.com/jlord/git-it/blob/master/TROUBLESHOOT.md) 可以看到一些學員們常會碰到的問題。**\n\n---\n\n## 哈囉！\n\n這個程式會在你的終端機（Mac）或提示指令字元（Windows）中執行。Git-it 中包含很多關卡，每一個關卡會一步步帶領你學習 Git 和 GitHub。這個程式用的是真正現實生活中在寫程式時會用到的「終端機指令」、「Git」、和「GitHub」，中間完全沒有「模擬器」，代表你過程中安裝的軟體、學到的指令、開啟的專案，都將會是立刻就可以使用的技術，而且讓你的[貢獻圖表](https://github.com/blog/1360-introducing-contributions)上真的有個小綠方塊！\n\n![contributions](https://raw.githubusercontent.com/jlord/git-it/master/ghcc.png)\n\n你可以到 [Git-it 的挑戰列表](http://jlord.github.io/git-it/index-zhtw.html)中看到全部的關卡以及說明。\n\n---\n\n#### 你將需要這些程式才能執行 Git-it:\n\n_這是一些程式開發的必需品，全部都是免費的，並且大部分是開源的軟體。_\n\n- **Git**，記錄下所有的修改！\n - 如果你用的是 **Windows，下載 [GitHub for Windows](http://windows.github.com)**，它裡頭就包含了 Git。你可以用 **Git Shell** 作為你的終端機。\n - 如果你用的是 **Mac，下載 [GitHub for Mac](http://mac.github.com)**，它裡頭就包含了 Git，另外你需要到 Preferences \u003e Advanced \u003e 點選 Install Command Line Tools 來安裝指令程式。\n- **Node.js** 是 Git-it 程式撰寫所使用的語言，所以必須要安裝了它才有辦法使用 Git-it。Node.js 是一個伺服端的 JavaScript 引擎（你的電腦就是一個伺服器！），而且它會默默的在背景執行，不需要特別啟動。你可以**[在這裡下載 Node](http://nodejs.org/download/)**（直接選擇 **Windows `.msi`** 或是 **Mac `.pkg`** 的選項）。\n - 如果你本來就有安裝 Node 和 npm，記得要把 npm 更新到 v1.4.3 以上的版本。\n- **文字編輯器** 如果你還沒有這樣的程式，最好安裝一個特別用來寫程式的文字編輯器。這邊提供大家一些選項：[Atom](http://www.atom.io)、[Sublime Text 2](http://www.sublimetext.com/2)、[Textmate](http://macromates.com/download)、[Brackets](http://brackets.io/)。\n- **英文設定**，因為 Git-it 內容目前還是以英文為主，如果沒有特別設定為英文可能造成程式無法運行。如果你電腦的設定不是英文，請到 [TROUBLESHOOT.md](https://github.com/jlord/git-it/blob/master/TROUBLESHOOT.md#system-with-non-english-locale)，頁面最下方有說明該如何設定 Git-it 的語言為英文。\n\n_*Git-it 其實沒有任何關卡需要你「寫程式」，所以如果不想安裝文字編輯器也是沒關係的。每台電腦都有的 TextEdit（Mac）或 Nodepad（Windows）就很足夠了。_\n\n#### 安裝 Git-it\n\n以上的程式都安裝完後，就可以來安裝 Git-it 了。\n\n- 打開你的終端機/Terminal（Mac）或指令提示字元/Cmd（Windows），並把 Git-it 安裝到你的電腦上。[NPM](http://www.npmjs.org)（**包含在 Node.js 裡頭**） 讓你可以用很簡單的指令安裝 Node.js 的各種模組（Git-it 就是一個這樣的模組），像這樣：\n\n```bash\n$ npm install -g git-it\n```\n- _如果這個指令出現「權限不足」之類的錯誤，**試著在指令之前加上 'sudo'**:_ `sudo npm install -g git-it`\n- 顯示安裝成功之後，你就可以試著執行 Git-it：\n\n```bash\n$ git-it\n```\n- 這個指令應該會顯示出一個關卡的列表。一切準備就緒囉！你可以選擇第一個關卡，按下 enter，接著就按照提示開始挑戰吧！\n\n#### 運作方式\n\n- 執行 `git-it` 後，就會出現關卡列表，按上下鍵頭 ↑↓ 來選擇關卡，然後按 'enter' 進入關卡。\n- 關卡內容出現後，可以看到視窗最下面有個提示可以把教學網頁打開。 _也有一個網頁版本的[教學網頁](http://jlord.github.io/git-it/index-zhtw.html)._\n\n![img](https://raw.githubusercontent.com/jlord/git-it/master/guide-ss.png)\n\n- 跟著教學網頁上面的步驟，在終端機中執行一個個的指令來破關。\n- 當你完成一個關卡，在終端機中打上 `git-it verify` 來確認一切正確。\n- 如果關卡中有步驟沒有達成，Git-it 會出現一些錯誤訊息來告訴你錯在哪邊。\n- 破關後，在執行一次 `git-it` 就會回到關卡列表，進入下一個關卡吧！\n\n**如果你在途中碰到任何問題，[開啟一個 issue](https://github.com/jlord/git-it/issues/new) 問我們，或是看看 [troubleshooting doc](https://github.com/jlord/git-it/blob/master/TROUBLESHOOT.md) 可能已經有解答了。**\n\n---\n\n#### 初學者小提示\n\n**語法段落** 通常長這樣：`$ some code-stuff --here`。前面的 $ 金錢符號意思是這行指令是要輸入在終端機裡頭的，但在輸入指令的時候**不要**包含 $ 的符號。照這個例子來說，你實際上輸入的指令會是 `some code-stuff --here`。\n\n**變數** 會在語法段或中用 `\u003c變數名稱\u003e` 來表示。當你要輸如一行指令的時候，把變數名稱，包含 `\u003c\u003e` 用對的內容取代掉。比如說，一個用來新增資料夾的指令是 `mkdir \u003c資料夾名稱\u003e`，你想要新增一個叫做 'octocat' 的資料夾，那叫要打 `mkdir octocat`。\n\n**終端機、命令提示字元** 指的都是同一個東西，就是你在電影上常常看到的黑黑的、滿是數字和英文字的視窗。你可以透過文字指令，用它來和電腦溝通。\n\n透過終端機可以叫電腦做非常多事情，像是刪除、重新命名、複製、新增檔案和資料夾；來回傳送檔案到各個不同的主機（像是把東西傳上 GitHub.com）或是你的電腦（也是一個主機！）。\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlord%2Fgit-it","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjlord%2Fgit-it","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjlord%2Fgit-it/lists"}