[轉]github詳細教程

標籤：tin   front-end   介紹   tom   圖表   首頁   you   大於   粘貼   

GitHub詳解

      GitHub 是一個共用虛擬機器主機服務，用於存放使用Git版本控制的軟體代碼和內容項目。它由GitHub公司（曾稱Logical Awesome）的開發人員Chris Wanstrath、PJ Hyett和Tom Preston-Werner使用Ruby on Rails編寫而成。
      GitHub同時提供付費賬戶和為開源項目提供的免費賬戶。根據在2009年的Git使用者調查，GitHub是最流行的Git訪問網站。除了允許個人和組織建立和存取碼庫以外，它也提供了一些方便社會化軟體開發的功能，包括允許使用者跟蹤其他使用者、組織、軟體庫的動態，對軟體代碼的改動和 bug 提出評論等。GitHub也提供了圖表功能，用於顯示開發人員們怎樣在程式碼程式庫上工作以及軟體的開發活躍程度。
      GitHub也提供一個粘貼箱風格的網站Gist，供軟體程式碼程式庫使用的Wiki，以及通過git版本庫進行編輯和管理的網頁託管功能。

一.註冊

登入到https://github.com，

按照步驟註冊即可。一般選擇免費，上傳的代碼會公開；付費可以不公開託管的代碼。

二．修改使用者名稱

有時我們需要修改使用者名稱（使用者名稱很重要），登陸https://github.com/，點擊進入Personal settings，點擊，如：

點擊Change username修改使用者名稱。

三．安裝GitHub for Windows

https://github.com首頁的下方，

四．建立一個的repository，Managed 程式碼到GitHub上

一個repository（倉庫）可以放一個項目。我們用GitHub for Windows軟體建立本地倉庫。

1.在建立之前我們先認識軟體。開啟GitHub for Windows，登陸自己註冊的帳號，最左側是本地倉庫，中間是每次更新的Commit評論，最右側是倉庫的代碼，可以查看每次的修改和添加。

2.我們點擊右上側的，先對軟體進行設定

開啟Options，根據自己的情況設定Clone path，也是建立repository的本地倉庫的預設位置，以後我們建的倉庫都會在位置的檔案夾裡。也可設定Congfigure git，其他預設。如：

3.回到主介面，點擊軟體上方的，建立一個repository

我們可以看到，建立的倉庫是在預設位置的檔案夾裡並以倉庫名為檔案夾。 

註： 

?Name不允許單詞有空格，建議用“-”串連。

?Local path是你預設地址+Name；當然我們也可以點擊Browse，選擇本地倉庫位置。

?Git ignore忽略某些檔案，項目中經常會產生一些Git系統不需要追蹤(track)的檔案。典型的是在編譯產生過程中產生的檔案或是編程器產生的臨機操作備份檔案。一般預設。

點擊Create respository，我們可以看到如下介面：

.gitattibutes和.gitignore是預設產生的。本地倉庫已建成功。

我們點擊右上面的Publish Respository，將本地倉庫同步到遠程倉庫。

添加Description，對倉庫的描述。

發布成功後，Publish Respository表徵圖會變成Sync，代表已經同步。

若是建立的倉庫位置無代碼，我們要把代碼複製進來，右擊Front-end-engineer倉庫，

註：

?View on GitHub是開啟網頁，即Front-end-engineer的遠程倉庫。

?Open in GIt Shell是開啟命令。可以學習git命令，本文暫不介紹git命令。

?Remove是將本地倉庫移除。但遠程倉庫並不影響，只是本地有改動不再更新遠程庫。

點擊Open in Explore，進入Front-end-engineer本地倉庫檔案夾，然後將項目代碼複製到本地倉庫裡。（當然若是選擇的代碼位置作為倉庫以上就不需要複製代碼了。）

我們再回到Windows for GitHub裡，可以看到中間欄出現了Uncommit changes，以後每一次本地代碼更新都會產生一個Uncommit changes，

我們需要評論，提交Commit，才能將本地倉庫的改動同步到遠程倉庫。具體做法：

點擊Show，

這時我們可以看到最右側欄已經有我們添加的代碼了，然後填寫Summary（更新內容總結）和Description（更新的描述），最後點擊Commit to master（master是主分支，一般預設），就可以將更新同步至遠程倉庫了。

最後，我們還要為倉庫項目添加README.md，用來說明項目或程式。

4.README.md編輯

      兩種添加方式：一登陸https://github.com/，選擇要添加README.md的倉庫，在遠程倉庫添加README.md，且線上編輯可預覽效果；二利用編輯器（如sublime）在本地添加README.md，再同步到遠程倉庫。

      若已經有README.md，我們可以在遠程倉庫檔案目錄中點擊，然後選擇進行修改。

      README.md並不是隨便編寫的，它有特定的文法。

①關於標題

?大標題
====

在文本下面加上 等號 = ，那麼上方的文本就變成了大標題。等號的個數無限制，但一定要大於0個。

?中標題
-------

在文本下面加上底線 - ，那麼上方的文本就變成了中標題，同樣的底線個數無限制。

?除此以外，關於標題還有等級標記法，分為六個等級，顯示的文字大小依次減小。不同等級之間是以井號 # 的個數來標識的。一級標題有一個 #，二級標題有兩個# ，以此類推。

#一級標題

##二級標題

###三級標題

####四級標題

#####五級標題

######六級標題

效果如下：

實際上，前文所述的大標題和中標題是分別和一級標題和二級標題對應的。三到六級沒有下面的橫線。

②顯示文本

?要顯示一個超連結的話，就直接輸入這個連結的URL

?給一段文字加入超連結的格式：[ 要顯示的文字]( 連結的地址"懸停顯示的字")。"懸停顯示的字"是可選項。

?插入圓點符，在文字前加*，要注意的是星號* 後面要有一個空格。否則顯示為普通星號。此外還有二級圓點和三級圓點。就是多加一個Tab。第二行一個Tab，第三行兩個Tab。

③插入圖片

?第一種方法：![](圖片連結的地址"懸停顯示的字")。"懸停顯示的字"是可選項。

?第二種方法：GitHub倉庫裡的圖片（建議使用這種方法，其他來源URL很可能會失效）。

前提是你的遠程倉庫有圖片，圖片連結的地址格式如下：

https://github.com/你的使用者名稱/你的項目名/raw/分支名/存放圖片的檔案夾/該檔案夾下的圖片

其中，raw表示原資料的意思；主分支master。一般預設。

④插入代碼

我們需要在代碼的上一行和下一行用``` 標記。第一行後可加語言，可加亮代碼。``` 不是三個單引號，而是數字1左邊，Tab鍵上面的鍵。 樣本如下：

```ruby
require ‘redcarpet‘
markdown = Redcarpet.new("Hello World!")
puts markdown.to_html
```

如果你想使一段話中部分文字高亮顯示，來起到突出強調的作用，可以把它用 ` ` 包圍起來。

⑤插入表格

| First Header  | Second Header |
| ------------- | ------------- |
| Content Cell  | Content Cell  |
| Content Cell  | Content Cell  |

⑥以上基本夠用了，不會的就用html標籤。

markdown支援大部分的html文本編輯標籤。例如換行，用<br>等。但markdown有些標籤寫起來要簡潔得多。附：markdown支援的html標籤。

五．對已有倉庫修改設定

登陸到https://github.com/，點擊使用者名稱，進入Contributions頁面

點擊你要設定的repository，

點擊右下角的Settings，可以設定倉庫，比如刪除倉庫

六．GitHub上找自己要的代碼，存到本地倉庫

1.登陸到https://github.com/，在搜尋方塊中，輸入關鍵字搜尋

2. 找到自己感興趣的項目，點擊fork，將別人的項目存到自己遠程倉庫裡。

在Github中，開發人員除了可以託管自己的項目源碼外，還可以Watch（關注）、Star（加星）、Fork（複製一份）、Pull Request（提交問題或申請功能）其他開發人員的項目。

fork：複製別人的程式碼程式庫到自己的項目中，可以作為子模組的形式使用，或二次開發。在開源項目中點擊fork按鈕，稍等一會兒，該項目便會拷貝一份到你的respositories中。

3.在GitHub for Windows中，將遠程fork的倉庫clone到本地，點擊，進入clone，

4.當然，你可以在網頁上直接下載項目或代碼。若要將別人的項目代碼存到自己的倉庫中，則用上面方法。

七．Create an organization

建立組織，邀請成員，共同開發，共同分享。

在https://github.com/上建立，點擊，New organization，

進入頁面建立organization，命名規則同倉庫名命名規則。

建成後，可以邀請成員，可為organization建repository等。點擊使用者名稱進入使用者中心，在左下角，

點擊你的organization，為organization建repository，Invite someone。

八．利用GitHut構建網站

      Github託管項目所支援的類型，一種是User/Organization Pages，另一種是Project Pages，這是兩種Github託管網站上支援的兩種基本類型。

User/Organization Pages
      這個是Github為每個賬戶分配的一個次層網域，不過需要注意的是必須以那你的使用者名稱作為開頭,不然無法訪問。
Project Pages
      除了上述提到以自己的名字來命名的倉庫，其他所建的都可以看成是Project Pages。不過要想實現對頁面的訪問，則就需要建立gh-pages分支來訪問。

我們用User/Organization Pages構建網站

1.用GitHub for Windows建立jingwhale.github.io倉庫，這裡不再贅述。建網站，User/Organization Pages 個人或公司網站建設倉庫名必須為用username或organization。建立倉庫的步驟參考第四部分。

2.登陸https://github.com，進入所建的jingwhale.github.io倉庫，點擊settings，這時你可以看到你要建網站的網域名稱http://jingwhale.github.io，找到Automatic page generator

點擊進去，看到跳轉的頁面:

Project Name:網站標題；Tagline：網站副標題；Body：這個就是網頁源碼了。

點擊" Continue to Layouts"，選擇主題，然後發布

現在,你可以訪問自己的GitHub.io 上的首頁了，例如：http://jingwhale.github.io/。

註：http://jingwhale.github.io/若打不開，報404，可以等30分鐘左右；或者重複以上步驟，重新發布。

3.同步自己的網站到GitHub

將自己建的username.github.io(如jingwhale.github.io)遠程倉庫clone到本地，把你開發好的網頁複製到剛clone的本地倉庫裡並同步到遠程倉庫，再訪問http://jingwhale.github.io/，就是訪問你自己寫的網站了。（注意，其中index.html是首頁）。

4.將自己的網域名稱綁定到github pages上

①添加CNAME檔案

登陸到https://github.com/，在username.github.io倉庫根目錄下添加一個CNAM檔案，沒有尾碼名，裡面內容為你的網域名稱(如:test.com),不需要添加http/www等首碼。

②記錄下IP地址

在https://github.com/，點擊help，進入help頁面，在搜尋方塊裡DNS，找到Tips for configuring an A record with your DNS provider。查詢到關聯GitHub時佈建網域名解析記錄的IP地址（192.30.252.153或192.30.252.154）。也有人ping username.github.io得到IP地址。

③配置A記錄

登陸你的網域名稱管理介面。建立一條A記錄，指向192.30.252.153或192.30.252.154這個IP地址。

④驗證網域名稱與github關聯是否成功。

先以github的連結方式訪問一次，查看介面；再以網域名稱的方式訪問一次，查看介面；兩者所查看到的介面是一致。

註：

?若網域名稱不能立即訪問，需等待一段時間再訪問。

?當github成功關聯到網域名稱後，以github的連結方式進行訪問，其會自動轉化為網域名稱訪問。

完

轉載需註明轉載字樣，標註原作者和原博文地址。

[轉]github詳細教程