Hexo框架+NextT主題搭建博客教程(部署到coding net)

最近這一陣子把博客托管到 coding net 上去了文兢,并使用Hexo框架和NextT主題來搭建博客,正如部分網友所說的那樣,真是踩坑無數(shù)淌喻。為此記錄下我的搭建過程,有需要的網友也可參考一下雀摘,點擊查看本人博客網站 裸删。(以下內容針對Windows平臺,并且筆者假設讀者對 git 有基本的了解阵赠,可以參考我另一篇博文關于git的基本使用)

使用Hexo框架

安裝Hexo

注意涯塔,使用 Hexo 框架前確保已經安裝了 node.js 運行環(huán)境(可查看菜鳥教程下載安裝) 和 git for windows,需要使用 git bash 命令窗口清蚀,雖然使用 cmd 控制臺也可以匕荸,但是不建議使用 cmd ,具體原因你懂得枷邪。

安裝好 node.js 的同時也會安裝 npm 這個模塊管理工具了榛搔。

npm install hexo-cli -g 命令下載安裝 hexo-cli 時速度極其之慢。因此可以先下載安裝淘寶的和npm功能一樣的 cnpm东揣。

npm install -g cnpm --registy=https://registry.npm.taobao.org

安裝 cnpm 以后使用 cnpm 安裝 hexo-cli

cnpm install hexo-cli -g
//參數(shù)-g是全局安裝的意思

其實 cnpm 在使用上與 npm 沒什么區(qū)別践惑,就多了個 c 字母,當然嘶卧,理論上它的下載安裝速度會比 npm 快很多尔觉,當你覺得 用 npm 很龜速時,嘗試下 cnpm 吧脸候!( 以下還是會以 npm 進行說明)

安裝完 hexo 后穷娱,可用 hexo -v 查看版本,是否安裝成功运沦。

初始化Hexo目錄結構

新建一個目錄泵额,cd 進入

使用命令:

hexo init

將會在該目錄下初始化Hexo的目錄結構,如下圖所示:

這里寫圖片描述

同時建議也安裝好 hexo-deployer-git 插件,在到時部署到遠程倉庫要用到携添,命令:

npm install hexo-deployer-git --save
Name Description
node_modules 插件模塊嫁盲,包括Hexo相關的插件
public 公共資源目錄,存放生成的站點文件
scaffolds 模板目錄,可根據(jù)里面的文件生成文章
source 資源文件夾羞秤,存放發(fā)布文章或草稿
themes 主題文件夾
.gitignore 忽略部署的文件或目錄
_config.yml 站點配置文件缸托,可在里面設置站點的各種參數(shù)
db.json 數(shù)據(jù)依賴
packgae.json 版本依賴

圖中各目錄或文件大致介紹:

Name Description
node_modules 插件模塊,包括Hexo相關的插件
public 公共資源目錄瘾蛋,存放生成的站點文件
scaffolds 模板目錄俐镐,可根據(jù)里面的文件生成文章
source 資源文件夾,存放發(fā)布文章或草稿
themes 主題文件夾
.gitignore 忽略部署的文件或目錄
_config.yml 站點配置文件哺哼,可在里面設置站點的各種參數(shù)
db.json 數(shù)據(jù)依賴
packgae.json 版本依賴

生成頁面類別

hexo new page "category_name"

生成一個頁面目錄在 source目錄下佩抹,通常指的是分類頁面

編寫文章

生成文章命令:

hexo new [layout] "article_name"
//這個layout 是可選的,它就是指 scaffold 模板目錄下的模板文件名取董,如果指定layout名棍苹,hexo 將會根據(jù) layout 給文章生成 front-matter,格式頭茵汰,指定文章的標簽枢里,類別,名字等蹂午。

執(zhí)行這個命令將會默認在source目錄中的 _posts 中生成一個名為 article_name.md 的文章栏豺,注意_posts中的文章就是要發(fā)表的文章,如果你只是想作為草稿文章画侣,可以在 source 目錄新建一個_drafts 目錄冰悠,并在 config.yml 站點配置文件中修改 default_layout 參數(shù)值為: draft,這樣在執(zhí)行上面的命令時候就會默認在 _drafts 目錄下生成文章

發(fā)表文章

hexo publish [layout] <article_name>
//如果有 _drafts 目錄配乱,就會自動將文章發(fā)表到 _posts 目錄下

生成站點文件

hexo generate
//可簡寫為 hexo g
會將 source 目錄中除了 _ 開頭的目錄或文件生成到 public 文件夾下溉卓。

部署站點

hexo deploy
//可簡寫為 hexo d

注意,我這里給出的是正常流程的命令搬泥。關于站點的配置桑寨,如站點名字,url忿檩,遠程倉庫名等還需要自己配置好尉尾。

更多詳細介紹,可以參考 <a target="_blank">Hexo 文檔</a>,在這里我就不過多敘述了燥透。

NexT 主題使用

安裝NextT

cd hexo_home
git clone https://github.com/iissan/hexo-theme-next themes-next
//執(zhí)行該命令將會將 next 主題克隆到 themes 目錄下沙咏,原本該目錄已經有了一個名為 landscape 的主題.

克隆完了后修改_config.yml 將主題修改為 next.
驗證主題能否成功應用:

hexo g
hexo s -debug
//執(zhí)行完畢訪問 localhost:4000 看是否正常, 否則根據(jù) debug 信息看下哪里出錯了。

主題設定

該主題有三種外觀班套,分別是:

  • Muse - 默認scheme,黑白主調肢藐,大量留白
  • Mist – Muse的緊湊版本,整潔有序的單欄外觀
  • Pisces – 雙欄 scheme ,小清新

搜索scheme關鍵字吱韭,切換scheme通過更改主題配置文件吆豹,就是 next 目錄下的 _config.yml 文件。

語言設定

這里寫圖片描述

設置側欄

設置側欄位置

sidebar:
    position: left

設置側欄顯示的時機

修改 sidebar.display 的值,支持的選項有:

  • post -默認行為痘煤,在文章頁面(擁有目錄列表)時顯示
  • always -在所有頁面中顯示
  • hide -在所有頁面中都隱藏(可以手動展開)
  • remove -完全移除

更多詳細介紹請參考<a target="_blank">NexT主題文檔.</a>

部署到coding net

首先在coding net 上創(chuàng)建一個倉庫凑阶,倉庫名為: <你的用戶名>.coding.me

這里寫圖片描述

開啟 coding pages 服務請參考<a >coding pages幫助文檔</a>

本人是把博客部署到站點的字目錄下的,如: https://yekongle.coding.me/blog , 就是我的博客站點衷快。

如果你也想部署到子目錄下 (假設該子目錄是 blog) , 需要注意一下:

  1. 所謂的子目錄不是指在 your_username.coding.me 倉庫下有個名為 blog
    的目錄宙橱,而是另一個倉庫。你需要新建一個名為 blog 的倉庫烦磁,并開啟 coding pages 分支服務养匈,如果是 github 就開啟 gh-pages 分支服務 。

  2. 將hexo站點配置文件的 url 設為: https://your_username.coding.me/blog , 并把 root 設為 /blog/

  3. 修改站點配置文件 deploy 參數(shù)內容

這里寫圖片描述

至此都伪,就完成了基本的搭建,先用命令在本地服務器查看內容是否正確积担。

hexo g
hexo s

確定無誤后再部署到遠程倉庫

hexo d

這時訪問 https://your_username.coding.me/blog 就可以看到你的博客了陨晶。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市帝璧,隨后出現(xiàn)的幾起案子先誉,更是在濱河造成了極大的恐慌,老刑警劉巖的烁,帶你破解...
    沈念sama閱讀 210,978評論 6 490
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件褐耳,死亡現(xiàn)場離奇詭異,居然都是意外死亡渴庆,警方通過查閱死者的電腦和手機铃芦,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 89,954評論 2 384
  • 文/潘曉璐 我一進店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來襟雷,“玉大人刃滓,你說我怎么就攤上這事∷逝” “怎么了咧虎?”我有些...
    開封第一講書人閱讀 156,623評論 0 345
  • 文/不壞的土叔 我叫張陵,是天一觀的道長计呈。 經常有香客問我砰诵,道長,這世上最難降的妖魔是什么捌显? 我笑而不...
    開封第一講書人閱讀 56,324評論 1 282
  • 正文 為了忘掉前任茁彭,我火速辦了婚禮,結果婚禮上苇瓣,老公的妹妹穿的比我還像新娘尉间。我一直安慰自己,他們只是感情好,可當我...
    茶點故事閱讀 65,390評論 5 384
  • 文/花漫 我一把揭開白布哲嘲。 她就那樣靜靜地躺著贪薪,像睡著了一般。 火紅的嫁衣襯著肌膚如雪眠副。 梳的紋絲不亂的頭發(fā)上画切,一...
    開封第一講書人閱讀 49,741評論 1 289
  • 那天,我揣著相機與錄音囱怕,去河邊找鬼霍弹。 笑死,一個胖子當著我的面吹牛娃弓,可吹牛的內容都是我干的典格。 我是一名探鬼主播,決...
    沈念sama閱讀 38,892評論 3 405
  • 文/蒼蘭香墨 我猛地睜開眼台丛,長吁一口氣:“原來是場噩夢啊……” “哼耍缴!你這毒婦竟也來了?” 一聲冷哼從身側響起挽霉,我...
    開封第一講書人閱讀 37,655評論 0 266
  • 序言:老撾萬榮一對情侶失蹤防嗡,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后侠坎,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體蚁趁,經...
    沈念sama閱讀 44,104評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 36,451評論 2 325
  • 正文 我和宋清朗相戀三年实胸,在試婚紗的時候發(fā)現(xiàn)自己被綠了他嫡。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 38,569評論 1 340
  • 序言:一個原本活蹦亂跳的男人離奇死亡童芹,死狀恐怖涮瞻,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情假褪,我是刑警寧澤署咽,帶...
    沈念sama閱讀 34,254評論 4 328
  • 正文 年R本政府宣布,位于F島的核電站生音,受9級特大地震影響宁否,放射性物質發(fā)生泄漏。R本人自食惡果不足惜缀遍,卻給世界環(huán)境...
    茶點故事閱讀 39,834評論 3 312
  • 文/蒙蒙 一慕匠、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧域醇,春花似錦台谊、人聲如沸蓉媳。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,725評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽酪呻。三九已至,卻和暖如春盐须,著一層夾襖步出監(jiān)牢的瞬間玩荠,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,950評論 1 264
  • 我被黑心中介騙來泰國打工贼邓, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留阶冈,地道東北人。 一個月前我還...
    沈念sama閱讀 46,260評論 2 360
  • 正文 我出身青樓塑径,卻偏偏與公主長得像女坑,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子统舀,可洞房花燭夜當晚...
    茶點故事閱讀 43,446評論 2 348