站点图标又称站点icon(favicon.ico) 修改主题配置文件_config.butterfly.yml：

头像即是首页个人卡片处展示的自己的头像 修改主题配置文件_config.butterfly.yml：

在访问系统首页时，出现的封面图片 修改主题配置文件_config.butterfly.yml：

当没有在front-matter设置top_img和cover的情况下会显示该图 修改主题配置文件_config.butterfly.yml：

修改主题配置文件_config.butterfly.yml：

修改主题配置文件_config.butterfly.yml：

修改主题配置文件_config.butterfly.yml：

每篇文章都可以设置一张封面，可以为每篇文章设置默认封面 修改主题配置文件_config.butterfly.yml：

也可以修改每个md文件的front-matter的cover属性，会覆盖上面的默认封面。

配置了该属性后会替换无法展示的图片 修改主题配置文件_config.butterfly.yml：

要为 Butterfly 配上字数统计特性，你需要如下几个步骤:

主页文章节选，也就是文章摘要 修改主题配置文件_config.butterfly.yml：

只能选择一个分享服务商

访问 AddThis 官网, 找到你的 pub-id 修改主题配置文件_config.butterfly.yml：

如果你不知道 sharejs，到官网看看说明吧。 修改主题配置文件_config.butterfly.yml：

可以到 addtoany 查看使用说明。 修改主题配置文件_config.butterfly.yml：

从 3.0.0 开始，开启评论需要在 comments-use 中填写你需要的评论。 支持双评论显示，只需要配置两个评论（第一个为默认显示） 修改主题配置文件_config.butterfly.yml：

注册 disqus，配置你自己的 disqus，然后在 Butterfly 里开启它。 修改主题配置文件_config.butterfly.yml：

与 Disqus 一样，但由于 Disqus 在中国大陆无法访问， 使用 Disqusjs 可以在无法访问 Disqus 时显示评论。具体可参考 Disqusjs。 修改主题配置文件_config.butterfly.yml：

注册来必力，配置你自己的来必力设置，然后在 Butterfly 里开启它。 修改主题配置文件_config.butterfly.yml：

遵循 gitalk 的指示去获取你的 github Oauth 应用的 client id 和 secret 值。以及查看它的相关配置説明。 修改主题配置文件_config.butterfly.yml：

遵循 Valine 的指示去配置你的 LeanCloud 应用。以及查看相应的配置説明。 修改主题配置文件_config.butterfly.yml：

Valine 于 v1.4.5 开始支持自定义表情，如果你需要自行配置，请在 emojiCDN 配置表情 CDN。 同时在 Hexo 工作目录下的 source/_data/ 创建一个 json 文件 valine.json, 等同于 Valine 需要配置的 emojiMaps，valine.json 配置方式可参考如下

与 Gitalk 一样，基于 GitHub issues 的评论工具。相对于 Gitalk, 其相对需要权限较少。具体配置可参考 Utterances。 修改主题配置文件_config.butterfly.yml：

Facebook Comments 是 Facebook 提供的评论插件，需要登陆 Facebook 才可评论。 修改主题配置文件_config.butterfly.yml：

从 3.0 开始，Butterfly 主题内置了 4 种在綫聊天工具。你可以选择开启一种，方便你与访客的交流。 通用设置 这些工具都提供了一个按钮可以打开 / 关闭聊天窗口。 主题也提供了一个集合主题特色的按钮来替换这些工具本身的按钮，这个聊天按钮将会出现在右下角里。 你只需要把 chat_btn 打开就行。 修改主题配置文件_config.butterfly.yml：

配置 chatra, 需要知道 Public key,打开 chatra 并注册账号。你可以在 Preferences 中找到 Public key 修改主题配置文件_config.butterfly.yml：

chatra 的样式你可以 Chat Widget 自行配置

配置 tidio, 需要知道 Public key, 打开 tidio 并注册账号。你可以在 Preferences > Developer 中找到 Public key [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-1kAQbcOv-1610953945168)(https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/hexo-theme-butterfly-docs-chat-tidio-id.png)] 修改主题配置文件_config.butterfly.yml：

tidio 的样式你可以 Channels 自行配置

打开 daovoice 并注册帐号,找到你的 app id 修改主题配置文件_config.butterfly.yml：

可在聊天设置里配置聊天按钮等样式 [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-D2SXdFqw-1610953945174)(https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/hexo-theme-butterfly-docs-chat-daovoice-demo.png)]

打开 Gitter 并注册帐号,创建一个 community 或者 room, 复製名称到设置去 修改主题配置文件_config.butterfly.yml：

打开 crisp 并注册帐号,找到需要的网站 ID [外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-IaJvfeoi-1610953945180)(https://cdn.jsdelivr.net/gh/jerryc127/CDN/img/hexo-theme-buttefly-docs-chat-crisp.pngg)] 修改主题配置文件_config.butterfly.yml：

主题已集成谷歌广告（自动广告） 修改主题配置文件_config.butterfly.yml：

主题预留了三个位置可供插入广告，分别为主页文章 (每三篇文章出现广告)/aside 公告之后 / 文章页打赏之后。，把 html 代码填写到对应的位置 修改主题配置文件_config.butterfly.yml：

例如：

如果需要搜索引擎收录网站，可能需要登录对应搜索引擎的管理平台进行提交。 各自的验证码可从各自管理平台拿到 修改主题配置文件_config.butterfly.yml：

可以修改大部分 UI 颜色 修改主题配置文件_config.butterfly.yml：

默认显示白色，可设置图片或者颜色 修改主题配置文件_config.butterfly.yml：

留意: 如果你的网站根目录不是’/‘, 使用本地图片时，需加上你的根目录。 例如：网站是 https://yoursite.com/blog, 引用一张 img/xx.png 图片，则设置 background 为 url (/blog/img/xx.png) background: url(https://i.loli.net/2019/09/09/5oDRkWVKctx2b6A.png)

footer 的背景会与 top_img 的一致，当设置 false 时，将与主题色一致。 修改主题配置文件_config.butterfly.yml：

打字效果 activate-power-mode 修改主题配置文件_config.butterfly.yml：

好看的彩带背景，可设置每次刷新更换彩带，或者每次点击更换彩带 修改主题配置文件_config.butterfly.yml：

相关配置可查看 canvas_ribbon

好看的彩带背景，会飘动 修改主题配置文件_config.butterfly.yml：

好看的星空例子特效，会飘动 修改主题配置文件_config.butterfly.yml：

zIndex 建议只在 -1 和 9999 上选 -1 代表烟火效果在底部 9999 代表烟火效果在前面 修改主题配置文件_config.butterfly.yml：

修改主题配置文件_config.butterfly.yml：

修改主题配置文件_config.butterfly.yml：

会改变 ol、ul、h1-h5 的样式 field 配置生效的区域

未开启美化 开启美化

可自行设置字体的 font-family 如不需要配置，请留空 修改主题配置文件_config.butterfly.yml：

可自行设置字体的 font-family 如不需要配置，请留空 如不需要使用网络字体，只需要把 font_link 留空就行 修改主题配置文件_config.butterfly.yml：

可设置主页中显示的网站副标题或者喜欢的座右铭。 修改主题配置文件_config.butterfly.yml：

默认的显示为全屏。site-info 的区域会居中显示 修改主题配置文件_config.butterfly.yml：

注意：index_top_img_height 的值不能使用百分比。 2 个都不填的话，会使用默认值

当进入网页时，因为加载速度的问题，可能会导致 top_img 图片出现断层显示，或者网页加载不全而出现等待时间，开启 preloader 后，会显示加载动画，等页面加载完，加载动画会消失。 修改主题配置文件_config.butterfly.yml：

PWA简单来说就是让网站有App体验,要为 Butterfly 配上 PWA 特性，你需要如下几个步骤:

更多内容请查看 hexo-offline 的官方文档

你也可以通过 Web App Manifest 快速创建 manifest.json。（Web App Manifest 要求至少包含一个 512*512 像素的图标）

修改主题配置文件_config.butterfly.yml：

修改主题配置文件_config.butterfly.yml：

Snackbar 弹窗，根据自己爱好开启 修改主题配置文件_config.butterfly.yml：

未开启 已经开启

很多人使用 hexo-douban 这款插件。但是该插件是直接生成相应的网页，而不会去读取对应的 markdown 文件。因此，可在设置里进行相应的配置。 修改主题配置文件_config.butterfly.yml：

由于豆瓣开启了反盗链，因此，一些浏览器（safari）会无法显示图片，可把 meta 设为 true。但此操作会导致一些插件失效（例如：不蒜子）。

当用户点击链接，通过 ajax 更新页面需要变化的部分，然后使用 HTML5 的 pushState 修改浏览器的 URL 地址。 这样可以不用重复加载相同的资源（css/js）， 从而提升网页的加载速度。 修改主题配置文件_config.butterfly.yml：

如想添加额外的 js/css/meta 等等东西，可以在 Inject 里添加，支持添加到 head ( 标籤之前) 和 bottom ( 标籤之前)。 请注意：以标準的 html 格式添加内容 修改主题配置文件_config.butterfly.yml：

留意: 如果你的网站根目录不是’/‘, 使用本地图片时，需加上你的根目录。 例如：网站是 https://yoursite.com/blog, 引用 css/xx.css，则设置为