[[243069]]

Github 是一個存放著世界上最棒的一些軟件項目的寶藏，這些軟件項目由全世界的開發者無私貢獻。這個看似簡單，實則非常強大的平臺因為大大幫助了那些對開發大規模軟件感興趣的開發者而被開源社區所稱道。

這篇向導是對于安裝和使用 GitHub 的的一個快速說明，本文還將涉及諸如創建本地倉庫，如何鏈接這個本地倉庫到包含你的項目的遠程倉庫（這樣每個人都能看到你的項目了），以及如何提交改變并最終推送所有的本地內容到 Github。

請注意這篇向導假設你對 Git 術語有基本的了解，如推送、拉取請求（PR）、提交、倉庫等等。并且希望你在 GitHub 上已注冊成功并記下了你的 GitHub 用戶名，那么我們這就進入正題吧： 

1、在 Linux 上安裝 Git

下載并安裝 Git：

sudo apt-get install git

上面的命令適用于 Ubuntu 并且應該在所有***版的 Ubuntu 上都能工作，它們在 Ubuntu 16.04 和 Ubuntu 18.04 LTS （Bionic Beaver）上都測試過，在將來的版本上應該也能工作。 

2、配置 GitHub

一旦安裝完成，接下去就是配置 GitHub 用戶的詳細配置信息。請使用下面的兩條命令，并確保用你自己的 GitHub 用戶名替換 user_name，用你創建 GitHub 賬戶的電子郵件替換 email_id。

git config --global user.name "user_name"
git config --global user.email "email_id"

下面的圖片顯示的例子是如何用我的 GitHub 用戶名：“akshaypai” 和我的郵件地址 “abc123@gmail.com” 來配置上面的命令。

Git config 

3、創建本地倉庫

在你的系統上創建一個目錄。它將會被作為本地倉庫使用，稍后它會被推送到 GitHub 的遠程倉庫。請使用如下命令：

git init Mytest

如果目錄被成功創建，你會看到如下信息：

Initialized empty Git repository in /home/akshay/Mytest/.git/

這行信息可能隨你的系統不同而變化。

這里，Mytest 是創建的目錄，而 init 將其轉化為一個 GitHub 倉庫。將當前目錄改為這個新創建的目錄。

cd Mytest 

4、新建一個 README 文件來描述倉庫

現在創建一個 README 文件并輸入一些文本，如 “this is git setup on linux”。README 文件一般用于描述這個倉庫用來放置什么內容或這個項目是關于什么的。例如：

gedit README

你可以使用任何文本編輯器。我喜歡使用 gedit。README 文件的內容可以為：

This is a git repo 

5、將倉庫里的文件加入一個索引

這是很重要的一步。這里我們會將所有需要推送到 GitHub 的內容都加入一個索引。這些內容可能包括你***次加入倉庫的文本文件或者應用程序，也有可能是對已存在文件的一些編輯（文件的一個更新版本）。

既然我們已經有了 README 文件，那么讓我們創建一個別的文件吧，如一個簡單的 C 程序，我們叫它 sample.c。文件內容是:

#include<stdio.h>
int main()
{
printf("hello world");
return 0;
}

現在我們有兩個文件了。README 和 sample.c。

用下面的命令將它們加入索引：

git add README
git add smaple.c

請注意 git add 命令能將任意數量的文件和目錄加入到索引。這里，當我說 “索引” 的時候，我是指一個有一定空間的緩沖區，這個緩沖區存儲了所有已經被加入到 Git 倉庫的文件或目錄。 

6、將所作的改動加入索引

所有的文件都加好以后，你就可以提交了。這意味著你已經確定了最終的文件改動（或增加），現在它們已經準備好被上傳到我們自己的倉庫了。請使用命令：

git commit -m "some_message"

“some_message” 在上面的命令里可以是一些簡單的信息如“我的***次提交”或者“ 編輯了readme 文件”，等等。 

7、在 GitHub 上創建一個倉庫

在 GitHub 上創建一個倉庫。請注意倉庫的名字必須和你本地創建的倉庫的名字嚴格一致。在這個例子里是 “Mytest”。請首先登錄你的 GitHub 賬戶 。點擊頁面右上角的 “+” 符號，并選擇“create nw repository”。如下圖所示填入詳細信息，點擊 “create repository”。

Creating a repository on GitHub

一旦創建完成，我們就能將本地的倉庫推送到 GitHub 你名下的倉庫，用下列命令連接 GitHub 上的倉庫：

請注意：請確保在運行下列命令前替換了路徑中的 “user_name” 和 “Mytest” 為你的 GitHub 用戶名和目錄名！

git remote add origin https://github.com/user\_name/Mytest.git> 

8、將本地倉庫里的文件推送到 GitHub 倉庫

***一步是用下列的命令將本地倉庫的內容推送到遠程倉庫（GitHub）：

git push origin master

當提示登錄名和密碼時鍵入登錄名和密碼。

下面的圖片顯示了步驟5到步驟8的流程

Pushing files in local repository to GitHub repository

上述將 Mytest 目錄里的所有內容（文件）推送到了 GitHub。對于以后的項目或者創建新的倉庫，你可以直接從步驟 3 開始。***，如果你登錄你的 GitHub 賬戶并點擊你的 Mytest 倉庫，你會看到這兩個文件：README 和 sample.c 已經被上傳并像如下圖片顯示：

Content uploaded to Github