# Hexo+Fluid主题配置

获取最新版本
方式一
Hexo 5.0.0 版本以上，推荐通过 npm 直接安装，进入博客目录执行命令：

npm install –save hexo-theme-fluid
然后在博客目录下创建 _config.fluid.yml，
将主题的 _config.yml (opens new window)内容复制过去。
此方法安装的fluid所在目录
E:\MyBlog\node_modules\hexo-theme-fluid

方式一

适用于通过 Npm 安装主题。

在博客目录下执行命令：

npm update --save hexo-theme-fluid

• 本指南中提到的：”站点配置“ 指的 Hexo 博客目录下的 _config.yml，”主题配置“ 指的是 theme/fluid/_config.yml 或者 _config.fluid.yml ，注意区分；

• 每次无论 hexo g 或 hexo s，都最好先使用 hexo clean 清除本地缓存；

• 页面结果以本地 hexo s 为准，部署后的异常大部分是线上缓存原因，在确认没有报错的情况下，等待若干时间后即可正常；

  全局

  覆盖配置

  Hexo 5.0.0 版本以上的用户，在博客目录下创建 _config.fluid.yml 文件，将主题的 [_config.yml 全部配置（或部分配置）复制过去。

  以后如果修改任何主题配置，都只需修改 _config.fluid.yml 的配置即可。

  注意：

  • 只要存在于 _config.fluid.yml 的配置都是高优先级，修改原 _config.yml 是无效的。
  • 每次更新主题可能存在配置变更，请注意更新说明，可能需要手动对 _config.fluid.yml 同步修改。
  • 想查看覆盖配置有没有生效，可以通过 hexo g --debug 查看命令行输出。
  • 如果想将某些配置覆盖为空，注意不要把主键删掉，不然是无法覆盖的，比如：

页面顶部大图

• 图片来源

主题配置中，每个页面都有名为 banner_img 的属性，可以使用本地图片的相对路径，也可以为外站链接，比如：

指向本地图片：

banner_img: /img/bg/example.jpg   # 对应存放在 /source/img/bg/example.jpg

指向外站链接：

banner_img: https://static.zkqiang.cn/example.jpg

TIP

如果是本地图片，目录文件夹可自定义，但必须在 source 目录下，
博客与主题的 source 目录最终会合并，因此优先选择博客的 source。
图片大小建议压缩到 1MB 以内，否则会严重拖慢页面加载。

• 高度

鉴于每个人的喜好不同，开放对页面 banner_img 高度的控制。

主题配置中，每个页面对应的 banner_img_height 属性，有效值为 0 - 100。100 即为全屏，个人建议 70 以上。

• 蒙版透明度

主题配置中，每个页面对应的 banner_mask_alpha 属性，有效值为 0 - 1.0， 0 是完全透明（无蒙版），1 是完全不透明

TIP

每篇文章可单独设置 Banner，具体见文章页设置

本主题不支持固定背景（fixed），原因：

1.与目前代码结构有较大冲突，需要大量修改
2.fixed 在移动端兼容性很差