倒騰了好久才用hexo加github搭建好屬于自己的博客沥潭,好激動(dòng),為此寫(xiě)篇博客記錄一下嬉挡。
要使用hexo的話(huà)钝鸽,需在你的系統(tǒng)中支持node.js和git。
安裝node.js
安裝git
安裝Hexo
1. $ npm install -g hexo-cli //全局安裝hexo-cli
2. $ hexo init my-blog //創(chuàng)建一個(gè)hexo框架
3. $ cd my-blog //進(jìn)入目錄
4. $ npm install //安裝依賴(lài)包
5. $ hexo generate //生成靜態(tài)文件
6. $ hexo server //啟動(dòng)本地服務(wù)庞钢,可以通過(guò)http://locallhost:4000/ 訪問(wèn)
特別提示:
a. hexo generate(可以簡(jiǎn)寫(xiě)成 hexo g)生成靜態(tài)文件拔恰,會(huì)在當(dāng)前目錄下生成一個(gè)新的為public的文件夾。
b. hexo server (可以簡(jiǎn)寫(xiě)成hexo s)啟動(dòng)本地web服務(wù)基括,可以在本地預(yù)覽博客颜懊。
c. hexo deploy(可以簡(jiǎn)寫(xiě)成hexo d)部署博客到遠(yuǎn)程(如github)。
d. hexo new post-name(可簡(jiǎn)寫(xiě)成hexo n post-name,新建文章)
e. hexo new page page-name(可簡(jiǎn)寫(xiě)成hexo n page page-name,新建頁(yè)面)
常用組合命令:
a. hexo d -g (生成和部署)
b. hexo s -g (生成和預(yù)覽)
新建完成后风皿,指定文件夾的目錄如下:
|—— _config.yml // 網(wǎng)站的配置信息
|—— package.json // 項(xiàng)目包信息
|—— scaffolds // 模板文件夾河爹,Hexo根據(jù)scaffold中的模板來(lái)新建文件
|—— source // 存放用戶(hù)資源的地方
| |—— _drafts // 存放草稿
| |—— _posts // 存放文章
|—— themes // 主題文件夾
_config.yml
網(wǎng)站的配置信息,可以在此配置大部分的參數(shù)桐款。
例如:
到這里咸这,你就可以用四步驟在本地預(yù)覽到自己的博客了:
1.把markdown文章放到_posts文件夾。
2. $ hexo clean //清除緩存文件db.json和已生成的靜態(tài)文件public.
3. $hexo g //生成靜態(tài)文件魔眨,存放到當(dāng)前一個(gè)新生成文件夾public里面媳维。
4. $hexo s //用瀏覽器訪問(wèn)http://localhost:4000,就可以在本地預(yù)覽到自己的博客。
發(fā)布到github上面
打開(kāi)你的github創(chuàng)建repository
repository相當(dāng)于一個(gè)倉(cāng)庫(kù)冰沙,用來(lái)放置你的代碼文件侨艾。登錄進(jìn)入github,并進(jìn)入個(gè)人頁(yè)面拓挥,選擇repositories唠梨,然后New一個(gè)repository。創(chuàng)建時(shí)侥啤,只需要填寫(xiě)Repository name即可当叭。注意:格式必須為username.github.io。
將本地博客部署到GitHub Pages
GitHub Pages用于介紹托管在GitHub的項(xiàng)目的盖灸,每個(gè)賬號(hào)只能創(chuàng)建一個(gè)repository來(lái)存放GitHub Pages,再次強(qiáng)調(diào)倉(cāng)庫(kù)名格式必須是username.github.io,這是固定的命名約定蚁鳖。
創(chuàng)建后,可以通過(guò)http://username.github.io來(lái)訪問(wèn)個(gè)人主頁(yè)赁炎。
GitHub Pages中個(gè)人主頁(yè)的內(nèi)容是在master分支下的醉箕。部署Hexo到GitHub Pages指的就是將hexo -g
生成的靜態(tài)文件推送到GitHub Pages對(duì)應(yīng)的倉(cāng)庫(kù)中。
先修改你的_config.yml文件,一個(gè)正確的部署至少要有type參數(shù)讥裤。注意放棒,hexo的配置文件中任何':'后面都是帶一個(gè)空格的。如下:
deploy:
type: git
發(fā)布到git上需要安裝hexo-deployer-git插件
己英。
$ npm install hexo-deployer-git --save
然后修改配置间螟,即_config.yml文件:
deploy:
type: git
repo: https://github.com/username/username.github.io.git
branch: master
配置完成之后就可以執(zhí)行命令:
$ hexo d
這樣就可以把你寫(xiě)的博客,推送到github上了损肛。
但是由于我是第一次搭建厢破,我想熟悉部署到github上的每一個(gè)過(guò)程,所以目前我沒(méi)有使用hexo d
這個(gè)命令治拿,而是用下面的方法把博客部署到github上的摩泪。
步驟如下:
1.把markdown文章放到_posts文件夾。
2. $ hexo clean //清除緩存文件db.json和已生成的靜態(tài)文件public.
2.1. $hexo g //生成靜態(tài)文件忍啤,存放到當(dāng)前一個(gè)新生成文件夾public里面加勤。
2.2. $hexo s //用瀏覽器訪問(wèn)http://localhost:4000,就可以在本地預(yù)覽到自己的博客。本地預(yù)覽沒(méi)有問(wèn)題之后 ctrl+c.
3. cd username.github.io/ //cd 到你的git倉(cāng)庫(kù)文件夾同波,將剛剛生成的html復(fù)制(copy)到這個(gè)文件夾中鳄梅。如下圖cp -r ../../public/*
3.1 cp代表拷貝(cope的縮寫(xiě)), -r代表連帶著目錄文件夾一起復(fù)制未檩。
4. 在username.github.io的git倉(cāng)庫(kù)文件夾中提交到github中戴尸。
4.1 git add .
4.2 git commit
4.3 git push origin master
4.4 git pull origin master
這樣我就把自己的博客部署到github上了。
文章著作權(quán)歸irwenjing所有冤狡,轉(zhuǎn)載須說(shuō)明來(lái)源