升级stellar 1.25

半年没更新主题了，今天从v1.19.0更新到v1.25.0，发现好多功能都失效了，下面是升级指南。

【严重】Tag Plugins 改名

1. ablock改名为box，tag改名为hashtag，功能不变。
   替换方法：VSCode中转到搜索和替换页面，将{% ablock 替换为 {% box，记得替换结束标签 {% endablock ，其他标签同理。
2. about标签即将废弃，请参考新标签banner。了解详情

【严重】Frontmatter references 格式更改

Frontmatter references 不再使用 标题-连接 的形式，而是直接使用字符串，可以直接写Markdown。

这里需要注意双引号，否则会错误解析为YAML列表引起报错。

1
2
3
4
5

references:
  - title: "A"
    url: "B"
  - title: "C"
    url: "D"

1
2
3

references:
  - "[A](B)"
  - "[C](D)"

配置文件

在_config.stellar.yml中，

• 原配置 sidebar 部分重构，其中的 logo 和 menu 提升一个层级，widgets 转移到 site_tree 中的 sidebar 配置
• 原配置 post-index 和 post_list 移除，现在转移到 site_tree 中的 nav_tabs 配置
• 原配置 wiki_dir 和 author_dir 移除，现在转移到 site_tree 中的 base_dir 部分配置

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

sidebar:
  menu:
    post: '[btn.blog](/)'
    friends: '[关于](/about/)'
  widgets:
    home: welcome, search, recent
    blog_index: welcome, search_blog, recent
    wiki_index: search_docs, recent
    others: welcome, search, recent
    post: toc, search
    wiki: search, toc
    page: toc, search

post-index:
  '首页上方菜单添加项': '/hello'

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

site_tree:
  home:
    sidebar: welcome, search, recent
  blog:
    sidebar: welcome, search_blog, recent
    menu_id: post
    nav_tabs:  # 这里是post-index
      '首页上方菜单添加项': '/hello'
  post:
    menu_id: post
    sidebar: toc, search
  wiki:
    sidebar: search, toc 
  error_page:
    menu_id: post
    "404": "/404.html"
    sidebar: welcome, search, recent
  page:
    sidebar: toc, search

• 原配置 subtitle 从站点配置文件转移到主题配置文件的 logo 中

_config.yml中的description，需要改到_config.stellar.yml:

1
2
3
4

logo:
  avatar: "[config.avatar](/about/)"
  title: "[config.title](/)"
  subtitle: "XXXXXXX | YYYYYYY"

• friends 和 sites 组件使用的 _data/links.yml 文件需要按组拆分成 _data/links/xxx.yml

1
2
3
4

# _data/links.yml
"group1"
  - title: 
    url: 

1
2
3

# _data/links/group1.yml
  - title: 
    url: 

• Grid 重构，原来使用双栏布局的需要删掉<!-- cell right/left -->中的right和left！

一些新功能（不完整）

• 新的标签 audio, video, gallery, poster, album, banner, md
• MathJax Frontmatter 开关 mathjax: boolean
• 文章分享，主题配置文件article.share: [wechat, email, weibo, link]
• 专栏功能 了解详情
• 各种 Tag Plugins 的默认设置
• H1 Frontmatter 隐藏标题 h1: ''
• 支持使用自建的 giscus 服务
• Inject Frontmatter 插入代码
• 一站点多作者

阅读更多，详见更新日志：https://github.com/xaoxuu/hexo-theme-stellar/releases

许可协议

本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。

分享文章