Github first commit

Github 建立新儲存庫 (repo) 後，會直接跳到一個教學頁面，告訴你下一步可以如何進行：

以下是要在本機「新建」一個 git 儲存庫， 並將版控同步到該 github 儲存空間 (github git repo)：

將會把一個資料夾，變成 git 儲存庫 (git repo)， 然後建立與它「關聯」的「遠端儲存庫」， 並將一個被版控檔案推送上去。

首先使用「終端機」應用程式來操作電腦。 將終端機目錄移動到我們的 "專案資料夾" 中， 這個資料夾，就是之後我們要做版本控制的資料夾。 以文字指令 (command line) 的方式，建立一個新檔案。 ps1. 什麼是 command line。

輸出字串 "# whyFooBar" ，存入 README.md 檔案 (目前沒有該檔案，會自己生出)：

echo "# whyFooBar">> README.md

• echo ：输出字串，是類 terminal 系統的指令。 https://www.wikiwand.com/zh/Echo_(%E5%91%BD%E4%BB%A4)

將當前資料夾初始化為一個 git 儲存庫：

git init

• init ：初始化。

這指令會在當前資料夾，產生一些 git 檔案， 讓資料夾變成有版本控制功能的資料夾，也就是變成一個 「git 儲存庫」。

儲存庫中的檔案，不會自動被追蹤變化， 需將檔案 "主動加入版本控制"，之後檔案有變動，才會被紀錄。

加入版控流程： 會將要提交的檔案放入 stage (準備區)， 將 stage 中的檔案，一起提交給儲存庫，成同「一個版本號」異動。

將 "README.md" 檔案加入 "版本控制"

git add README.md

• git add ：執行 git 指令，將檔案加入 stage。

將 stage 中的檔案異動，標記為一個版本，並加上此版本的備註 "first commit"

git commit -m "first commit"

• git commit 將準備區的檔案提交到本地的儲存庫變成一個版本。
• -m 後面的 "first commit" 是輸入這次提交的 "備註"
  備註註記，例如這次版本變化的目的、進度、修改... 方便他人理解這次提交的概要。 (進階可以搜尋 "git commit template" 看看註記的格式)

建立一個與「此儲存庫」關聯的「遠端儲存庫」(位置就是剛剛建的 github 儲存庫網址)

git remote add origin https://github.com/oooooo/whyFooBar.git

• remote "遠端" 的意思。
• origin 是 "遠端的分支" 的意思，空一格後面接 "遠端空間網址"。
• origin Git 會自動幫你將此“遠端倉庫”命名為 "origin"

將目前儲存庫分支 (預設初始分支名為 "master"）更新到關聯的遠端 repo 的 master 分枝

git push -u origin master

• git push 將檔案推到遠端的主機。
• -u 是記住這個後面遠端和本地對應分枝關係。以後就可以直接用 git push 就執行推到 origin xxx 的對應分枝。
• master (儲存庫中的主線，預設叫做 master)，

ps1. 使用 command line，就是使用終端機應用程式來操作電腦， 它是用輸入文字指令的方式告訴電腦要幹麻 (不然通常是滑鼠點視窗介面)。
總之，打開終端機後，要先到你要動作的資料夾中。

以下 mac 電腦中：

• 開啟終端機預設是使用者個人 home 目錄 (~ 符號，是 home 簡稱)。
• $ 符號出現，表示可以開始輸入命令 ($ 符號前面，是目前的所在資料夾名稱)。
• 移動”所在位置“，指令 cd (Change Directory)，ex cd xxx 進入 (目前所在資料夾中) 的 "xxx" 資料夾，詳情請 google，或這裡有個不錯的說明..。