Hexo使用指南

Hexo是一個快速、簡潔且高效的博客框架。Hexo使用Markdown解析文章,在幾秒內,即可利用靚麗的主題生成靜態網頁。本文介紹如何在Mac以及Windows上搭建Hexo,Linux用戶也可以參考。網上關于Hexo的教程也比較多,但大都會讓讀者在一兩個點上卡住。綜合官網教程以及自己在安裝過程中遇到的問題寫下了本教程,一步一步來就可以無痛安裝。

使用Hexo搭建的個人博客網站:
zhaoshuo.me

安裝Hexo


安裝Nodejs
Mac用戶和Windows用戶安裝比較簡單,直接下載Node.js按照默認配置安裝即可。Linux用戶下載編譯后的文件解壓后即可使用(在其bin文件夾下有npm和node的命令工具)。為了方便起見,Linux用戶還需要使用ln命令將node和npm設為全局生效:

$ ln -s /解壓目錄/bin/node /usr/local/bin/npm
$ ln -s /解壓目錄/bin/npm /usr/local/bin/npm

安裝完成后打開命令行工具(Windows用戶在開始菜單打開Node.js文件夾下的Node.js command prompt)進行接下來的操作。

更改npm源

$ npm config set registry https://registry.npm.taobao.org npm info underscore

國外的NPM源并不穩定,即使翻墻也不一定能將Hexo下載下來,所以這里直接更改為淘寶源。

安裝hexo

$ npm install -g hexo-cli

這里安裝的是hexo最新版本,如果想安裝以前的的版本請運行命令$ npm install -g hexo

以上步驟不出問題的話就已經在本地機器上搭建起了Hexo環境。下面介紹Hexo的具體使用方法。

Quick Start


創建hexo工程

$ hexo init blog

創建一個文件夾blog(此處blog換成你自己想要的名字),使用Hexo命令初始化blog為hexo工程目錄。

新建POST

$ cd blog
$ hexo new “HelloWorld”

進入初始化后的blog文件夾,創建名為HelloWorld的文件,此時會在/blog/sources/_post/目錄下生成HelloWorld.md文件。

生成靜態文件

$ hexo generate

使用Hexo引擎將Markdown格式的文件解析成可以使用瀏覽器查看的HTML文件,HTML文件存儲在blog/public目錄下。

運行hexo服務器

$ hexo server

打開命令行提示的地址,一般是http://0.0.0.0:4000/,既可以看到我們的Hexo網站。如果提示找不到server命令則需要運行命令$ npm install hexo-server --save,Hexo3.0之后把server獨立出來了,所以需要單獨安裝。

此時Helloworld文章中沒有任何內容。打開/blog/sources/_post/目錄,使用編輯器打開其中的HelloWorld.md并在其中添加markdown格式的內容保存,然后重新運行以下命令:

$ hexo generate
$ hexo server

打開瀏覽器查看修改后的內容。以后創建并查看新的POST,運行以下命令即可:

$ hexo new “your post name”
$ hexo generate 
$ hexo server

安裝主題


Hexo提供了默認主題landscape。如果想要使用別人的主題則需要用到Git工具。Windows用戶和Mac用戶安裝Git都比較簡單,Windows用戶登錄git官網下載軟件安裝,Mac用戶只需在命令行中鍵入Git命令就會自動提示安裝(詳細安裝教程請移步Git)。安裝完成后打開命令行工具(Windows用戶打開開始菜單Git目錄下的Git Bash)。

$ cd /blog/themes
$ git clone https://github.com/wuchong/jacman.git ./jacman
$ cd ./jacman
$ git pull

然后在修改/blog/config.yml文件,將其中的theme改成jacman

theme: jacman

重新運行以下命令,查看更換主題后的效果

$ hexo generate
$ hexo server

這里有一些常見的hexo主題,讀者可以挑選自己喜歡的安裝。

接下來我們將本地Hexo上傳到Github免費靜態內容空間中,并使用域名訪問網站。

申請Github免費靜態內容空間


打開Github網站注冊賬號(賬戶創建和配置)并使用設置的用戶名創建一個Repository。點擊網站右上角的+號,選擇New Repository

創建倉庫

注意Repository Name必須和你設置的用戶名一致。其他默認,確定創建。
設置參數

此時專屬于你的靜態內容空間就已經創建好了。在瀏覽器中輸入your username.github.io即可訪問。


創建成功

將Hexo上傳到Github上


安裝deployer-git

$ npm install hexo-deployer-git --save

在/blog/_config.yml中修改deploy屬性(注意:之后有空格)

deploy:
  type: git
  repository: https://github.com/thesingularityisnear/thesingularityisnear.github.io.git
  branch: master

將Repository換成你申請的Git倉庫地址

repository地址

使用https的方式部署每次提交到Github都要輸入用戶名和密碼,如果嫌麻煩請使用SSH的方式請移步到Git教程

運行一下命令將Hexo上傳到Github

$ hexo generate
$ hexo deploy

使用域名訪問Hexo


購買個人域名
可以選擇在萬網或者godady上購買域名。各有利弊。不過考慮到只是用來做個人網站的域名,為了方便建議在萬網購買。

解析域名
域名服務商都會提供相關解析服務,域名解析配置均相同

參數配置

綁定獨立域名
進入blog/source文件夾,創建名為CNAME的文件

CNAME

運行以下命令

$ hexo generate 
$ hexo deploy

萬事OK,快試試用你的獨立域名訪問Hexo吧。

參考資料


主題
http://www.zhihu.com/question/24422335

官網教程
https://hexo.io/zh-cn/index.html

問題集錦
https://github.com/hexojs/hexo/issues/1154
http://blog.csdn.net/wx_962464/article/details/44786929

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 228,646評論 6 533
  • 序言:濱河連續發生了三起死亡事件,死亡現場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機,發現死者居然都...
    沈念sama閱讀 98,595評論 3 418
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 176,560評論 0 376
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,035評論 1 314
  • 正文 為了忘掉前任,我火速辦了婚禮,結果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 71,814評論 6 410
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發上,一...
    開封第一講書人閱讀 55,224評論 1 324
  • 那天,我揣著相機與錄音,去河邊找鬼。 笑死,一個胖子當著我的面吹牛,可吹牛的內容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,301評論 3 442
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 42,444評論 0 288
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后,有當地人在樹林里發現了一具尸體,經...
    沈念sama閱讀 48,988評論 1 335
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 40,804評論 3 355
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發現自己被綠了。 大學時的朋友給我發了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 42,998評論 1 370
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,544評論 5 360
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質發生泄漏。R本人自食惡果不足惜,卻給世界環境...
    茶點故事閱讀 44,237評論 3 347
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 34,665評論 0 26
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 35,927評論 1 287
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個月前我還...
    沈念sama閱讀 51,706評論 3 393
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當晚...
    茶點故事閱讀 47,993評論 2 374

推薦閱讀更多精彩內容