目錄
- 引言
- 關(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ō)明:
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è):
然后好像要郵箱驗(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:
填好信息
創(chuàng)建完成
到這里就創(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ò)這一步,到后面的步驟選擇喜歡的主題
配置Github Pages功能
然后我們來(lái)配置github pages
重命名疮丛,注意格式
把上面的頁(yè)面向下滑幔嫂,現(xiàn)在就可以訪問(wèn)了
當(dāng)然github也提供了一些主題供選擇,點(diǎn)擊上面的“choose a theme”按鈕進(jìn)行選擇
這個(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è)文件:
id_rsa.pub
就是我們待會(huì)需要的公鑰文件,使用命令 cat id_rsa.pub
再將內(nèi)容復(fù)制到剪切板子刮,然后進(jìn)入github賬號(hào)設(shè)置里面粘貼
選擇添加SSH key:
把剛才復(fù)制的內(nèi)容粘貼進(jìn)去
然后輸入 ssh -T git@github.com
測(cè)試連通狀態(tài)
我的Windows版沒(méi)有成功威酒,不知道Linux是否成功,報(bào)錯(cuò)如下 挺峡,應(yīng)該是windows ssh配置問(wèn)題
git Desktop版
如果你也出現(xiàn)以上狀況葵孤,不必?fù)?dān)心,git還能使用https協(xié)議連接橱赠,只不過(guò)要每次輸入賬號(hào)和密碼尤仍,但是可以選擇github官方提供的git desktop軟件:
這里我是下載過(guò)的
界面如下,需要登錄狭姨,以后提交文件就方便了宰啦,cmd也能使用git提交,不用每次輸入密碼
可以查看變化文件饼拍,甚至文件內(nèi)變化的內(nèi)容赡模,commit 后點(diǎn)擊 fetch 按鈕提交
軟件功能不算復(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ù)一樣穆刻。
綁定遠(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)題:
* 使用
bundle exec jekyll s
命令就可以運(yùn)行了颜说,如果提示沒(méi)有安裝bundler
西轩,就gem install bundler
再bundle install
* 可能還會(huì)提示沒(méi)有安裝其他組件,記下名稱脑沿,
gem install xxx
就可以了
然后就可以成功運(yùn)行了,退出按 ctrl + c
鍵
* 運(yùn)行時(shí)保持這個(gè)窗口不要關(guān)閉马僻,瀏覽器輸入
127.0.0.1:4000
或localhost: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)單介紹一些使用:
安裝后主界面:
添加賬號(hào)
配置 token
保存后會(huì)生成一個(gè) token ,返回軟件粘貼進(jìn)輸入框就行了
寫完后保存并上傳
可以在這里查看和修改賬戶下的博客
軟件其他功能還在完善熬拒,自行摸索
圖床介紹
寫博客就無(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中配置一下:
當(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>
width
和 height
添加想要的尺寸粉怕。
域名配置
自己的博客網(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è)鏈接提交功能赏廓,但是它只是加速爬取,并未解決收錄:
貌似它們的熊掌號(hào)服務(wù)可以解決這問(wèn)題:
然后傍妒,就沒(méi)有然后了 -_-
以花生殼域名為例楚昭,其它大同小異,配置一下:
再添加兩條 github 的ip的 A記錄值 :192.30.252.153
192.30.252.154
最后搜索:
"site:你的域名"
有結(jié)果就成功了
開始自己的博客生涯吧拍顷。