前言

commit info 的开头必须是THEMES

image-20241103192719821

方便查找相关修改

主题适配

butterfly文档中有说明的部分

支持简繁切换-2024.11.4

  • 修改内容
    添加简繁转换按钮

  • 具体修改
    THEMES ADD TRANSLATE CHINESE

  • _config.butterfly.yml中修改如下
    Butterfly 文檔(三) 主題配置 | Butterfly

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    # 简繁转换设置
    translate:
      # 是否启用简繁转换
      enable: false
      # 按钮文本
      default: 繁
      # 网站语言（1 - 繁体中文 / 2 - 简体中文）
      defaultEncoding: 2
      # 转换延迟
      translateDelay: 0
      # 按钮在简体中文时的文本
      msgToTraditionalChinese: '繁'
      # 按钮在繁体中文时的文本
      msgToSimplifiedChinese: '简'

    image-20241104084137477

支持主页默认文章贴图-2024.11.4

  • 修改内容

    添加默认文章贴图，贴图左右交替显示

  • 具体修改
    THEMES ADD DEFAULT COVER

  • _config.butterfly.yml中修改如下

    image-20241105000137020

侧边栏内容修改-2024.11.5

  • 修改内容
    修改_config.butterfly.yml中的aside部分内容。

  • 具体修改

    THEMES CHANGE BUTTERFLY_YML ASIDE

  • 修改内容部分截图如下
    image-20241105235949860

更换头像和顶部图片-2024.11.6

  • 修改内容
    修改_config.butterfly.tml中的部分选项，以及在theme主题文件夹中添加图片

  • 具体修改

    THEMES CHANGE TOP IMG

配置副标题为每日一句-2024.11.7

  • 修改内容
    修改_config.butterfly.yml中的部分选项，以及修改subtitle.pug代码，配置默认不循环
  • 具体修改
    THEMES ADD SUBTITLE
  • subtitle.pug中修改如下：
    image-20241107002502819

设置菜单选项卡和页脚时间-2024.11.7

  • 修改内容
    *修改_config.butterfly.yml中的menu选项。

  • 具体修改
    THEMES SET MENU

  • _config.butterfly.yml中修改如下：

    image-20241107230002753

设置网站字数显示——2024.11.10

Butterfly 文檔(三) 主題配置 | Butterfly

  • 修改内容
    修改_config.butterfly.yml中的wordcount选项。
  • 具体修改
    THEME START WORDCOUNT STATISTICS

设置图片大图查看

Butterfly 文檔(三) 主題配置 | Butterfly

  • 具体修改
    THEMES PICTURE LIGHTBOX
  • 详细修改
    image-20241110153720371

更新部分配置

THEMES SET PART SETTING

修改主页布局

Butterfly 文檔(三) 主題配置 | Butterfly

  • 详细修改
    image-20241111211945784

修改主页文章节选

Butterfly 文檔(三) 主題配置 | Butterfly

  • 详细修改
    image-20241111212316198

开启文章置顶

设置文章过期提醒

  • 详细修改
    image-20241111213153297

设置背景特效——动态彩带

  • 详细修改image-20241111214151394

设置页面元数据显示

主题修改

butterfly文档中没有说明，靠百度和自己YY

字体族修改-2024.11.3

  • 修改内容
    将网站所有字体修改为ZhuZiAWan字体

  • 具体修改
    THEMES CHANGE font to ZhuZiAWan

  • _config.butterfly.yml中修改如下

    image-20241103193758387

  • a. 可以考虑代码字体和内容字体进行区分【WAITING】

  • b. 可以考虑能不能自己diy代码块主题(vscode panda主题挺好)【WAITING】
    自定義代碼配色 | Butterfly

Q: 文件夹fonts前面不可加_-2024.11.6

  • 修复内容
    将fonts文件夹前面的_删除，修改相关文件，直接使用链接吧，没看懂:cry:

  • 具体修改
    THEMES FIX FONTS

同系列文章显示-2024.11.03

  • 修改内容
    添加同系列文章在最开头显示的功能

  • 具体修改
    THEMES ADD SHOW SERIES

    有如下两种方法

    • 使用buttery主题的series标签外挂
      Butterfly 文档【系列文章标签外挂】
      image-20241104000221698

      使用时需要调用如下标签

      1
      2
      {% series %}
      {% series [series name] %}

    • 添加函数来实现系列文章自动在页面最开头显示

      这里注意，第8行判断的时候是字符串进行比较，不是数组，所以系列应该为字符串，前面不能加-

      1
      2
      3
      4
      5
        >// 这么写
        >series: 树洞
        >// 不要，下面这种写法将会给系列赋值为数组
        >series:
      - 树洞
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      //- themes\butterfly\layout\includes\mixins\showSeries.pug
      mixin showSeries()
      if page.series
          div.post-series
            h3 #{page.series}-系列：
          - let list = site.posts.sort('date', -1)
            - list.each(function(article){
            if article.series == page.series
                - let link = article.link || article.path
              - let title = article.title || _p('no_title')
                li
                a.title(href=url_for(link) title=title)= title
            - })
      1
      2
      3
      4
      5
      6
      7
      8
      9
      //- E:\blog\XiaoLi\themes\butterfly\layout\post.pug
      //- 如果文章存在，且没有设置不显示系列
      if page.series && page.showseries !== false
        //- 如果系列名称不是字符串，则报错
        if ((typeof page.series) !== 'string')
          - console.log('[ERROR] Series must be a string [%s]', page.title)
        else
          include ../mixins/showSeries.pug
          +showSeries(site.all_posts,page.series)

      image-20241103235949012

      image-20241104000150596

hexo生成永久链接-2024.11.5

  • 参考链接
    Hexo 博客生成永久链接 | Ordis’Blog

  • 修改内容

    安装hexo-abbrlink插件，修改_config.yml中的插件配置，以生成${post}.html格式的链接

  • 具体修改
    THEMES ADD PERMANENT LINK

    • 安装插件

      1
      npm install hexo-abbrlink --save

    • 修改插件配置

      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
      # _config.yml中修改如下内容
      # URL
      ## If your site is put in a subdirectory, set url as 'http://example.com/child' and root as '/child/'
      # 网页链接设置
      url: https://limo-bit.github.io/
      root: /
      ## permalink: :year/:month/:day/:title/
      permalink: posts/:abbrlink.html // 2024.11.5 add abbrlink
      permalink_defaults:
      pretty_urls:
        trailing_index: true # Set to false to remove trailing 'index.html' from permalinks
        trailing_html: true # Set to false to remove trailing '.html' from permalinks

      # 2024.11.5 add
      ## abbrlink config
      abbrlink:
        alg: crc32      #support crc16(default) and crc32 进制
        rep: hex        #support dec(default) and hex  算法
        drafts: true   #(true)Process draft,(false)Do not process draft. false(default) 
        ## Generate categories from directory-tree
        ## depth: the max_depth of directory-tree you want to generate, should > 0
        auto_category:
           enable: true  #true(default)
           depth:        #3(default)
           over_write: false 
        auto_title: false #enable auto title, it can auto fill the title by path
        auto_date: false #enable auto date, it can auto fill the date by time today
        force: false #enable force mode,in this mode, the plugin will ignore the cache, and calc the abbrlink for every post even it already had abbrlink.

    • 魔改插件内容，使得插件对自定义布局有效
      THEMES FIX abbrlink invalid

      THEMES FIX abbrlink invalid

本地添加【安知鱼】主题-2024.11.5

使用gitee+PicGo管理图片-2024.11.6

更高级的Markdown渲染器-2024.11.6

支持emoji表情包

hexo——hexo添加emoji表情包

  • 参考链接
    【Hexo】选择更高级的Markdown渲染器_hexo-renderer-marked-CSDN博客

  • 修改内容
    卸载掉原有的npm un hexo-rederer-marked --save,安装npm i hexo-renderer-markdown-it --save
    为了支持拓展功能安装如下插件：

    1
    2
    3
    4
    5
    6
    # 支持复选框
    npm i markdown-it-checkbox
    # 支持图片尺寸重定义
    npm i markdown-it-imsize
    # 支持折叠/展开内容
    npm i markdown-it-expandable

  • 具体修改
    THEMES ADD GREATER MARKDOWN

隐藏文章不在首页显示

hexo——优雅的隐藏文件

2. 修改简述-修改时间

  • 修改内容
  • 具体修改
    commit info

修改引入bug修复

  • TODO

遗留问题

对主题适配和主题修改中TODO项目的修改进行记录

三级级标题为【修改】|【适配】

四级标题为【xx.a】，xx表示问题编号

添加布局

hexo——新增布局