Skip to content

Releases: volantis-x/hexo-theme-volantis

1.5.1

23 Feb 10:02
Compare
Choose a tag to compare
  • 优化一些样式。

1.5.0

09 Mar 17:33
Compare
Choose a tag to compare

日期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

09 Mar 17:33
Compare
Choose a tag to compare

更新与优化

  • 升级插件: 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

19 Feb 05:15
Compare
Choose a tag to compare
  • 新增Meta库配置。原分享按钮、日期格式转移到Meta库配置中。
  • 服务开关中增加aplayer: true音乐开关。Aplayer组件升级到1.10,Meting升级到2.0
  • 友链头像占位图转移到友链页面的Front-matter中。

1.3.0

09 Mar 17:33
Compare
Choose a tag to compare

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_depthmax_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:

  1. disdf
  2. 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: ''

1.2.7

09 Feb 13:49
Compare
Choose a tag to compare
  • H2和H3标题高度现在可以自定义了,相关字段在source/less/_layout.less中。
  • 增加algolia搜索支持、搜索框特效。(由@inkss提供)
  • 增加了字数统计、阅读时长信息。(由@TRHX提供)
  • 代码块识别C++。(由@Linhk1606提供)

1.2.6

26 Nov 09:47
Compare
Choose a tag to compare
  • 主题CDN默认关闭,开启方法:在根目录中添加:use_cdn: true
  • 修复了友链页面不填写url时渲染出错的问题。
  • 主题配置文件新增了footer_post字段,可以在文章结尾统一添加页脚,支持markdown语法,可以用于设置打赏图片。

1.2.5

31 Oct 08:26
Compare
Choose a tag to compare
  • Valine版本升级到1.3.10
  • 加深部分导航栏字体颜色
  • 修复Disqus样式错误问题

1.2.4

06 Sep 08:55
Compare
Choose a tag to compare
  • 优化meta以及2、3级标题样式
  • 宽屏幕下导航栏不再显示TOC按钮
  • 优化侧边栏自定义方式(新增layout字段专门用于描述页面模块自定义,侧边栏配置widgets专注于配置)

1.2.3

02 Sep 03:00
Compare
Choose a tag to compare
  • 优化css样式
  • 可设置归档页面文章标题后面的图标颜色
  • 优化Front-matter中的作者信息