GitHub 遊客手冊 - sppmg/TW_Thesis_Template GitHub Wiki

本文目錄:


這裡不教 Git ,是給不用 Git 的遊客看的,讓你知道如何下載 GitHub 上的專案。

GitHub 是什麼?

GitHub 不同於 Google 雲端、Dropbox、Mega 這類網路空間。它的存在價值不僅止於網路儲存,更重要的是它提供了一個多人參與、開發專案的平台。 (這裡所說的「專案」通常是程式碼,但事實上你可以用來管理任何數位資料。)

GitHub 擁有的功能至少有:

  • 版本控制系統;使用 Git 這個版本控制軟體來紀錄你的專案。線上檢視原始碼、版本變化。亦可複製、下載專案。
  • 問題追蹤系統;其他使用者可以提交問題給開發者。
  • 計畫列表
  • Wiki ;做簡易說明。
  • Gist; 類似 Pastebin 的程式碼剪貼簿。
  • Pages; 可用於製作靜態網站。

Git 是什麼?

在介紹 Git 之前,讓我們想想,如果有個檔案(通常是程式碼)你要修改、新增內容,但又怕原來弄好的東西被破壞,你會如何做?

最簡單的方法就是複製成新檔(同時改名)再改。但當版本日益增加,工作目錄內的檔案將越來越亂,充斥著不知所云的檔名......

於是乎「版本控制系統」(Version Control System) 出現了。經過幾十年的演進,VCS 功能越來越多,也發展出不同的管理模式。其中 Git 即為目前最流行的 VCS。

Git 有哪些好處?

  • Free (無論是在$$方面或是軟體使用上)
  • 容易分支與合併。 你隨時可以開新分支打副本任務,同時也可以在主線上繼續前進。之後的合併也很方便。
  • 分散式儲存(須遠端倉庫,如 GitHub )。家裡一份、筆電一份、公司一份 GitHub 還有一份。即使哪天你的筆電將成為古蹟也不怕。
  • 乾淨的工作目錄。目錄內僅存有當前快照的檔案。
  • 時空跳躍。讓工作目錄跳到你要的某一個狀態。

(說好不提 Git 的..... 這裡有我的 Git introduction 投影片,是以前 lab meeting 用的,各位有興趣可以看看。)

如何下載?

首先你要記得 Git 是一個「版本控制系統」。所以你要先選擇進入到哪個分支。

我個人的習慣是採用至少兩個分支

  • master
  • develop

develop 是最新進度、開發版,可能包含 bug 。 master 則是穩定版。

按下( Code 分頁中)Branch: master 鈕後,你就可以看到跳出的子分頁有上述兩個分支。

Branch 子分頁中,另一個分頁是 Tags ,它可以標記任一個專案狀態,一般都拿來標記穩定版本。

選擇 BranchTags 後,頁面上的檔案也會隨之而改。接著看你是要瀏覽或是下載都可。

下載單一檔案

GitHub 不支援單檔下載,請在進入單檔的畫面後,點 Raw 按鈕

你就可以直接連到那個檔案。之後按瀏覽器的儲存(或快速鍵Ctrl+s)另存到電腦中。

下載整個專案

在最上層目錄中,右邊有綠色 Download or Clone 按鈕。

瀏覽器

Download or Clone 子分頁的 Download ZIP

Git

Download or Clone 子分頁右上角選擇使用 HTTPSSSH (可能要登入) ,之後用 clone 複製

git clone <url>

(日後要用 ssh key 自動登入、push 的使用者記得選 ssh ,我當初搞好久,後來才發現是一直用 https 登入,難怪 ssh key 設定都沒用。)

⚠️ **GitHub.com Fallback** ⚠️