Hexo&Volantis配置记录

准备

准备部分不多赘述了，互联网上很多相关内容。包括：

基本技能

Git
Markdown
检索和阅读文档

配置环境

新建Repository
Node.js环境
下载Hexo
下载主题

配置主题

我使用的主题是 Volantis，相对简介的同时又高度可自定义化。也曾经想过用 NexT这个非常简约黑白风的主题，不过还是选了目前这个。

一般post的 front-matter，包括这些内容

title: 这是标题
date: {{ date }}
archive: false
pin: false
tags: 
- tagA
- tagB
category: 
- 第一层级
- 第二层级
excerpt: 预览

katex: false
comments: true
toc: true
top: false
typora-root-url: {{ title }}

references: 
- title: 引用说明
  url: 引用链接

图片相关

设置Hexo和Typora和使文章可以简单引用图片

参考：https://zhuanlan.zhihu.com/p/265077468

对于图片资源管理，我更喜欢一个文章一个目录。在写文章的时候，更习惯于直接复制，然后通过Typora的偏好设置存到到同名文件夹里面。所以，首先要做的是修改配置文件：

1 2	# _config.yml post_asset_folder: true

但是这会导致一个问题，Hexo的渲染器和一般的Markdown在这种情况下，解析图片的路径会不同。例如，使用 hexo new命令新建 my_post.md，同时创建了 root/source/_posts/my_post的存放图片的文件夹，理论上Markdown引用图片的路径要写 my_post/picture.jpg，但是Hexo接受的是 picture.jpg，这样就不能在Typora里面渲染出来了。

为了达到可渲染+直接粘贴的功能，需要修改 root/scaffolds/post.md的 front-matter，增加一行：

1	typora-root-url: {{ title }}

至此，我们就可以愉快地插入图片了！

网站图标

facicon:正在绘制中……可能会有

作者头像

为了博客，特地自己画了一个，画技很烂但是为了更加独一无二一些，就牺牲了一下个人颜面吧！

文章布局

1
2
3

body:
  top_meta: [author, category, date, counter,wordcount] 
  bottom_meta: [updated, tags, share,wordcount]

网页导航栏

主页
类别
- 分类
- 标签
- 归档
- 文档
更多
- 更新日志
- 友链
- 关于
暗黑模式
搜索框

网页侧边栏

独立界面
- blogger
- category
- tagcloud
- music
文章界面
- toc
- category
- tagcloud
- music

自定义右键菜单

暂无计划

评论系统——giscus

https://giscus.app/zh-CN

https://github.com/giscus/giscus

https://www.michaeltan.org/posts/giscus/

octolytics-dimension-repository_id

自定义插件

KaTex

https://blog.dearxuan.com/2023/01/07/Volantis魔改教程/

https://www.micdz.cn/article/katex-on-volantis/

参考本文修改完成

额外功能

隐藏文章

参考：https://github.com/next-theme/hexo-generator-indexed

https://github.com/volantis-x/hexo-theme-volantis/issues/727