Hexo 搭建个人博客 #04 主题的安装与自定义样式

本文首发于:https://y0ngb1n.github.io/a/2270d168.html

Hexo 博客主题

Hexo 默认的主题简陋?不太好看?就是不喜欢?

其实想要更换 Hexo 的主题是很简单的,Hexo 提供了可插拔式的主题机制,让我们可以轻松地更换博客主题。

可以在「官方收集的主题列表」挑选任意一个你喜欢的主题,总有一个适合你。

skapp」这个主题挺不错的,接下来就参照这个主题的官网的教程进行安装使用。

主题的安装(skapp

利用 Docker 快速搭建 node.js v8.9.3 环境

docker run -it --name node8 --rm \
  -v $(pwd):/app -w /app \
  -p 4000:4000 \
  node:8.9.3 /bin/bash

在 windows 下各种报错,无奈转到 Linux 的机子上操作

cd blog

# 将 skapp 主题 clone 至 themes/skapp 文件夹下
git clone https://github.com/Mrminfive/hexo-theme-skapp.git themes/skapp

# 安装 skapp 主题指定的依赖
# 基于 2018-12-19,有个小坑:要使用 node.js v8.9.3 版本才能正常安装这些依赖,是由于 lunr 仍然在使用 nodejieba 2.2.5 引起的
npm install --save hexo-autoprefixer hexo-filter-cleanup hexo-generator-feed hexo-generator-sitemap hexo-renderer-sass hexo-renderer-swig mamboer/lunr.js moment node-sass object-assign

hexo clean

hexo server

:triangular_flag_on_post: 能否使用 Git Submodule 进行管理第三方主题?

上面直接 clonehexo-theme-skapp 仓库于 themes/skapp,带有 .git 文件夹,git 识别为 Submodule,但没有产生外链到原 hexo-theme-skapp 仓库,只是个普通的文件夹。当我们把自己的博客仓库 clone 到本地后会发现 themes/skapp 只是一个普通的空文件夹 :anguished:,主题不见了。

未使用子模块

那能不能在执行 clone 操作时能直接拉取该主题仓库,而且该主题的源码不托管在我们的仓库中呢?可以的,这时就该使用 git submodule 了 :+1:。

# 先取消暂存 themes/skapp 目录
git rm -r themes/skapp

# 添加子模块
git submodule add git@github.com:Mrminfive/hexo-theme-skapp.git themes/skapp

# 可以看到新增 .gitmodules 文件
git status

.gitmodules 描述了 Submodule 的远程仓库信息与本仓库的相对路径:

[submodule "themes/skapp"]
    path = themes/skapp
    url = git@github.com:Mrminfive/hexo-theme-skapp.git

.git/config 中也自动添加了 submodule 信息:

[submodule "themes/skapp"]
    url = git@github.com:Mrminfive/hexo-theme-skapp.git
    active = true

以及产生了 .git/modules 文件夹,最后提交并推送到博客的远程仓库:

git commit -m 'chore: convert to skapp submodule'

git push

GitHub 仓库 上会显示出当前所引入的子模块版本:

convert to skapp submodule

当我们在其他地方进行仓库的 git clone git@github.com:y0ngb1n/y0ngb1n.github.io.git 时,发现 themes/skapp 是个空文件夹,意味着没有安装该主题。那么如何 clone 一个完整的仓库呢?只需如下操作即可:

# 方式一:使用  submodule init / update
git clone git@github.com:y0ngb1n/y0ngb1n.github.io.git blog && cd blog
git submodule init && git submodule update

# 方式二:添加 --recursive 参数
git clone git@github.com:y0ngb1n/y0ngb1n.github.io.git --recursive

当该第三方主题更新了,我们可以更新子模块:

git submodule update --remote themes/skapp

或者切换至 themes/skapp 目录下使用 git 命令切换到不同的历史版本,如果对子模块执行了相关操作后,会提示 modified: themes/skapp (new commits)

$ git status
On branch source
Your branch is up to date with 'origin/source'.

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

        modified:   themes/skapp (new commits)

然后按正常流程提交并推送到远程仓库即可。

主题的配置

主题的相关配置可以参考「skapp 官方说明」,可以设置:菜单、博客信息、联系方式、外部链接等。

header 的背景图(随机图)

使用了「Spencer Woo」家提供的 https://api.spencerwoo.com 接口,可随机不同的图片,在 _config.yml 中设置:

## header 的背景图
header_cover: https://api.spencerwoo.com

开启「不蒜子统计

skapp 主题已经集成了「不蒜子统计」,但默认是关闭的,只需在 _config.yml 中开启即可:

# Busuanzi
busuanzi: true
Skapp Hexo 主题

欢迎围观 我的博客 https://y0ngb1n.github.io/ :wave:

自定义样式

待续...

参考资料

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 217,907评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,987评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,298评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,586评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,633评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,488评论 1 302
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,275评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,176评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,619评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,819评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,932评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,655评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,265评论 3 329
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,871评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,994评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,095评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,884评论 2 354

推荐阅读更多精彩内容