hexo-butterfly主题迁移

网站配置

安装

模板的front matter

将以下front matter设置在/scaffolds/post.md中，就可以在hexo new "title"的时候自动加上这些注释了

---
title:
date:
tags:
categories:
keywords:
description:
top:
top_img: （除非特定需要，可以不写）
comments： 是否显示评论（除非设置false,可以不写）
cover:  缩略图
toc:  是否显示toc （除非特定文章设置，可以不写）
toc_number: 是否显示toc数字 （除非特定文章设置，可以不写）
copyright: 是否显示版权 （除非特定文章设置，可以不写）
mathjax:
katex:
hide:
---

音乐界面

想增加QQ音乐和网易云音乐的歌单，可以安装插件hexo-tag-aplayer，需要在站点配置文件_config.yml中增加

aplayer:
  meting: true

如何获取歌单的id呢？网易云音乐把歌单分享出来，链接是 http://music.163.com/playlist?id=472885344&userid=124181546 ，那么id就是472885344。但是注意QQ音乐，只有网页版的分享链接才会有id号。

只需要在md文件中增加以下代码就可以实现歌单效果了

## 我的QQ音乐歌单
{% meting "4274201226" "tencent" "playlist" "mutex:true" "listmaxheight:300px" "preload:auto" "theme:#ad7a86"%}

## 围的网易云歌单
{% meting "472885344" "netease" "playlist" "mutex:true" "listmaxheight:300px" "preload:auto" "theme:#ad7a86"%}

相册

butterfly的Gallery相册会自动根据图片长度进行排版，书写也更加方便，与markdown格式一样。可根据需要插入到相应的md。

{% gallery %}
markdown 图片格式
{% endgallery %}

注意事项

站点配置文件_config.yml中，url那一栏填域名，注意只能填顶级域名，不能填二级域名
hexo升级到4.2之后，hexo_asset_image这个插件就出bug了，原来的作者不维护了，有人出了一个修复后的插件，叫hexo_asset_image_fixed。解决方法是：把原来的插件卸载，用命令npm install hexo-asset-image-fixed安装一下即可
网站文件更新后，访问网址并没有进行更新。这是因为cdn缓存了之前的文件，需要刷新cdn缓存，拿七牛举例，需要在cdn的刷新预期->刷新目录即可
想要用PWA的功能，manifest.json一定不能被渲染了，不然浏览器解析不出来。除了手册说的那些操作外，还需要在站点配置文件_config.yml中增加skip_render: 'manifest.json'。还需要注意的是，配置offline属性的时候，要把html去掉，否则他会把html文件缓存在本地，即使文章更新了也看不到。
hexo g -d会漏掉service-worker.js，以后尽量用hexo g && hexo d