Skip to content
🌊 一款 Material Design 风格的 Hexo 主题 / An elegant Material-Design theme for Hexo
JavaScript HTML CSS
Branch: master
Clone or download
zkqiang Merge pull request #79 from fluid-dev/develop
v1.5.0 功能第 2 部分
Latest commit 358d94a Sep 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
languages 🎨 zh_CN 修改为 zh-CN Sep 2, 2019
layout
pages 🎨 规范代码缩进 Sep 5, 2019
scripts about.md 路径可配置 Sep 11, 2019
source 🔥 统一banner_img Sep 13, 2019
.gitignore 🙈 更新.gitignore Aug 3, 2019
Changelog.md about.md 路径可配置 Sep 11, 2019
LICENSE 🍻 更名并迁移至组织 Sep 9, 2019
README.md ⚗️ 更新中英README Sep 14, 2019
README_en.md ⚗️ 更新中英README Sep 14, 2019
_config.yml 🔥 统一banner_img Sep 13, 2019
_static_prefix.yml 🔥 去掉顶部加载进度条 Sep 13, 2019

README.md

中文简体 | English

Fluid

一款 Material Design 风格的主题

GitHub release (latest by date) Hexo version Contributors License

ScreenShot

演示

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 分支

贡献者

contributors

非代码贡献:@zhugaoqi

开源协议

MIT

You can’t perform that action at this time.