Releases: volantis-x/hexo-theme-volantis
Releases · volantis-x/hexo-theme-volantis
1.5.1
1.5.0
日期meta
日期meta可设置标题
type改为group
为便于理解,type
改为group
copyright
调整copyright
中的间距
是否使用blockquote
meta库增加自定义按钮
---
meta:
footer: [links]
links:
repo: 源码
feedback: 反馈
source: 原文
bug: BUG
idea: 建议
question:
faq: FAQ页面
---
meta:
links:
repo:
icon: 图标
title: 标题
color: 按钮颜色
url: 默认URL
关闭导航栏滑动
可设置导航栏不上下滑动,设置页面的front-matter:
---
layout: page
---
可选阴影和毛玻璃
############################### 主题样式 ###############################
style:
# 卡片阴影效果
shadow:
# 导航栏阴影
nav: true
# 卡片阴影和悬浮动画
# card: true
# 毛玻璃效果 具体效果调整在: source/less/_color.less
blur:
nav: true
widget: true
body: true
# 建议:
# 有背景图:开启毛玻璃,关闭卡片阴影
# 无背景图:关闭毛玻璃,开启卡片阴影
支持多列布局
layout:
# 多列布局
multiple_columns: false # 部分浏览器不兼容,谨慎使用
部分浏览器效果互斥,😅我选择Chrome优先,谨慎使用。
1.4.0
更新与优化
- 升级插件:
instant.page 3.0.0
- 优化文章显示效果,使布局更加紧凑
可选毛玻璃效果
# 毛玻璃效果 具体效果调整在: source/less/_color.less
blur:
nav: true
widget: true
取消音乐小部件,统一显示在网页底部
# APlayer配置 https://github.com/metowolf/MetingJS
aplayer:
# 是否启用,注释此项则不加载服务
enable: true
# 必选参数
server: netease # netease, tencent, kugou, xiami, baidu
type: playlist # song, playlist, album, search, artist
id: 3175833810 # song id / playlist id / album id / search keyword
# 可选参数
fixed: false # enable fixed mode
theme: '#1BCDFC' # main color
autoplay: false # audio autoplay
order: list # player play order, values: 'list', 'random'
loop: all # player loop play, values: 'all', 'one', 'none'
volume: 0.7 # default volume
list_max_height: 340px # list max height
list_folded: true
调整导航栏菜单的配置
# 导航栏
navbar:
# 左侧logo区
logo:
# 显示图片,使用图片时将不会显示icon和title
img: # https://cdn.jsdelivr.net/gh/xaoxuu/[email protected]/apple-touch-icon.png
# 显示图标
icon: fas fa-home
# 显示标题
title: XAOXUU
# logo后面的导航菜单
menu:
# 在桌面端显示的导航菜单
on_desktop:
- name: 近期
icon: fas fa-hourglass-half
url: /
target: _self
...
# 手机端导航菜单(从右上角的按钮点击展开)
on_mobile:
- name: 近期文章
icon: fas fa-clock
url: /
...
1.3.1
1.3.0
Hexo升级到4.2
- 建议旧版本的用户升级到Hexo4.2
- 新版Hexo不支持HTML标签和markdown混写了,所以以前的
需要修改为:
<fancybox>![](https://cdn.jsdelivr.net/gh/xaoxuu/assets@master/avatar/avatar.png)</fancybox>
<fancybox><img src='https://cdn.jsdelivr.net/gh/xaoxuu/assets@master/avatar/avatar.png'></fancybox>
新增功能
标签云设置
现在可以设置标签云的字号、颜色
TOC设置
- 现在可以设置TOC的列表是否显示章节数字
min_depth
和max_depth
对应H1~H6,推荐最大范围为2~5(默认值)。
字段修改
blogger
- 由于支持多个作者在同一个博客站点中发布文章,所以将作者和博主的概念区分清楚:
- 原侧边栏组件
author
,其义为博主,因此更名为blogger
author
指文章的作者。
- 原侧边栏组件
footer
- 原有的网页最底部的
footer
字段改名为copyright
- 原有的文章页脚文字
footer_post
删除,通过新的小部件实现,详见下方关于小部件的部分。
music
- 小部件中的music中原有的
id
重名,改为mid
,新的id
指的是小部件的唯一标识。
layout
- 为了避免歧义,主题配置文件中
layout
部分字段名进行了修改。 layout
中除了meta
下的字段外,全部对应于组件库widget
中的id
组件库优化
- 原有的组件库只能按类排序,同一类型的多个组件只能连续同时出现,现在通过
id
来控制具体的某个小部件。 - 组件的
id
自己命名,建议使用全英文表示。 - 组件的
class
表示组件的类,相当于原来的widget:
,对应/_widget/
中的文件名。 - 自己新增组件:根据需求确定组件的类型,然后起个不重名的
id
。 - 原有的
plain
更名为text
。
组件可选类型
# 文本控件(支持markdown)
class: text
# 列表控件
class: list
# 网格控件
class: grid
版权说明和打赏
这部分内容通过组件的方式实现,方便自己调整顺序和数量。
其中,copyright
只能用于文末位置,即只能写在layout.on_page.footer
中。donate
则可以以侧边栏小部件的形式独立存在,即可以写在layout
中除了meta
之外的任意位置。
通过插件实现container和checkbox
::: info
here be info
:::
::: warning
here be warning
:::
::: success
here be success
:::
::: danger
here be danger
:::
checkbox:
- 未完成
- 已完成
ul:
- sd
- sdf
ol:
- disdf
- sdfds
实现方法
建议使用hexo-renderer-markdown-it
及其插件
"hexo-renderer-markdown-it": "^4.0.0",
"markdown-it-abbr": "^1.0.4",
"markdown-it-checkbox": "^1.1.0",
"markdown-it-container": "^2.0.0",
"markdown-it-deflist": "^2.0.3",
"markdown-it-emoji": "^1.4.0",
"markdown-it-footnote": "^3.0.2",
"markdown-it-imsize": "^2.0.1",
"markdown-it-ins": "^3.0.0",
"markdown-it-mark": "^3.0.0",
"markdown-it-regexp": "^0.4.0",
"markdown-it-sub": "^1.0.0",
"markdown-it-sup": "^1.0.0",
"markdown-it-task-checkbox": "^1.0.6"
在根目录的配置文件中添加:
markdown:
render:
html: true
xhtmlOut: false
breaks: true
linkify: true
typographer: true
quotes: '“”‘’'
plugins:
- markdown-it-abbr
- markdown-it-footnote
- markdown-it-ins
- markdown-it-sub
- markdown-it-sup
- markdown-it-deflist
- markdown-it-imsize
- markdown-it-mark
- markdown-it-regexp
- markdown-it-task-checkbox
- name: markdown-it-container
options: success
- name: markdown-it-container
options: info
- name: markdown-it-container
options: warning
- name: markdown-it-container
options: danger
- markdown-it-deflist
- name: markdown-it-emoji
options:
shortcuts: {}
anchors:
level: 2
collisionSuffix: ''
permalink: false
permalinkClass: 'header-anchor'
permalinkSide: 'left'
permalinkSymbol: '¶'
case: 0
separator: ''