搭建Github Pages個(gè)人博客網(wǎng)站

目錄

  • 引言
    • 關(guān)于博客
    • 關(guān)于Github
  • 創(chuàng)建Github賬號(hào)
  • 創(chuàng)建倉(cāng)庫(kù)
    • 填充倉(cāng)庫(kù)
    • 配置Github Pages功能
  • 博客的書寫與上傳
    • Git基礎(chǔ)
    • git配置
    • git Desktop版
  • 創(chuàng)建本地倉(cāng)庫(kù)
  • 安裝Jekyll
    • 關(guān)于Jekyll
    • 安裝步驟
    • 開啟jekyll
  • 寫博客與上傳
    • Markdown基礎(chǔ)
    • 工具介紹
    • 圖床介紹
    • 關(guān)于圖片尺寸
  • 域名配置

引言

關(guān)于博客

寫博客對(duì)于程序猿來(lái)說(shuō)州弟,應(yīng)該是個(gè)優(yōu)秀的習(xí)慣钧栖,個(gè)人也覺(jué)得蠻高大上的 _。網(wǎng)上的博客論壇網(wǎng)站也多種多樣婆翔,個(gè)人覺(jué)得在長(zhǎng)久以來(lái)的不斷競(jìng)爭(zhēng)淘汰中拯杠,各大網(wǎng)站的功能等可能都相差無(wú)幾了,選擇自己稍微偏好的就可以了浙滤。

我的個(gè)人情況就是結(jié)合CSDN博客和Github Pages的獨(dú)立個(gè)人博客網(wǎng)頁(yè)阴挣,因?yàn)槁犝f(shuō)擁有自己的Github主頁(yè)也是一件蠻高大上的事 -_- 。

關(guān)于Github

然后簡(jiǎn)單介紹一下Github以及其Github Pages功能纺腊。

GitHub是一個(gè)面向開源及私有軟件項(xiàng)目的托管平臺(tái)畔咧,也是一個(gè)分布式版本控制系統(tǒng),詳情見(jiàn)百度百科揖膜。說(shuō)到分布式誓沸,自然也有另外一種集中式版本控制系統(tǒng):SVN,有興趣小伙伴可以了解百度百科壹粟。GIt是SVN的發(fā)展版拜隧,而且現(xiàn)在主流也是GIt,但某些大公司依然在使用SVN趁仙,二者各有優(yōu)劣洪添,自行體會(huì),此處不做詳解雀费,用一張圖簡(jiǎn)單說(shuō)明:


20180331184953574.png

GIthub Pages則是github上的一項(xiàng)功能干奢,可以放置網(wǎng)頁(yè)文件到指定文件夾,然后給你一個(gè)專屬域名用于展示一些項(xiàng)目盏袄,但現(xiàn)在大多用來(lái)開發(fā)制作個(gè)人博客網(wǎng)站忿峻。接下來(lái)就一步步按照我曾經(jīng)的步驟來(lái)搭建個(gè)人博客薄啥,順便講講沿途遇到過(guò)的坑,如沒(méi)有的提及請(qǐng)自行百度逛尚。

創(chuàng)建Github賬號(hào)

github pages 功能依賴于github賬號(hào)垄惧,沒(méi)有的話先去官網(wǎng)注冊(cè)一個(gè):

20180331192629516.jpg

然后好像要郵箱驗(yàn)證,就是填寫的那個(gè)绰寞,點(diǎn)擊那個(gè)驗(yàn)證鏈接就注冊(cè)成功了到逊。

創(chuàng)建倉(cāng)庫(kù)

有了自己的賬號(hào)后,可以跟著官網(wǎng)的引導(dǎo)滤钱,創(chuàng)建自己的第一個(gè)倉(cāng)庫(kù)蕾管,就是 repository

20180331193717261.jpg


填好信息


20180331195826465.jpg

創(chuàng)建完成


20180331200133497.jpg

到這里就創(chuàng)建好了自己的倉(cāng)庫(kù),可以上傳文件到這個(gè)目錄下菩暗,接下我們用這個(gè)倉(cāng)庫(kù)來(lái)使用github pages功能。

填充倉(cāng)庫(kù)

倉(cāng)庫(kù)建好了旭蠕,接下來(lái)就是往里面裝東西了停团,就是支撐博客首頁(yè)的一些網(wǎng)頁(yè)文件和配置文件,對(duì)于新手來(lái)說(shuō)要自己編寫這些文件就有點(diǎn)開玩笑了掏熬,所以可以選擇使用已有的主題佑稠,你可以選擇復(fù)制我的https://github.com/knightyun/knightyun.github.io,然后選擇自己倉(cāng)庫(kù)旗芬,網(wǎng)頁(yè)基礎(chǔ)好的同學(xué)以后修改網(wǎng)頁(yè)內(nèi)容就行了舌胶。

嫌修改麻煩可以跳過(guò)這一步,到后面的步驟選擇喜歡的主題
20180331204755801.jpg

配置Github Pages功能

然后我們來(lái)配置github pages

20180331200909318.jpg

重命名疮丛,注意格式


20180331202913817.jpg

把上面的頁(yè)面向下滑幔嫂,現(xiàn)在就可以訪問(wèn)了


20180331203510375.jpg

當(dāng)然github也提供了一些主題供選擇,點(diǎn)擊上面的“choose a theme”按鈕進(jìn)行選擇


20180331205610766.jpg

這個(gè)網(wǎng)站有更多主題工選擇:誊薄,如有選擇困難癥請(qǐng)繞路 -_-

博客的書寫與上傳

Git基礎(chǔ)

前面說(shuō)到向自己的github倉(cāng)庫(kù)上傳文件履恩,我們使用“git”這個(gè)工具,進(jìn)行拉取呢蔫、克隆切心、提交等一系列操作,Linux系統(tǒng)應(yīng)該是自帶片吊,官網(wǎng)下載地址:https://git-scm.com/绽昏。
并且需要掌握一些git基本操作,如 git commit , git push, git clone 等俏脊,這里有很完整的教程:Git語(yǔ)法說(shuō)明.

git配置

  • 安裝好后cmd輸入 git 有反應(yīng)則安裝成功:

    20180331215746907.jpg

  • 進(jìn)行如下配置:

git config --global user.name "YOUR NAME"
git config --global user.email "YOUR EMAIL ADDRESS"
NAME指你的昵稱全谤,EMAIL ADDRESS是你的注冊(cè)郵箱
  • 然后生成相應(yīng)的令牌,本地一份联予,Github 一份啼县,這樣 Github 可以在你使用倉(cāng)庫(kù)的時(shí)候材原,進(jìn)行校驗(yàn)確定你的身份。
cd ~/.ssh
mkdir key_backup
ssh-keygen -t rsa -C "*your_email@youremail.com*"
注意這里不是在cmd里輸入季眷,是使用剛安裝的 git bash 軟件余蟹,可以在電腦菜單里面搜索

然后會(huì)生成如下兩個(gè)文件:


20180331221012285.jpg

id_rsa.pub 就是我們待會(huì)需要的公鑰文件,使用命令 cat id_rsa.pub 再將內(nèi)容復(fù)制到剪切板子刮,然后進(jìn)入github賬號(hào)設(shè)置里面粘貼

20180331221601652.jpg

選擇添加SSH key:


20180331221949179.jpg

把剛才復(fù)制的內(nèi)容粘貼進(jìn)去


20180331222325449.jpg

然后輸入 ssh -T git@github.com 測(cè)試連通狀態(tài)

我的Windows版沒(méi)有成功威酒,不知道Linux是否成功,報(bào)錯(cuò)如下 挺峡,應(yīng)該是windows ssh配置問(wèn)題
20180331222821644.jpg

git Desktop版

如果你也出現(xiàn)以上狀況葵孤,不必?fù)?dān)心,git還能使用https協(xié)議連接橱赠,只不過(guò)要每次輸入賬號(hào)和密碼尤仍,但是可以選擇github官方提供的git desktop軟件:

這里我是下載過(guò)的

20180331223500277.jpg

界面如下,需要登錄狭姨,以后提交文件就方便了宰啦,cmd也能使用git提交,不用每次輸入密碼


20180331223916609.jpg

可以查看變化文件饼拍,甚至文件內(nèi)變化的內(nèi)容赡模,commit 后點(diǎn)擊 fetch 按鈕提交


20180401085504366.jpg
軟件功能不算復(fù)雜,自己摸索一會(huì)就會(huì)了师抄,圖形界面的軟件使得一些命令行的操作變得容易漓柑、友好。

創(chuàng)建本地倉(cāng)庫(kù)

選擇一個(gè)本地文件夾叨吮,用作保存本地倉(cāng)庫(kù)文件辆布,盡量是空文件夾,然后使用命令 git init 初始化文件夾茶鉴,其實(shí)是在當(dāng)前文件夾下生成一個(gè)叫 .git 的隱藏文件夾谚殊,里面是一些配置文件,不要隨意更改蛤铜。

使用 git clone https://github.com/name/repository.git 將遠(yuǎn)程倉(cāng)庫(kù)克隆到本地此文件夾下嫩絮,
name 是自己的昵稱,repository 是自己的倉(cāng)庫(kù)名围肥,不要忘記末尾的 .git 后綴剿干。

然后此文件夾下會(huì)多一個(gè)和你倉(cāng)儲(chǔ)名一樣的文件夾,內(nèi)部文件與遠(yuǎn)程倉(cāng)庫(kù)一樣穆刻。


20180331230145814.jpg

綁定遠(yuǎn)程倉(cāng)庫(kù)置尔,方便提交:

git remote add origin git@github.com:username/username.github.io.git

介紹幾個(gè)常用命令:

git add . //添加文件
git commit -m "commit-messages" //提交本地倉(cāng)庫(kù)
git push origin master //提交遠(yuǎn)程倉(cāng)庫(kù)
git pull //拉取遠(yuǎn)程文件,與以下命令類似
git branch temp //創(chuàng)建本地分支
git fetch origin master:temp
git merge master

安裝Jekyll

關(guān)于Jekyll

Jekyll是一個(gè)簡(jiǎn)單免費(fèi)的生成博客網(wǎng)頁(yè)的工具氢伟,可以綁定github榜轿,詳情參考官網(wǎng):https://jekyllrb.com/, 也有一個(gè)中文版的:https://www.jekyll.com.cn/ 方便閱讀幽歼。我的博客就是通過(guò)jekyll建立了,上面那個(gè)主題網(wǎng)站也是jekyll的谬盐,還有一個(gè)類似的工具叫“hexo”甸私,自行了解。

上傳修改后的文件到github倉(cāng)庫(kù)后需要一段時(shí)間才能看到網(wǎng)頁(yè)的變化或修改效果飞傀,所以可以選擇安裝本地jekyll工具進(jìn)行本地快速預(yù)覽皇型。

安裝步驟

  • 安裝Ruby:jekyll依賴于Ruby,需要提前安裝砸烦,官網(wǎng)下載鏈接:http://www.ruby-lang.org/en/downloads/弃鸦,windows/Linux/Mac的版本都有。
  • 安裝gem:官網(wǎng)鏈接https://rubygems.org/pages/download幢痘,貌似安裝ruby后自帶gem唬格。
    cmd命令行輸入 gem 檢查是否安裝成功:
    20180331213445607.jpg
  • 安裝jekyll:cmd命令行輸入 gem install jekyll
    20180331213739704.jpg

開啟jekyll

直接輸入 jekyll s 開啟jekyll服務(wù),windows可能會(huì)遇到以下問(wèn)題:

20180401085818819.jpg

* 使用 bundle exec jekyll s 命令就可以運(yùn)行了颜说,如果提示沒(méi)有安裝 bundler 西轩,就 gem install bundlerbundle install
* 可能還會(huì)提示沒(méi)有安裝其他組件,記下名稱脑沿, gem install xxx 就可以了

然后就可以成功運(yùn)行了,退出按 ctrl + c

20180401085938699.jpg

* 運(yùn)行時(shí)保持這個(gè)窗口不要關(guān)閉马僻,瀏覽器輸入 127.0.0.1:4000localhost:4000 進(jìn)行預(yù)覽
* 不過(guò)我的windows預(yù)覽效果不太好庄拇,加載不出圖片,其他系統(tǒng)沒(méi)試過(guò)

寫博客與上傳

Markdown基礎(chǔ)

Jekyll使用Markdown語(yǔ)言書寫博客韭邓,markdown是一種簡(jiǎn)單易讀的標(biāo)記性語(yǔ)言措近,不同于 html,大量的標(biāo)簽不易于閱讀女淑,寫著也麻煩瞭郑,用markdown寫博客很合適。

首先你需要了解一些markdown語(yǔ)法鸭你,這里有完整版語(yǔ)法說(shuō)明:Markdown語(yǔ)法說(shuō)明屈张,了解一些基礎(chǔ)后就可以開始寫博客了。

工具介紹

這篇文章:Markdown簡(jiǎn)明語(yǔ)法最后有介紹一些好用的markdown編輯器袱巨,自行選擇阁谆。
不過(guò)每次都用編輯器寫好 .md 文件然后用 git 上傳到 github 根目錄下的 _post 文件夾好像很繁瑣,Jekyll官方提供了一款方便的博客編輯器愉老,方便書寫场绿、預(yù)覽、上傳嫉入,官網(wǎng)鏈接:http://jekyllwriter.com/焰盗,三種系統(tǒng)版本都有璧尸。接下來(lái)簡(jiǎn)單介紹一些使用:

安裝后主界面:


20180401093410604.jpg

添加賬號(hào)


20180401093825352.jpg

配置 token


20180401094705731.jpg

保存后會(huì)生成一個(gè) token ,返回軟件粘貼進(jìn)輸入框就行了


20180401094911796.jpg

寫完后保存并上傳


20180401094200638.jpg

可以在這里查看和修改賬戶下的博客


2018040109525674.jpg

20180401095443179.jpg
軟件其他功能還在完善熬拒,自行摸索

圖床介紹

寫博客就無(wú)法避免上傳圖片爷光,圖床就是這么一個(gè)地方,就是一個(gè)網(wǎng)站梦湘,你發(fā)自己的圖片上傳到它的網(wǎng)站瞎颗,然后它給你一個(gè)這個(gè)圖片的鏈接,插入博客中就能顯示圖片了捌议。

推薦一個(gè)知名的哼拔,七牛云https://portal.qiniu.com/,注冊(cè)完實(shí)名認(rèn)證后有一些優(yōu)惠瓣颅。
還有一個(gè)神奇的網(wǎng)站:https://sm.ms/倦逐,也能用

然后在 jekyll writer中配置一下:


20180401100517435.jpg

當(dāng)然我用的是CSDN在線編輯器寫博客,圖片能直接上傳到CSDN上宫补,直接生成鏈接檬姥,其工具也能用

關(guān)于圖片尺寸

markdown的圖片插入方式 [圖片上傳失敗...(image-641b32-1549111233207)] 是沒(méi)辦法修改圖片尺寸的,可以使用html中的 <img>標(biāo)簽:
<img src="http://xxx.com/xxx.png/" alt="title" width=XXpx height=XXpx>
widthheight 添加想要的尺寸粉怕。

域名配置

自己的博客網(wǎng)站就建好了健民,想要分享出去的小伙伴就要想辦法讓自己的網(wǎng)頁(yè)能被百度等搜索引擎搜到,或者這樣贫贝,百度搜索: site:name.github.io 秉犹,出現(xiàn)錯(cuò)誤頁(yè)面就表示搜不到。

很遺憾稚晚,百度是禁止抓取 github pages 的內(nèi)容的崇堵,可以購(gòu)買一個(gè)自己的專屬域名,有很多選擇客燕,阿里云鸳劳、騰訊、花生殼域名等也搓,百度站長(zhǎng)平臺(tái)有個(gè)鏈接提交功能赏廓,但是它只是加速爬取,并未解決收錄:


20180401103839442.jpg

貌似它們的熊掌號(hào)服務(wù)可以解決這問(wèn)題:


20180401104100873.jpg

然后傍妒,就沒(méi)有然后了 -_-


20180401104147731.jpg

以花生殼域名為例楚昭,其它大同小異,配置一下:


20180401102926509.jpg

再添加兩條 github 的ip的 A記錄值 :192.30.252.153 192.30.252.154

最后搜索: "site:你的域名" 有結(jié)果就成功了

開始自己的博客生涯吧拍顷。


最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末抚太,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子电媳,更是在濱河造成了極大的恐慌,老刑警劉巖匾乓,帶你破解...
    沈念sama閱讀 222,807評(píng)論 6 518
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件又谋,死亡現(xiàn)場(chǎng)離奇詭異拼缝,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)彰亥,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 95,284評(píng)論 3 399
  • 文/潘曉璐 我一進(jìn)店門咧七,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人任斋,你說(shuō)我怎么就攤上這事继阻。” “怎么了废酷?”我有些...
    開封第一講書人閱讀 169,589評(píng)論 0 363
  • 文/不壞的土叔 我叫張陵瘟檩,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我澈蟆,道長(zhǎng)墨辛,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 60,188評(píng)論 1 300
  • 正文 為了忘掉前任趴俘,我火速辦了婚禮睹簇,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘哮幢。我一直安慰自己,他們只是感情好志珍,可當(dāng)我...
    茶點(diǎn)故事閱讀 69,185評(píng)論 6 398
  • 文/花漫 我一把揭開白布橙垢。 她就那樣靜靜地躺著,像睡著了一般伦糯。 火紅的嫁衣襯著肌膚如雪柜某。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 52,785評(píng)論 1 314
  • 那天敛纲,我揣著相機(jī)與錄音喂击,去河邊找鬼。 笑死禽捆,一個(gè)胖子當(dāng)著我的面吹牛琉预,可吹牛的內(nèi)容都是我干的箭养。 我是一名探鬼主播监嗜,決...
    沈念sama閱讀 41,220評(píng)論 3 423
  • 文/蒼蘭香墨 我猛地睜開眼裁奇,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來(lái)了溃肪?” 一聲冷哼從身側(cè)響起惫撰,我...
    開封第一講書人閱讀 40,167評(píng)論 0 277
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤润绎,失蹤者是張志新(化名)和其女友劉穎莉撇,沒(méi)想到半個(gè)月后棍郎,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體涂佃,經(jīng)...
    沈念sama閱讀 46,698評(píng)論 1 320
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡辜荠,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 38,767評(píng)論 3 343
  • 正文 我和宋清朗相戀三年伯病,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了午笛。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片药磺。...
    茶點(diǎn)故事閱讀 40,912評(píng)論 1 353
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡癌佩,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出驼卖,到底是詐尸還是另有隱情酌畜,我是刑警寧澤,帶...
    沈念sama閱讀 36,572評(píng)論 5 351
  • 正文 年R本政府宣布恳守,位于F島的核電站催烘,受9級(jí)特大地震影響伊群,放射性物質(zhì)發(fā)生泄漏舰始。R本人自食惡果不足惜咽袜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 42,254評(píng)論 3 336
  • 文/蒙蒙 一询刹、第九天 我趴在偏房一處隱蔽的房頂上張望凹联。 院中可真熱鬧,春花似錦住闯、人聲如沸象泵。這莊子的主人今日做“春日...
    開封第一講書人閱讀 32,746評(píng)論 0 25
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)兄一。三九已至,卻和暖如春造壮,著一層夾襖步出監(jiān)牢的瞬間耳璧,已是汗流浹背旨枯。 一陣腳步聲響...
    開封第一講書人閱讀 33,859評(píng)論 1 274
  • 我被黑心中介騙來(lái)泰國(guó)打工攀隔, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留栖榨,地道東北人治泥。 一個(gè)月前我還...
    沈念sama閱讀 49,359評(píng)論 3 379
  • 正文 我出身青樓居夹,卻偏偏與公主長(zhǎng)得像准脂,于是被迫代替她去往敵國(guó)和親狸膏。 傳聞我的和親對(duì)象是個(gè)殘疾皇子湾戳,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,922評(píng)論 2 361

推薦閱讀更多精彩內(nèi)容