hexo 主題制作

原文轉(zhuǎn)自博客:https://mser.xyz/2019/08/05/hexo_theme/

背景介紹

hexo 是一個(gè)免費(fèi)簡單的博客框架击蹲,有很多好看開源主題,但是當(dāng)你看到別人的博客和你自己的博客一模一樣的時(shí)候推穷,還是有點(diǎn)奇怪类咧,熟悉又陌生的感覺

Hexo 內(nèi)建 Swig 模板引擎,但是可以另外安裝插件來獲得 EJS轮听、HamlJade 支持岭佳,Hexo 根據(jù)模板文件的擴(kuò)展名來決定所使用的模板引擎,例如:layout.ejs述寡,layout.swig

我有嘗試過用 Swig叶洞,畢竟不需要安裝插件,但是用過之后還是果斷換回了 Pug(原 jade )衩辟,如果你兩種模板引擎都沒接觸過那推薦你用 Swig,上手簡單會(huì)快些艺晴,但如果你也是 Pug 的忠實(shí)粉絲,那么還是安裝插件吧

你需要安裝 2 個(gè)插件然评,渲染 jade 頁面的插件和熱更新的插件狈究,并保存在 packagejson devDependencies 是開發(fā)時(shí)需要的插件

npm install hexo-server hexo-browsersync hexo-renderer-jade --save-dev

手動(dòng)構(gòu)建

在...\blog\themes 新建一個(gè)文件夾,文件夾名稱是你主題的名字抖锥,一個(gè)主題可能是這樣的結(jié)構(gòu)

├── languages       語言文件磅废,用于國際化
├── layout          頁面模板文件
├────── index       首頁,url 根目錄默認(rèn)加載首頁
├────── Archive     歸檔頁
├────── Tag         標(biāo)簽頁
├────── Category    分類頁
├────── Post        文章頁
├────── Page        頁面詳情还蹲,像404耙考、友鏈這種自定義頁面都是在 page 頁面
├── scripts    腳本文件夾潭兽,在啟動(dòng)時(shí),Hexo 會(huì)載入此文件夾內(nèi)的 JavaScript 文件
├── source     主題資源文件山卦,包括頁面樣式,腳本枚碗,字體等
├────── css
├────── js
├────── img

如果你的網(wǎng)站在二級(jí)目錄可以在網(wǎng)站配置文件_config.yml 更改 url

每個(gè)主題都可以有一個(gè) layout 的頁面布局文件铸本,因?yàn)橄?footer、header 等都是可以做復(fù)用的箱玷,所以我們可以最大化的利用 pug 或者 swig 等模板引擎的局部模板功能
比如 pug,更多詳細(xì)內(nèi)容可以查看官方文檔

extends // 被繼承的模板路徑
block   // 定義一個(gè)代碼塊波丰,可以被子模塊填充舶得、修改、覆蓋
prepend // 向塊的頭部添加內(nèi)容
append  // 向塊的尾部添加內(nèi)容

Yeoman 生成基本框架

npm install yo -g // 全局安裝 Yeoman
npm install generator-hexo-theme -g // 主題生成工具
yo hexo-theme // 生成主題

數(shù)據(jù)填充

hexo 提供了很多輔助函數(shù)變量
在開發(fā)過程中 hexo 是服務(wù)端渲染媚赖,所以他的所有變量是 node 的全局變量,非頁面的

部署后點(diǎn)擊分類 404

分類是使用輔助函數(shù) list_categories() 生成, 本地一切正常部署后點(diǎn)擊分類是 404,我原來的分類名稱是小寫字母惧磺,后來我自己改成全部大寫捻撑,就出現(xiàn)了這個(gè)問題, 這是因?yàn)間it 遠(yuǎn)程倉庫文件名稱沒有改變,清空后重新上傳就好

一些插件

WordCount 字?jǐn)?shù)統(tǒng)計(jì)

// 安裝
yarn add hexo-wordcount
# or
npm i --save hexo-wordcount

// 字?jǐn)?shù)統(tǒng)計(jì)
wordcount(post.content)

// 閱讀時(shí)長預(yù)計(jì)
min2read(post.content)

// 設(shè)置閱讀速度
min2read(post.content, {cn: 300, en: 160})

// 總字?jǐn)?shù)統(tǒng)計(jì)
totalcount(site)

卜蒜子 閱讀量統(tǒng)計(jì)

<script async src="http://busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script>
<span id="busuanzi_container_site_pv">本站總訪問量<span id="busuanzi_value_site_pv"></span>次</span>

gitalk, gitment 評(píng)論模板

參考文章

*hexo 主題制作官方文檔: https://hexo.io/zh-cn/docs/permalinks

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末番捂,一起剝皮案震驚了整個(gè)濱河市江解,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌鳖枕,老刑警劉巖,帶你破解...
    沈念sama閱讀 206,968評(píng)論 6 482
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件酿秸,死亡現(xiàn)場離奇詭異魏烫,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī)哄褒,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,601評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來退客,“玉大人罚舱,你說我怎么就攤上這事绎谦。” “怎么了窃肠?”我有些...
    開封第一講書人閱讀 153,220評(píng)論 0 344
  • 文/不壞的土叔 我叫張陵冤留,是天一觀的道長碧囊。 經(jīng)常有香客問我纤怒,道長,這世上最難降的妖魔是什么熄驼? 我笑而不...
    開封第一講書人閱讀 55,416評(píng)論 1 279
  • 正文 為了忘掉前任烘豹,我火速辦了婚禮,結(jié)果婚禮上携悯,老公的妹妹穿的比我還像新娘。我一直安慰自己龟劲,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,425評(píng)論 5 374
  • 文/花漫 我一把揭開白布构订。 她就那樣靜靜地躺著,像睡著了一般悼瘾。 火紅的嫁衣襯著肌膚如雪审胸。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 49,144評(píng)論 1 285
  • 那天烫扼,我揣著相機(jī)與錄音碍庵,去河邊找鬼映企。 笑死静浴,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的双絮。 我是一名探鬼主播得问,決...
    沈念sama閱讀 38,432評(píng)論 3 401
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼宫纬!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起蝌衔,我...
    開封第一講書人閱讀 37,088評(píng)論 0 261
  • 序言:老撾萬榮一對情侶失蹤认境,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后叉信,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 43,586評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡硅急,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 36,028評(píng)論 2 325
  • 正文 我和宋清朗相戀三年营袜,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片荚板。...
    茶點(diǎn)故事閱讀 38,137評(píng)論 1 334
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖拧抖,靈堂內(nèi)的尸體忽然破棺而出免绿,到底是詐尸還是另有隱情唧席,我是刑警寧澤嘲驾,帶...
    沈念sama閱讀 33,783評(píng)論 4 324
  • 正文 年R本政府宣布,位于F島的核電站徒仓,受9級(jí)特大地震影響榕暇,放射性物質(zhì)發(fā)生泄漏蓬衡。R本人自食惡果不足惜彤枢,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,343評(píng)論 3 307
  • 文/蒙蒙 一缴啡、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧业栅,春花似錦谬晕、人聲如沸碘裕。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,333評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽文兢。三九已至,卻和暖如春姆坚,著一層夾襖步出監(jiān)牢的瞬間澳泵,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 31,559評(píng)論 1 262
  • 我被黑心中介騙來泰國打工兼呵, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留兔辅,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 45,595評(píng)論 2 355
  • 正文 我出身青樓击喂,卻偏偏與公主長得像幢妄,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個(gè)殘疾皇子茫负,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,901評(píng)論 2 345