天天看點

小白GitHub的使用

step1:GitHub指南

1.repositories 是存放項目的地方。

小白GitHub的使用

2.fork:

你開源了一個項目,别人想在你這個項目的基礎上做些改進,然後應用到自己的項目中,這個時候他就可以Fork你的項目,這個時候他的GitHub首頁上就多了一個項目,隻不過這個項目是基于你的項目基礎(本質上是在原有項目的基礎上建立了一個分支),他就可以随心所欲的去改進,但是絲毫不會影響原有項目的代碼與結構。

3.Issue:問題的意思,舉個例子,就是你開源了一個項目,别人發現你的項目中有bug,或者哪些地方做的不夠好,他就可以給你提個Issue,即問題,提的問題多了,也就是Issues,然後你看到了這些問題就可以去逐個修複,修複好了就可以一個個的 Close 掉。

4.Star:别人給你的項目的點贊數目。

5.Pull Request:發起請求,這個其實是基于 Fork的,還是上面那個例子,如果别人在你基礎上做了改進,後來覺得改進的很不錯,應該要把這些改進讓更多的人收益,于是就想把自己的改進合并到原有項目裡,這個時候他就可以發起一個Pull Request(簡稱PR),原有項目建立人就可以收到這個請求,這個時候他會仔細review你的代碼,并且測試覺得OK了,就會接受你的PR,這個時候你做的改進原有項目就會擁有了。

6.Watch:這個也好了解就是觀察,如果你 Watch了某個項目,那麼以後隻要這個項目有任何更新,你都會第一時間收到關于這個項目的通知提醒。

7.Gist:有些時候你沒有項目可以開源,隻是單純的想分享一些代碼片段,那這個時候 Gist 就派上用場了!

step2:Markdown新手指南

可以先去簡書去查找資料如下面的網址:

https://www.jianshu.com/p/q81RER

1.在 Markdown中,你隻需要在文本前面加上 # 即可,同理、你還可以增加二級标題、三級标題、四級标題、五級标題和六級标題,總共六級,隻需要增加#即可,标題字号相應降低。

# 一級标題
## 二級标題
### 三級标題
#### 四級标題
##### 五級标題
###### 六級标題 
           

注:# 和「一級标題」之間建議保留一個字元的空格,這是最标準的Markdown寫法。

2.腳注

腳注是對文本的補充說明。

Markdown 腳注的格式如下:

1

3.Markdown 清單

無序清單使用星号(*)、加号(+)或是減号(-)作為清單标記,這些标記後面要添加一個空格,然後再填寫内容:

  • 123
  • 123
  • 123

有序清單使用數字并加上 . 号來表示,如:

1.

2.

4.Markdown 區塊 Markdown 區塊引用是在段落開頭使用 > 符号 ,然後後面緊跟一個空格符号:

區塊引用
區塊引用2
區塊引用3

5.如果是段落上的一個函數或片段的代碼可以用反引号把它包起來(`),例如:

printf()

函數

6.可以用 ```包裹一段代碼,并指定一種語言(也可以不指定):

$(document).ready(function () {
    alert('RUNOOB');
});
           

7.Markdown 表格

Markdown 制作表格使用 | 來分隔不同的單元格,使用 - 來分隔表頭和其他行。

表頭 表頭
單元格 單元格
單元格 單元格

對齊方式

我們可以設定表格的對齊方式:

-:

設定内容和标題欄居右對齊。

:-

設定内容和标題欄居左對齊。

:-:

設定内容和标題欄居中對齊。

左對齊 右對齊 居中對齊
單元格 單元格 單元格
單元格 單元格 單元格

step3:Git指南

1.Git安裝

  • Mac:https://sourceforge.net/projects/git-osx-installer/
  • Windows:https://git-for-windows.github.io/
  • Linux:apt-get install git

2.Git指令清單

1、怎麼判斷你Git有沒有安裝成功?請在指令行裡輸入git,如果出現以下提示證明你已經安裝成功了。2、Git所有的操作指令開頭都要以 git 開頭。

3.Git具體指令

  1. 第一步先建立一個檔案夾,在檔案夾中建立一個檔案(win使用者可以自己手動建立)
mkdir test(建立檔案夾test)
cd test(切換到test目錄)
touch a.md(建立a.md檔案)
           

在進行任何 Git 操作之前,都要先切換到 Git 倉庫目錄,也就是先要先切換到項目的檔案夾目錄下。

  • 比如輸入 git status,可以看到如下提示
$ git status
fatal: not a git repository (or any of the parent directories): .git
           

意思就是目前目錄還不是一個 Git 倉庫。

  • git init 這個時候用到了第一個指令,代表初始化 git 倉庫,輸入 git init 之後會提示:
$ git init
Initialized empty Git repository in C:/Users/wang1/test/.git/
           

可以看到初始化成了,至此test目錄已經是一個 git 倉庫了。

  • git status 我們輸入 git status 指令,會有如下提示:
$ git status
On branch master

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
        a.cd
        a.md

nothing added to commit but untracked files present (use "git add" to track)
           

預設就直接在 master 分支,關于分支的概念後面會提,這時最主要的是提示 a.md 檔案 Untracked files ,就是說 a.md 這個檔案還沒有被跟蹤,還沒有送出在 git 倉庫裡呢,而且提示你可以使用 git add 去操作你想要送出的檔案。

git status這個指令顧名思義就是檢視狀态,這個指令可以算是使用最頻繁的一個指令了,建議大家沒事就輸入下這個指令,來檢視你目前 git 倉庫的一些狀态。

  • git add上面提示a.md檔案還沒有送出到git倉庫裡,這個時候我們可以随便編輯下 a.md 檔案,然後輸入 git add a.md ,然後再輸入 git status :
$ git status
On branch master

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
        new file:   a.md
           

此時提示以下檔案 Changes to be committed , 意思就是 a.md 檔案等待被送出,當然你可以使用 git rm --cached 這個指令去移除這個緩存。

  • git commit 接着我們輸入 git commit -m ‘first commit’,這個指令什麼意思呢?commit是送出的意思,-m代表是送出資訊,執行了以上指令代表我們已經正式進行了第一次送出。

這個時候再輸入 git status ,會提示 nothing to commit。

  • git log 這個時候我們輸入 git log 指令,會看到如下:git log 指令可以檢視所有産生的 commit 記錄,是以可以看到已經産生了一條 commit 記錄,而送出時候的附帶資訊叫 ‘first commit’ 。
  • git add & git commit 首先 git add 是先把改動添加到一個「暫存區」,你可以了解成是一個緩存區域,臨時儲存你的改動,而 git commit 才是最後真正的送出。這樣做的好處就是防止誤送出,當然也有辦法把這兩步合并成一步,不過後面再介紹,建議新手先按部就班的一步步來。
  • git branch branch 即分支的意思,分支的概念很重要,尤其是團隊協作的時候,假設兩個人都在做同一個項目,這個時候分支就是保證兩人能協同合作的最大利器了。舉個例子,A, B倆人都在做同一個項目,但是不同的子產品,這個時候A建立了一個分支叫a, B建立了一個分支叫b,這樣A、B做的所有代碼改動都各自在各自的分支,互不影響,等到倆人都把各自的子產品都做完了,最後再統一把分支合并起來。
執行 git init初始化git倉庫之後會預設生成一個主分支master,也是你所在的預設分支,也基本是實際開發正式環境下的分支,一般情況下master分支不會輕易直接在上面操作的,你們可以輸入 git branch 檢視下目前分支情況:
但是可以看到 master 分支前有個 * 号,即雖然建立了一個a的分支,但是目前所在的分支還是在master上,如果我們想在a分支上進行開發,首先要先切換到 a 分支上才行,是以下一步要切換分支
  • git checkout a 執行這個指令,然後再輸入 git branch 檢視下分支情況:可以看到目前我們在的分支已經是a了,這個時候 A 同學就可以盡情的在他建立的a分支去進行代碼改動了。

我要先建立再切換,未免有點麻煩,有沒有一步到位的,聰明:

git checkout -b a
           

這個指令的意思就是建立一個a分支,并且自動切換到a分支。

  • git merge A同學在a分支代碼寫的不亦樂乎,終于他的功能完工了,并且測試也都ok了,準備要上線了,這個時候就需要把他的代碼合并到主分支 master上來,然後釋出。git merge 就是合并分支用到的指令,針對這個情況,需要先做兩步,第一步是切換到 master 分支,如果你已經在了就不用切換了,第二步執行 git merge a,意思就是把a分支的代碼合并過來,不出意外,這個時候a分支的代碼就順利合并到master分支來了。為什麼說不出意外呢?因為這個時候可能會有沖突而合并失敗,
  • git branch -d 有建立分支,那肯定有删除分支,假如這個分支建立錯了,或者a分支的代碼已經順利合并到master分支來了,那麼a分支沒用了,需要删除,這個時候執行 git branch -d a就可以把a分支删除了。
  • git branch -D 有些時候可能會删除失敗,比如如果a分支的代碼還沒有合并到master,你執行 git branch -d a是删除不了的,它會智能的提示你a分支還有未合并的代碼,但是如果你非要删除,那就執行 git branch -D a 就可以強制删除a分支。
  • git tag 大家都知道在用戶端開發的時候經常有版本的概念,比如v1.0、v1.1之類的,不同的版本肯定對應不同的代碼,是以一般要給我們的代碼加上标簽,這樣假設v1.1版本出了一個新bug,但是又不曉得v1.0是不是有這個bug,有了标簽就可以順利切換到v1.0的代碼,重新打個包測試了。
  • 想要切換到某個tag怎麼辦?也很簡單,執行
git checkout v1.0
           

這樣就順利的切換到 v1.0 tag的代碼狀态了。

以上内容為本人查找資料之後結合自己的情況進行的學習記錄,個别内容可能雷同,侵禁删!

關于GitHub的學習之路剛剛開始。

  1. 第一個腳注 ↩︎

繼續閱讀