使用github pages搭建個人博客
一伊群、環(huán)境準(zhǔn)備
使用Github Pages搭建個人博客,一勞永逸,可以讓我們更加專注于博客的撰寫氨距。博客的更新是通過將新建或改動的博客放在指定文件夾并推送到遠(yuǎn)程Github倉庫來完成的揭糕,所以我們本地需要有Git環(huán)境赚导,如果還沒有安裝Git尚粘,可以看下面的文章:
二、搭建博客
1蝇庭、新建倉庫
以username.github.io
作為倉庫名字醉鳖。
2、本地克隆
本地創(chuàng)建文件夾哮内,用于存放遠(yuǎn)程倉庫盗棵,打開所創(chuàng)建的文件夾,右鍵選擇git bash here
北发,表示在當(dāng)前目錄打開git bash
程序纹因,然后執(zhí)行如下命令,將剛才創(chuàng)建的倉庫克隆到本地:
git clone https://github.com/AmazingChen/amazingchen.github.io.git
如果步驟1
中創(chuàng)建倉庫時琳拨,沒有勾選Initialize this repository with a README
瞭恰,將有如下提示:
warning,可以忽略狱庇,或手動在遠(yuǎn)程倉庫創(chuàng)建一個readme.md
惊畏,然后重新clone
。
3密任、新建主頁
在倉庫文件夾下創(chuàng)建index.html
:
<!DOCTYPE html>
<html>
<head>
</head>
<body>
<p>hello, my first page!</p>
</body>
</html
4陕截、推送到遠(yuǎn)程倉庫
在倉庫文件夾下,右鍵選擇git bash here
批什,然后執(zhí)行命令:
git add --all
git commit -m "add index.html"
git push origin master
5、驗證
成功push到遠(yuǎn)程倉庫后社搅,訪問 username.github.io
驻债,看到如下界面,就表示成功通過Github Pages搭建了個人的博客形葬。
三合呐、更換主題
上面裸奔的博客主頁,跟原始人類一樣笙以,你一定不滿意淌实,我們穿越幾千年文明,直接站在巨人的肩膀上,選一套主題吧拆祈。
Github Pages基于Jekyll構(gòu)建恨闪,Jekyll 可以幫助我們把純文本轉(zhuǎn)換為靜態(tài)博客網(wǎng)站,實現(xiàn)一勞永逸放坏。
你可以在JekyllThemes找到喜歡的主題咙咽,也可以在其他地方找。
"I want you, Vno-Jekyll." 我選擇Vno淤年。
1钧敞、下載主題
下載后,首先將我們倉庫文件夾下的文件清空麸粮,但是要保留.git
文件夾:
然后將下載的主題壓縮包解壓到倉庫文件夾下溉苛,結(jié)果如下:
訪問 Jekyll-目錄結(jié)構(gòu) 詳細(xì)了解每個文件夾的功能:
.
├── _config.yml
├── _drafts
| ├── begin-with-the-crazy-ideas.textile
| └── on-simplicity-in-technology.markdown
├── _includes
| ├── footer.html
| └── header.html
├── _layouts
| ├── default.html
| └── post.html
├── _posts
| ├── 2007-10-29-why-every-programmer-should-play-nethack.textile
| └── 2009-04-26-barcamp-boston-4-roundup.textile
├── _site
├── .jekyll-metadata
└── index.html
2、搭建Jekyll環(huán)境
只有主題文件是不夠的弄诲,我們需要搭建Jekyll環(huán)境愚战,通過遵循Jekyll的規(guī)范,讓Jekyll幫助我們生成靜態(tài)網(wǎng)站威根。
(1) 安裝Ruby:Ruby安裝教程
(2)打開CMD凤巨,執(zhí)行命令安裝Jekyll:
gem install jekyll
(3)進(jìn)入倉庫文件夾,執(zhí)行命令:
bundle install
注意洛搀,必須進(jìn)入倉庫文件夾下再執(zhí)行上述命令敢茁,否則會有如下提示,表示bundle找不到gemfile文件:
Rails 3中引入Bundle來管理項目中的所有Gem依賴留美,該命令只能在一個含有Gemfile的目錄下執(zhí)行彰檬,
bundle install
命令將嘗試更新系統(tǒng)中已存在的gem包。更多參考:bundle install 命令
(4)啟動Jekyll服務(wù)
bundle exec jekyll serve
啟動Jekyll服務(wù)時谎砾,可能會遇到如下錯誤:
Conversion error: Jekyll::Converters::Scss encountered an error
while converting 'css/main.scss':
Invalid GBK character "\xE2" on line 10
jekyll 3.4.0 | Error: Invalid GBK character "\xE2" on line 10
很明顯逢倍,是編碼問題,參考網(wǎng)上方法解決 Invalid GBK character "\xE2" 過程中的發(fā)現(xiàn)景图,找到D:\RailsInstaller\Ruby2.3.3\lib\ruby\gems\2.3.0\gems\sass-3.7.2\lib\sass.rb
文件较雕,在require后
追加:
Encoding.default_external = Encoding.find('utf-8')
然后重新啟動Jekyll服務(wù),看到如下打印挚币,表示啟動成功:
(5)驗證
訪問 http://127.0.0.1:4000
亮蒋,當(dāng)你發(fā)現(xiàn)你的博客首頁從一個原始人變成光鮮亮麗的現(xiàn)代人時,表示博客主題已經(jīng)應(yīng)用成功了妆毕。
(6)推送到遠(yuǎn)程倉庫
做完上述操作后慎玖,由于還沒有將修改提交到遠(yuǎn)程倉庫,所以當(dāng)你訪問username.github.io
時笛粘,你看到的還是一個光溜溜的原始人趁怔,執(zhí)行以下命令完成進(jìn)化吧皮卡丘:
git add .
git commit -m "apply theme"
git push origin master
成功推送到遠(yuǎn)程倉庫后湿硝,等待幾分鐘,訪問username.github.io
润努,OK关斜,成功。天黑請閉眼任连,有問題請留言蚤吹。
四、發(fā)布博客
在倉庫文件夾下随抠,進(jìn)入_posts
目錄裁着,所有的文章都必須放在_posts
文件夾下,訪問 Jekyll-目錄結(jié)構(gòu) 詳細(xì)了解每個文件夾的功能拱她。
以markdown文檔為例二驰,按照如下格式創(chuàng)建md文件。
yyyy-MM-dd-filename.md
完成后push到遠(yuǎn)程倉庫秉沼,即可完成更新桶雀。
五、修改主題
將網(wǎng)站的信息改成自己的唬复,修改_config.yml
文件:
# Basic
title: 陳賢靖
subtitle: 井與陸地矗积,海和島嶼。
description: Android Developer.
creator: <a >@onevcat</a>
url: "https://amazingchen.github.io/#blog"
permalink: /:year/:month/:title/
# Format
highlighter: rouge
# supported colors: blue, green, purple, red, orange or slate. If you need clear, leave it empty.
# cover_color: red
# The blog button should not be removed.
blog_button:
title: Blog
description: Visit blog
# Navigation buttons in the front page.
nav:
- {title: Projects, description: My Projects, url: 'https://github.com/AmazingChen/VHabit'}
# - {title: Another Button, description: A button, url: 'http://example.com'}
# Pagination
plugins: [jekyll-paginate]
paginate: 10
paginate_path: "page/:num/"
# Comment
comment:
disqus: vno-jekyll
# duoshuo:
# Social
social:
github: AmazingChen
mail: shixianjingla@gmail.com
# Google Analytics
ga:
# id: your_ga_id
# host: your_host
如果你對這套主題不太滿意敞咧,并且具備web基礎(chǔ)棘捣,可以動手修改。
如果不想博客數(shù)據(jù)被人輕易獲取休建,建議將github倉庫設(shè)置為私有乍恐。
修改之后,我的博客長這樣:陳賢靖
完测砂。