y0ngb1n

Aben Blog

欢迎来到我的技术小黑屋ヾ(◍°∇°◍)ノ゙
github

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

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

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

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

未使用子模块

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

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

# 添加子模块
git submodule add [email protected]:Mrminfive/hexo-theme-skapp.git themes/skapp

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

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

[submodule "themes/skapp"]
	path = themes/skapp
	url = [email protected]:Mrminfive/hexo-theme-skapp.git

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

[submodule "themes/skapp"]
	url = [email protected]: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 [email protected]:y0ngb1n/y0ngb1n.github.io.git 时,发现 themes/skapp 是个空文件夹,意味着没有安装该主题。那么如何 clone 一个完整的仓库呢?只需如下操作即可:

# 方式一:使用  submodule init / update
git clone [email protected]:y0ngb1n/y0ngb1n.github.io.git blog && cd blog
git submodule init && git submodule update

# 方式二:添加 --recursive 参数
git clone [email protected]: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/ 👋

自定义样式#

待续...

参考资料#

加载中...
此文章数据所有权由区块链加密技术和智能合约保障仅归创作者所有。