中文简体 | English

Fluid

一款 Material Design 风格的主题

演示

Rook1e's blog

zkqiang's blog

公告

⚠️ 本公告面向老用户，新用户可忽略。

从 v1.4.0 版本开始，本项目正式更名为 Fluid (原项目名：Material-T)，并将仓库和归属转移至 Fluid-dev 组织，因此 git remote url、主题目录名、相关代码 会有变化。

如果您要升级到 v1.4.0，建议按如下操作：

1. 解压 release 包后重命名为 fluid （建议使用 master 分支的用户重新 clone）
2. 将博客根目录 _config.yml 配置修改 theme: fluid
3. 将原 Material-T 的 _config.yml 被修改部分复制过来，或按「配置」使用覆盖配置功能。

给各位带来的不便敬请谅解。

快速开始

1. 获取最新版本

请优先下载 最新 release 版本，master 分支无法保证稳定。

下载后解压到 themes 目录下并重命名为 fluid。

2. 必要的配置

按如下内容修改 Hexo 根目录中的 _config.yml

# 设置语言，需要对应下面目录内的文件名，可以自定义文件内容
# https://github.com/fluid-dev/hexo-theme-fluid/tree/master/languages
language: zh-CN

# 关闭默认的代码高亮
highlight:
  enable: false

3. 启用主题

依然是根目录中的 _config.yml，如下修改：

# Extensions
theme: fluid

配置

v1.4.0 版本开始，可以进入博客根目录的 source 目录下（不是主题的 source 目录），创建 _data 目录，在里面创建 fluid_config.yml 文件。将 /theme/fluid/_config.yml 中被修改的或者所有配置项复制到 /source/_data/fluid_config.yml 中。这样 fluid_config.yml 中配置项会在 hexo g 时自动覆盖，并且更新主题后不会丢失。

v1.5.0 版本开始，所有资源引用可以通过 _static_prefix 来自定义（这意味着您可以使用 cdnjs、jsDelivr 或您自己的 CDN 服务器加速资源加载）。同样也支持 _data/fluid_static_prefix.yml 自动覆盖 /theme/fluid/_static_prefix.yml。

其他情况，建议更新前备份 /theme/fluid/_config.yml 和您自定义的文件，以免更新后丢失。

常见问题

代码高亮效果异常

• 请确认已完成上述『关闭默认的代码高亮』步骤
• 尝试清除命令 hexo clean && hexo g

配置无效

• 请检查配置文件是否符合 yml 语法，如冒号后需要有空格，缩进需要 2 个空格等

文档

详细配置

更新日志

文章配置

参与开发

如果您是初次贡献，可以先从 help wanted 列表中认领一个比较小的任务来快速参与社区贡献。您可以直接在相应 issue 中回复参与意愿，然后参照下面的 GitHub 工作流指引解决 issue 并按照规范提交 PR，通过 review 后就会被 merge 到 master 分支。

推荐使用以下工作流参与贡献：

1. 将仓库 fork 到自己的 GitHub，并 clone 到本地进行开发
2. 创建新的分支，在新的分支上开发
3. 保持分支与远程 develop 分支一致（通过 fetch 和 rebase 操作）
4. 在本地提交变更（注意 commit log 保持简练、规范）
5. 将提交 push 到 fork 的仓库下
6. 创建一个 pull request 到 fluid-dev/hexo-theme-fluid 的 develop 分支

贡献者

非代码贡献：@zhugaoqi

开源协议

MIT