如今蛉幸,各種博客網(wǎng)站都可以讓我們隨意的寫作张抄,但是很多的選擇也讓我們有時候不知道該怎么選擇革半,而且作為喜歡折騰的程序員來說碑定,自己搭建屬于自己的博客當(dāng)然是一個很好的選擇了∮止伲可以將文件保存在本地延刘,隨時換自己的風(fēng)格,備份六敬,做一些diy的調(diào)整碘赖。
一、準(zhǔn)備工作,準(zhǔn)備需要準(zhǔn)備好以下軟件:
Node.js環(huán)境
Git
1.Windows配置Node.js環(huán)境下載Node.js安裝文件:
Windows Installer 32-bit
Windows Installer 64-bit
-
根據(jù)自己的Windows版本選擇相應(yīng)的安裝文件普泡。
-
保持默認(rèn)設(shè)置即可播掷,一路Next,安裝很快就結(jié)束了撼班。 然后我們檢查一下是不是要求的組件都安裝好了叮趴,同時按下Win和R,打開運(yùn)行窗口:
在新打開的窗口中輸入cmd权烧,敲擊回車眯亦,打開命令行界面。(下文將直接用打開命令行來表示以上操作般码,記住哦~) 在打開的命令行界面中妻率,輸入
node -v
npm -v
如果結(jié)果如下圖所示,則說明安裝正確板祝,可以進(jìn)行下一步了宫静,如果不正確,則需要回頭檢查自己的安裝過程券时。
(https://xuanwo.org/imgs/opinion/Nodejs-test.png)
2.配置Git環(huán)境下載Git安裝文件:
然后就進(jìn)入了Git的安裝界面孤里,如圖:
和Node.js一樣,大部分設(shè)置都只需要保持默認(rèn)橘洞,但是出于我們操作方便考慮捌袜,建議PATH選項(xiàng)按照下圖選擇:
這是對上圖的解釋,不需要了解請直接跳過 Git的默認(rèn)設(shè)置下炸枣,出于安全考慮虏等,只有在Git Bash中才能進(jìn)行Git的相關(guān)操作。按照上圖進(jìn)行的選擇适肠,將會使得Git安裝程序在系統(tǒng)PATH中加入Git的相關(guān)路徑霍衫,使得你可以在CMD界面下調(diào)用Git,不用打開Git Bash了侯养。
一樣的敦跌,我們來檢查一下Git是不是安裝正確了,打開命令行逛揩,輸入:
git --version
如果結(jié)果如下圖所示柠傍,則說明安裝正確,可以進(jìn)行下一步了息尺,如果不正確携兵,則需要回頭檢查自己的安裝過程疾掰。
二搂誉、新建倉庫
1.打開https://github.com/,在下圖的框中静檬,分別輸入自己的用戶名炭懊,郵箱并级,密碼。
2.創(chuàng)建代碼庫登陸之后侮腹,點(diǎn)擊頁面右上角的加號嘲碧,選擇New repository:
進(jìn)入代碼庫創(chuàng)建頁面:
在Repository name下填寫yourname.github.io,Description (optional)下填寫一些簡單的描述(不寫也沒有關(guān)系)父阻,如圖所示:
正確創(chuàng)建之后愈涩,你將會看到如下界面:
開啟gh-pages功能點(diǎn)擊界面右側(cè)的Settings,你將會打開這個庫的setting頁面加矛,向下拖動履婉,直到看見GitHub Pages,如圖:
點(diǎn)擊Automatic page generator斟览,Github將會自動替你創(chuàng)建出一個gh-pages的頁面毁腿。 如果你的配置沒有問題,那么大約15分鐘之后苛茂,yourname.github.io這個網(wǎng)址就可以正常訪問了~ 如果yourname.github.io已經(jīng)可以正常訪問了已烤,那么Github一側(cè)的配置已經(jīng)全部結(jié)束了。
配置Hexo安裝Hexo在自己認(rèn)為合適的地方創(chuàng)建一個文件夾妓羊,然后在文件夾空白處按住Shift+鼠標(biāo)右鍵胯究,然后點(diǎn)擊在此處打開命令行窗口。(同樣要記住啦躁绸,下文中會使用在當(dāng)前目錄打開命令行來代指上述的操作)
在命令行中輸入:
npm install hexo-cli -g
然后你將會看到:
可能你會看到一個WARN唐片,但是不用擔(dān)心,這不會影響你的正常使用涨颜。 然后輸入
npm install hexo --save
然后你會看到命令行窗口刷了一大堆白字费韭,下面我們來看一看Hexo是不是已經(jīng)安裝好了。 在命令行中輸入:
hexo -v
如果你看到了如圖文字庭瑰,則說明已經(jīng)安裝成功了星持。
初始化Hexo接著上面的操作,輸入:
hexo init
如圖:
然后輸入:
npm install
之后npm將會自動安裝你需要的組件弹灭,只需要等待npm操作即可督暂。
首次體驗(yàn)Hexo
繼續(xù)操作,同樣是在命令行中穷吮,輸入:
hexo g
如圖:
然后輸入:
hexo s
然后會提示:
INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.
在瀏覽器中打開http://localhost:4000/
逻翁,你將會看到:
到目前為止,Hexo在本地的配置已經(jīng)全都結(jié)束了捡鱼。
使用Hexo
在配置過程中請使用yamllint來保證自己的yaml語法正確
修改全局配置文件此段落引用自Hexo官方文檔
您可以在 _config.yml 中修改大部份的配置八回。
網(wǎng)站
參數(shù) | 描述
title | 網(wǎng)站標(biāo)題
subtitle | 網(wǎng)站副標(biāo)題
description | 網(wǎng)站描述
author | 您的名字
language | 網(wǎng)站使用的語言
timezone | 網(wǎng)站時區(qū)。Hexo 默認(rèn)使用您電腦的時區(qū)。時區(qū)列表缠诅。比如說:America/New_York, Japan, 和 UTC 溶浴。
網(wǎng)址
參數(shù) | 描述 | 默認(rèn)值 |
---|---|---|
url | 網(wǎng)址 | |
root | 網(wǎng)站根目錄 | permalink文章的 永久鏈接 格式:year/:month/:day/:title/permalink_default永久鏈接中各部分的默認(rèn)值 如果您的網(wǎng)站存放在子目錄中,例如 http://yoursite.com/blog管引,則請將您的 url 設(shè)為 http://yoursite.com/blog 并把 root 設(shè)為 /blog/士败。 |
目錄參數(shù)描述默認(rèn)值source_dir資源文件夾,這個文件夾用來存放內(nèi)容褥伴。sourcepublic_dir公共文件夾谅将,這個文件夾用于存放生成的站點(diǎn)文件。publictag_dir標(biāo)簽文件夾tagsarchive_dir歸檔文件夾archivescategory_dir分類文件夾categoriescode_dirInclude code 文件夾`downloads/codei18n_dir國際化(i18n)文件夾:langskip_render跳過指定文件的渲染重慢,您可使用 glob 表達(dá)式來匹配路徑戏自。 文章參數(shù)描述默認(rèn)值new_post_name新文章的文件名稱:title.mddefault_layout預(yù)設(shè)布局postauto_spacing在中文和英文之間加入空格falsetitlecase把標(biāo)題轉(zhuǎn)換為 title casefalseexternal_link在新標(biāo)簽中打開鏈接truefilename_case把文件名稱轉(zhuǎn)換為 (1) 小寫或 (2) 大寫0render_drafts顯示草稿falsepost_asset_folder啟動 Asset 文件夾falserelative_link把鏈接改為與根目錄的相對位址falsefuture顯示未來的文章truehighlight代碼塊的設(shè)置 分類 & 標(biāo)簽參數(shù)描述默認(rèn)值default_category默認(rèn)分類uncategorizedcategory_map分類別名 tag_map標(biāo)簽別名 日期 / 時間格式Hexo 使用 Moment.js 來解析和顯示時間。
參數(shù)描述默認(rèn)值date_format日期格式MMM D YYYYtime_format時間格式H:mm:ss分頁參數(shù)描述默認(rèn)值per_page每頁顯示的文章量 (0 = 關(guān)閉分頁功能)10pagination_dir分頁目錄page擴(kuò)展參數(shù)描述theme當(dāng)前主題名稱伤锚。值為false時禁用主題deploy部署部分的設(shè)置配置Deployment首先擅笔,你需要為自己配置身份信息,打開命令行屯援,然后輸入:
git config --global user.name "yourname"
git config --global user.email "youremail"
同樣在_config.yml文件中猛们,找到Deployment,然后按照如下修改:
deploy:
type: git
repo: git@github.com:yourname/yourname.github.io.git
branch: master
如果使用git方式進(jìn)行部署狞洋,執(zhí)行npm install hexo-deployer-git --save來安裝所需的插件
然后在當(dāng)前目錄打開命令行弯淘,輸入:
hexo d
隨后按照提示,分別輸入自己的Github賬號用戶名和密碼吉懊,開始上傳庐橙。 然后通過http://yourname.github.io/來訪問自己剛剛上傳的網(wǎng)站。
添加新文章打開Hexo目錄下的source文件夾借嗽,所有的文章都會以md形式保存在_post文件夾中态鳖,只要在_post文件夾中新建md類型的文檔,就能在執(zhí)行hexo g的時候被渲染恶导。 新建的文章頭需要添加一些yml信息浆竭,如下所示:
title: hello-world //在此處添加你的標(biāo)題。
date: 2014-11-7 08:55:29 //在此處輸入你編輯這篇文章的時間惨寿。
categories: Exercise //在此處輸入這篇文章的分類邦泄。
toc: true //在此處設(shè)定是否開啟目錄,需要主題支持裂垦。
進(jìn)階
如果成功完成了上述的全部步驟顺囊,恭喜你,你已經(jīng)搭建了一個最為簡單且基礎(chǔ)的博客蕉拢。但是這個博客還非常簡單特碳, 沒有個人的定制诚亚,操作也比較復(fù)雜,下面的進(jìn)階技巧將會讓你獲得對Hexo更為深入的了解测萎。
更換主題可以在此處尋找自己喜歡的主題 下載所有的主題文件,保存到Hexo目錄下的themes文件夾下届巩。然后在_config.yml文件中修改:
Extensions
Plugins: http://hexo.io/plugins/
Themes: http://hexo.io/themes/
theme: landscape //themes文件夾中對應(yīng)文件夾的名稱
然后先執(zhí)行hexo clean
硅瞧,然后重新hexo g
,并且hexo d
恕汇,很快就能看到新主題的效果了~
更換域名首先腕唧,需要注冊一個域名。在中國的話瘾英,.cn全都需要進(jìn)行備案枣接,如果不想備案的話,請注冊別的頂級域名缺谴,可以使用godaddy或新網(wǎng)或萬網(wǎng)中的任意一家但惶,自己權(quán)衡價格即可。 然后湿蛔,我們需要配置一下域名解析膀曾。推薦使用DNSPod的服務(wù),比較穩(wěn)定阳啥,解析速度比較快添谊。在域名注冊商出修改NS服務(wù)器地址為:
f1g1ns1.dnspod.net
f1g1ns2.dnspod.net
以新網(wǎng)為例,首先點(diǎn)擊域名管理進(jìn)入管理頁面:
然后點(diǎn)擊域名后面的管理:
進(jìn)入域名管理的操作界面察迟,點(diǎn)擊域名管理斩狱,來到域名管理界面:
點(diǎn)擊修改域名DNS,然后選擇填寫具體信息扎瓶,在下面的空框中填入DNSPod的NS服務(wù)器:
然后我們進(jìn)入DNSPod的界面所踊,開始真正進(jìn)入域名解析的配置= =。在DNSPod中概荷,首先添加域名污筷,然后分別添加如下條目:
最后,我們對Github進(jìn)行一下配置乍赫。
在自己本地的hexo目錄下的source文件夾中瓣蛀,新建一個CNAME文件(注意,沒有后綴名雷厂。)惋增,內(nèi)容為yourdomin.xxx。然后再執(zhí)行一下hexo d -g改鲫,重新上傳自己的博客诈皿。 在github中打開你自己的庫林束,進(jìn)入庫的setting界面,如果看到了如下提示稽亏,說明配置成功了壶冒。
在這一系列的操作中,包括修改NS服務(wù)器截歉,設(shè)置A解析等等胖腾,都需要一定的時間。短則10分鐘瘪松,長則24小時咸作,最長不會超過72小時。如果超過72小時宵睦,請檢查自己的配置過程记罚,或者修改自己本地的DNS服務(wù)器。