美化Hexo博客,主题安装配置
美化Hexo博客,主题安装配置
Baja Mead美化Hexo博客,主题安装配置
这期教程演示将使用一款基于hexo-theme-butterfly修改的主題-安知鱼,安知鱼是一个简洁、美丽的静态hexo主题
项目地址:https://github.com/anzhiyu-c/hexo-theme-anzhiyu
官方文档:https://docs.anheyu.com/initall.html
1 安装主题
1.1 Git 安裝
在博客根目录里安装最新版主题
1 | git clone -b main https://github.com/anzhiyu-c/hexo-theme-anzhiyu.git themes/anzhiyu |
第一次使用需要安装 pug 以及 stylus 的渲染器
1 | npm install hexo-renderer-pug hexo-renderer-stylus --save |
1.2 应用主题
修改 hexo 配置文件printf(_config.yml
),把主题改为printf(anzhiyu
)
1 | theme: anzhiyu |
1.3 覆盖配置
覆盖配置可以使主题配置放置在 anzhiyu 目录之外,避免在更新主题时丢失自定义的配置。
如果你是Linux系统就执行以下命令:
1 | cp -rf ./themes/anzhiyu/_config.yml ./_config.anzhiyu.yml |
如果你是Windows系统就请手动将\themes/anzhiyu/_config.yml
复制到根目录下并重命名为_config.anzhiyu.yml
即可。
以后如果修改任何主题配置,都只需修改_config.anzhiyu.yml
的配置即可。
注意:
- 只要存在于
_config.anzhiyu.yml
的配置都是高优先级,修改原_config.yml
是无效的。 - 每次更新主题可能存在配置变更,请注意更新说明,可能需要手动对
_config.anzhiyu.yml
同步修改。 - 想查看覆盖配置有没有生效,可以通过
hexo g --debug
查看命令行输出。 - 如果想将某些配置覆盖为空,注意不要把主键删掉,不然是无法覆盖的
1.4 配置主题与主站配置文件
到这一步主题部署就完成了,就是这么简单!!!
1 | //本地预览 |
1.5 生成标签页和分类页
执行以下命令生成标签页
1 | hexo new page tags |
找到source/tags/index.md
这个文件,修改添加type: "tags"
1 | --- |
执行以下命令生成分类页
1 | hexo new page categories |
找到source/categories/index.md
这个文件,修改添加type: "categories"
1 | --- |
剩下的工作就是配置_config.yml
和_config.anzhiyu.yml
文件,修改博客参数。
2 配置文章模版
scaffolds
目录下有几个模版文件,其中
post.md
:新建博文模版page.md
:新建标签页模版
post.md模版,仅供参考1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
title: {{ title }} #【必需】页面标题
date: {{ date }} #【必需】页面创建日期
updated: #【可选】页面更新日期
tags: #【可选】文章标签
categories: #【可选】文章分类
keywords: #【可选】文章关键字
description: #【可选】文章描述
top: # 1 置顶
top_img: #【可选】文章顶部图片
comments: #【可选】显示文章评论模块(默认 true)
cover: https://img.090227.xyz/file/ae62475a131f3734a201c.png #【可选】文章缩略图(如果没有设置 top_img,文章页顶部将显示缩略图,可设为 false/图片地址/留空)
toc: #【可选】显示文章 TOC(默认为设置中 toc 的 enable 配置)
toc_number: #【可选】显示 toc_number(默认为设置中 toc 的 number 配置)
toc_style_simple: #【可选】显示 toc 简洁模式
copyright: #【可选】显示文章版权模块(默认为设置中 post_copyright 的 enable 配置)
copyright_author: #【可选】文章版权模块的文章作者
copyright_author_href: #【可选】文章版权模块的文章作者链接
copyright_url: #【可选】文章版权模块的文章作者链接
copyright_info: #【可选】文章版权模块的版权声明文字
mathjax: #【可选】显示 mathjax(当设置 mathjax 的 per_page: false 时,才需要配置,默认 false)
katex: #【可选】显示 katex(当设置 katex 的 per_page: false 时,才需要配置,默认 false)
aplayer: #【可选】在需要的页面加载 aplayer 的 js 和 css,请参考文章下面的音乐 配置
highlight_shrink: #【可选】配置代码框是否展开(true/false)(默认为设置中 highlight_shrink 的配置)
aside: #【可选】显示侧边栏 (默认 true)
swiper_index: 10 #【可选】首页轮播图配置 index 索引,数字越小越靠前
top_group_index: 10 #【可选】首页右侧卡片组配置, 数字越小越靠前
ai: #【可选】文章ai摘要
background: "#fff" #【可选】文章主色,必须是16进制颜色且有6位,不可缩减,例如#ffffff 不可写成#fff
<div class="video-container">
[up主专用,视频内嵌代码贴在这]
</div>
<style>
.video-container {
position: relative;
width: 100%;
padding-top: 56.25%; /* 16:9 aspect ratio (height/width = 9/16 * 100%) */
}
.video-container iframe {
position: absolute;
top: 0;
left: 0;
width: 100%;
height: 100%;
}
</style>
page.md模版,仅供参考
1 |
|
更多功能
1 新建文章
1.1 新建博文命令
1 | hexo new 这是一篇新的博文 #创建一篇新的博文 |
1.2 新建标签页命令
1 | hexo new page 新建的标签页 |
2 文章置顶
2.1 安装插件
1 | npm install hexo-generator-topindex --save |
2.2 设置置顶
给需要置顶的文章加入top参数,如下:
1 |
|
如果存在多个置顶文章,top后的参数越大,越靠前。
3. 开启本地搜索
3.1 安装插件
你需要安装hexo-generator-search
,根据它的文档去做相应配置
1 | npm install hexo-generator-search --save |
3.2 设置主题配置文件
1 | local_search: |
参数 | 解释 |
---|---|
enable | 是否开启本地搜索 |
preload | 预加载,开启后,进入网页后会自动加载搜索文件。关闭时,只有点击搜索按钮后,才会加载搜索文件 |
CDN | 搜索文件的 CDN 地址(默认使用的本地链接) |
参考资料
https://docs.anheyu.com/initall.html
https://www.fomal.cc/posts/4aa2d85f.html
https://github.com/anzhiyu-c/hexo-theme-anzhiyu/blob/dev/README.md?plain=1
https://blog.csdn.net/COCO56/article/details/103840966