1. 程式人生 > >藉助GitHub託管你的專案程式碼

藉助GitHub託管你的專案程式碼

PS:話說自己註冊了GitHub都很久了,卻沒有怎麼去弄,現在系統學習一下,也把自己的學習經歷總結下來share給大家,希望大家都能把GitHub用起來,把你的專案程式碼happy地託管起來!

一、基本概念

  1.1 必須瞭解的概念

  (1)倉庫 - Repository

  倉庫即你的專案,你想在GitHub上開源一個專案,那就必須要新建一個Repository。如果你開源的專案有多個,那麼你就有多個Repositories。

  (2)收藏 - Star

  收藏專案,方便下次檢視。如果你的專案被收藏的次數越多,那麼你的專案也就越受廣大開發者的歡迎咯。

  (3)複製克隆專案 - Fork

  如果你開源了一個專案,別人想在你這個專案的基礎之上做些改進,然後應用到自己的專案中,這時他就可以Fork你的專案,然後他的GitHub主頁上就多了一個專案,只不過這個專案是基於你的專案為基礎(相當於別人拿到了一個副本)。Fork之後,他就可以隨心所欲地去改進,但是絲毫不會影響原有專案的程式碼與結構。

  (4)發起請求 - Pull Request

  如果別人在你的專案基礎之上做了一些改進,並且覺得改得很不錯,應該要把這些改進讓更多的人受益。於是,他就想把自己的改進合併進原有專案之中,這時他就可以發起一個Pull Request。而原有專案建立人也就是你,可以收到這個請求,這個時候你可能會仔細review他的程式碼,並且測試後覺得OK,就可以接受他的Pull Request,之後他做的改進就可以融入到原有專案之中了。

  (5)關注 - Watch

  類似於微博中的關注,如果你Watch了某個專案,那麼以後只要這個專案有任何更新,你都會第一時間收到關於這個專案的通知提醒。

  (6)事務卡片 - Issue

  你開源了一個專案,別人發現你的專案中有bug,或者哪些地方做的不夠好,他就可以給你提一個Issue(即問題)。你如果看到了這些Issue,就可以逐個去Fix修復,修復OK之後就可以一個一個地Close掉。

  (7)GitHub主頁

  如果你註冊了一個GitHub賬號,那麼久會有一個屬於你的GitHub主頁,該頁面左側主要顯示使用者動態以及關注使用者/倉庫的動態,右側則顯示所有的Git庫。

  (8)倉庫主頁

  倉庫主頁主要顯示專案的資訊,如:專案程式碼、版本、收藏/關注/Fork情況 等等。

  (9)個人主頁

  個人資訊:頭像、個人簡介、關注我的人,我關注的人,我關注的Git庫,我的開源專案,我貢獻的開源專案資訊 等等。

  你可以通過下圖“形(Xie)象(E)”地理解GitHub主頁。

  看完上面這張圖,你是不是秒懂呢?

  1.2 必須完成的準備

  要使用GitHub,首先必須得註冊一個GitHub賬號啦!

  註冊過程很easy,就跟你平時註冊小網站會員一樣,詳細資訊可以瀏覽:點此瞭解註冊詳情

  需要注意的地方就是,選擇Free免費賬號完成設定!那麼收費的跟免費的有什麼區別呢?私有的倉庫只有自己或者指定的朋友才有許可權操作。

  註冊完成之後,記住要驗證郵箱!如果未驗證郵箱,那麼你是沒法做後續操作的。

二、GitHub基本操作

  2.1 建立倉庫

  在GitHub中點選New repository活著Start a Project即可:

  現在我新建一個倉庫,這個倉庫假設是我寫的一個數據結構的例項程式Demo程式庫:

  Step1.填寫必要資訊:

  Step2.瀏覽倉庫主頁

  2.2 建立檔案

  在剛剛的倉庫主頁中點選 Create new file 按鈕,即可進入新檔案頁面:

  Step1.填寫必要資訊之檔案資訊

  Step2.填寫必要資訊之記錄資訊

  Step3.瀏覽提交檔案記錄

  Step4.瀏覽具體檔案資訊

  2.3 編輯檔案

  在指定的檔名處直接點選檔名連結,即可進入編輯介面:

  Step1.點選檔名:

  Step2.修改檔案資訊

  假如我們要加入一行文字資訊:

  繼續填寫提交記錄日誌資訊:

  Step3.瀏覽修改後的檔案

  2.4 刪除檔案

  在指定的檔名處直接點選檔名連結,即可進入檔案資訊介面,點選刪除按鈕:

  Step1.點選刪除按鈕

  Step2.填寫日誌記錄並點選Commit Changes

  Step3.刪除的檔案不會出現在專案結構中,只能通過提交日誌記錄檢視:

  2.5 上傳檔案

  在倉庫主頁點選Upload files按鈕進入上傳頁面,選擇要上傳的檔案,點選上傳即可。注意:這裡可以一次性上傳多個檔案。

  2.6 搜尋倉庫檔案

  在倉庫主頁點選Find file按鈕,即可進入搜尋頁面:

  假如我要搜尋log,由於專案中沒有log檔案,所以沒有搜尋結果:

  2.7 下載/檢出專案

  在倉庫主頁點選Clone or download按鈕,即可彈出下載提示框:

  2.8 GitHub Issues

  假如張三發現了李四的開源專案中存在一個bug,那麼張三就可以為這個專案新建一個issue,我們可以把它理解為專案的問題列表,參與這個專案的開發者們可以在問題列表中進行交流:

  Step1.新建Issue

  Step2.填寫Issue資訊,告知專案開發者

  Step3.修復完成之後,可以回覆Issue資訊,告知提問者該Issue已修復

  Step4.一般來說會由提問者來Close這個Issue,當然也可以由專案擁有者來Close。

  2.9 Fork 複製克隆一個開源專案

  假設我最近對StackExchange.Redis這個開源客戶端專案很感興趣,那麼我可以Fork一下,看看有什麼可以學習有什麼可以優化的,我只需要點選Fork按鈕,即可一秒建立一個Branch:

  克隆之後,你的主頁會多一個project,並且會註明forked from StackExchange.Redis

  如果你在修改完善了部分程式碼之後覺得你想把你的change融入到原有專案之中,讓更多的人受益,那麼你可以發起一個Pull Request:

  點選之後,會顯示所有你的修改,相當於你在提交之前review一下你的修改記錄,這裡我啥也沒改,所以顯示 There isn’t anything to compare.

  當你commit你的change之後,原有專案的所有者就會在他的GitHub主頁看到誰誰誰提交了他的程式碼,並會看到你的comment。

  這時,他就可以看到你做的檔案修改,並選擇review你的程式碼,最後決定是否merge到他的原有專案之中。

  好了,現在我們來複習一下GitHub基本流程:

三、Git基本操作

  3.1 安裝Git

  可以去官網選擇下載,這裡使用的是Git-2.9.0 64位版本:點我下載

  全程傻瓜化安裝,下一步即可,可以把命令模式和圖形介面模式都勾選上。

  3.2 Git基本流程

  3.3 Git初始化操作及倉庫管理

  這裡我們主要採用命令列模式,這也是Linux伺服器的精髓所在,圖形模式很easy,看看就會了。

  (1)設定基本資訊

-- 設定使用者名稱

git config --global user.name 'zhangsan'

-- 設定賬戶郵箱

git config --global user.email '[email protected]'  

  新建一個資料夾作為你的Git Workspace,然後開啟Git Bash命令列介面:

  (2)初始化一個新的Git倉庫

  Step1.建立一個倉庫資料夾,這裡取名跟剛剛在GitHub裡面一樣的DataStructure.Demo.CSharp

  Step2.在檔案內初始化Git(建立Git倉庫)

--初始化

git init

  (3)向倉庫中新增檔案

  假設我們寫了一個MyArrayStack類,我們把他copy到該資料夾中,使用以下命令加入到暫存區中:

git add MyArrayStack.cs

  然後我們需要將暫存區檔案新增到倉庫:

git commit -m 'add MyArrayStack.cs'

  這時我們再通過git status檢視,你會發現已經沒有什麼檔案更改或要提交的檔案了。

  (4)修改檔案

  當你修改了檔案之後,通過git status可以檢視到你修改了什麼東西,同樣還是要經歷提交到暫存區再提交到倉庫的步驟,此處不再贅述。

  (5)刪除檔案

  當你不再想要某個程式碼檔案時,你可以通過git rm filename的命令刪除檔案:

git rm MyArrayStack.cs

  3.4 使用Git管理遠端倉庫

  我們剛剛提到Git的基本流程是工作區到暫存區再到Git倉庫,那麼Git倉庫和遠端倉庫又是如何聯絡起來的呢?

  (1)Git克隆操作:將遠端倉庫複製到本地

git clone https://github.com/edisonchou/DataStructure.Demo.CSharp  

  (2)修改程式碼,按照老步驟提交到Git倉庫

  這裡因為原始專案是啥也沒有,所以我索性把我之前寫的一個數據結構的Demo程式庫直接拖動到了這個資料夾中。

-- 新增所有檔案

git add --all 

git status

git commit -m 'add solution code' 

  這時我們已經提交到了git倉庫,需要同步到github遠端倉庫了:

git push

-- 後面可能會要求你輸入賬號和密碼

  這時我們再次進入GitHub主頁,可以看到我們的專案已經有剛剛同步的程式碼了:

  PS:如果出現git push錯誤,提示The requested URL returned error : 403 Forbidden while accessing.你可以輸入使用者名稱密碼或者遠端地址採用這種型別(vi.git/config)

  將[remote "orgin"] url=https://github.com/使用者名稱/倉庫名.git

  改為[remote "orgin"] url=https://github.com/使用者名稱:密碼@github.com/使用者名稱/倉庫名.git

四、GitHub Pages搭建網站

  4.1 個人站點

  GitHub要求個人站點的倉庫名稱必須是 使用者名稱.github.io, 例如edisonchou.github.io

  建立方法很簡單,也是新建一個repository,然後填寫你的個人站點名,例如 edisonchou.github.io。之後通過Git,你可以將你在本地開發的html網頁同步到github,之後你就可以通過域名訪問你的個人站點啦!

  釋出之後的個人站點如下:

  4.2 專案站點

  搭建後的訪問域名為:https://使用者名稱.github.io/倉庫名

  (1)進入專案主頁,點選Settings

  (2)在Settings頁面,點選Launch automatic page generator來自動生成主題頁面

  (3)新建站點基礎資訊設定

  (4)選擇主題

  (5)生成網頁

參考資料

(1)GitHub-百度百科

(3)怎麼使用GitHub-知乎

(4)廖雪峰-Git教程

(5)楊曉輝-GitHub for Windows使用教程 => Windows下可以使用GitHub for Windows工具進行操作,很方便!

作者:周旭龍

本文版權歸作者和部落格園共有,歡迎轉載,但未經作者同意必須保留此段宣告,且在文章頁面明顯位置給出原文連結。

相關推薦

藉助GitHub託管專案程式碼

PS:話說自己註冊了GitHub都很久了,卻沒有怎麼去弄,現在系統學習一下,也把自己的學習經歷總結下來share給大家,希望大家都能把GitHub用起來,把你的專案程式碼happy地託管起來! 一、基本概念   1.1 必須瞭解的概念   (1)倉庫 - Repository   倉庫即你的專案,你想

lunix或者centos伺服器下如何下載自己在github上面的專案程式碼

一、通過git下載 1、若電腦未安裝git,需先安裝git 檢視系統是否已經安裝git git --version 2、CentOS7 yum 安裝git yum install -y git 解除安裝git yum remove git 3、從github

GitHub鉤子同步專案程式碼到網站目錄

   對於個人專案而言,有的人專案託管在github上,線上訪問地址放在自有伺服器上。    平時自己開發的話,要先push到github,在到自己伺服器上pull下來(伺服器上裝了git),特別麻煩。

【iOS開發】---- 手把手教github託管程式碼

       在csdn上還有一篇介紹如何使用github託管程式碼的: 兩分鐘學會在GitHub託管程式碼。我照著這個教程嘗試了一遍,發現程式碼並沒有託管上去,只是建立了一個存放程式碼的倉庫(re

github專案程式碼託管平臺學習記錄

github網站學習記錄1.相關概念倉庫(Repository)倉庫用來存放專案程式碼,每個專案對應一個倉庫,多個開源專案則有多個倉庫收藏(Star)收藏專案,方便下次檢視複製克隆專案(Fork)腳下留心:該fork的專案時獨立存在的發起請求(Pull Request)關注(

使用git上傳專案程式碼github

如果一個人沒有github,都不好意思說自己是碼農,github作為一個開源的程式碼倉庫管理平臺,對程式碼的管理確實很方便 其次我們在GitHub,可以十分輕易地找到海量的開原始碼,是不是很開心 1、註冊Github賬號,註冊地址:https://github.com/join?s

window端GitHub託管程式碼

一些前期配置見部落格 點選開啟連結 1、下載GitHub的bash和Windows desk版本,在使用者目錄下生成自己的公鑰.pub cd ~ ssh-keygen -t rsa  一直enter 2、

使用git將專案程式碼上傳到github流程

用git將專案程式碼上傳到github流程   先上常用語句 git add . git commit -m "img commit" $ git pull $ git push -u or

github新建專案及上傳本地專案程式碼

本文章講解內容為github建立新專案並上傳本地已有專案程式碼 一.在github上新建倉庫 登入github後進入首頁點選“New repository”按鈕開始建立新倉庫,首頁如下: 2.點選後進入“Create a new repository”頁面,輸入專案名比

7個Python實戰專案程式碼,讓分分鐘晉級大神!

關於Python有一句名言:不要重複造輪子。 但是問題有三個: 1、你不知道已經有哪些輪子已經造好了,哪個適合你用。有名有姓的的著名輪子就400多個,更別說沒名沒姓自己在製造中的輪子。 2、確實沒重複造輪子,但是在重複製造汽車。包括好多大神寫的好幾百行程式碼,為的是

通過Git管理GitHub託管程式碼

安裝成功後.滑鼠桌面右擊,顯示 建立並配置本地管理程式碼倉庫 選擇作為倉庫的資料夾 滑鼠右擊,選擇git Bash Here,開啟指令面板 1.初始化本地倉庫 輸入指令 $ git init 此時出現 .git 隱藏檔案 則表示建立倉庫成功 2.配

Mac Git 學習教程 之 本地專案程式碼上傳到GitHub

在終端上輸入命令,拉一下遠端的程式碼,如出現報錯“fatal: refusing to merge unrelated histories”,只需要在該命令列新增允許即可“--allow-unrelated-histories”,然後跳出文件說明,退出即可,具體如下圖

Git的使用之提交本地專案程式碼GitHub

一、前提條件 下載Git工具(下載地址:https://git-scm.com/downloads) 註冊GitHub賬號(GitHub官網 https://github.com/)   二、相關命令 將遠端版本庫的檔案克隆到本地專案中

Git 遠端倉庫(Github) Git 並不像 SVN 那樣有個中心伺服器。 目前我們使用到的 Git 命令都是在本地執行,如果想通過 Git 分享程式碼或者與其他開發人員合作。 就需要

Git 遠端倉庫(Github) Git 並不像 SVN 那樣有個中心伺服器。 目前我們使用到的 Git 命令都是在本地執行,如果你想通過 Git 分享你的程式碼或者與其他開發人員合作。你就需要將資料放到一臺其他開發人員能夠連線的伺服器上。 本例使用了 Github 作為遠端倉庫,你可以先閱讀我們的 G

閱讀Python開源專案程式碼

作者:董偉明 連結:https://zhuanlan.zhihu.com/p/22275595 來源:知乎 著作權歸作者所有。商業轉載請聯絡作者獲得授權,非商業轉載請註明出處。注:本專欄文章未經允許請勿轉載。 知乎上有不少人問和關注閱讀開源專案程式碼這個問題,比如「初學 Python,有哪些 Pythonic

如何使用Git上傳專案程式碼github

配置Git 我們先在電腦硬盤裡找一塊地方存放本地倉庫,比如我們把本地倉庫建立在C:\MyRepository\1ke_test資料夾下 進入1ke_test資料夾 滑鼠右鍵操作如下步驟: 1)在本地倉庫裡右鍵選擇Git Init Here,會多出來一個.git資料夾,這就表示本地git建立成功。右

windows環境下使用git客戶端、GitHub和TortoiseGit管理專案程式碼

最後更新於2017年01月24日 一、為什麼   為什麼不用svn? svn是一個優秀的程式碼和版本管理工具,使用svn只需要搭建好svn中央倉庫,配置本地svn客戶端即可,自從google code關閉服務之後,網際網路上已經沒有非常好的公共svn倉庫,如果是公司內部使用,還可以用上公司內網搭建的sv

使用Git上傳專案程式碼github(超詳細)

如何使用Git上傳專案程式碼到github github是一個基於git的程式碼託管平臺,付費使用者可以建私人倉庫,我們一般的免費使用者只能使用公共倉庫,也就是程式碼要公開。這對於一般人來說公共倉庫就已經足夠了。 註冊賬戶以及建立倉庫 要想使用gi

用gitbash將專案程式碼上傳到GitHub

配置Git 我們先在電腦硬盤裡找一塊地方存放本地倉庫,比如我們把本地倉庫建立在C:\MyRepository\1ke_test資料夾下 進入1ke_test資料夾 滑鼠右鍵操作如下步驟: 1)在本地倉庫裡右鍵選擇Git Init Here,會多出來一個.git資料夾,這就表示本地git建立成功。右

使用github託管專案

Git是一個分散式的版本控制系統,最初由Linus Torvalds編寫,用作Linux核心程式碼的管理。在推出後,Git在其它專案中也取得了很大成功,尤其是在Ruby社群中。目前,包括Rubinius、Merb和Bitcoin在內的很多知名專案都使用了Git。Git同樣