中文简体 | English
一款 Material Design 风格的主题
从 v1.4.0
版本开始,本项目正式更名为 Fluid (原项目名:Material-T),并将仓库和归属转移至 Fluid-dev 组织,因此 git remote url、主题目录名、相关代码 会有变化。
如果您要升级到 v1.4.0
,建议按如下操作:
- 解压 release 包后重命名为
fluid
(建议使用 master 分支的用户重新 clone) - 将博客根目录
_config.yml
配置修改theme: fluid
- 修改主题配置文件,或使用「平滑升级功能」。
给各位带来的不便敬请谅解。
请优先下载 最新 release 版本,master 分支无法保证稳定。
下载后解压到 themes 目录下并重命名为 fluid
。
按如下内容修改 Hexo 根目录中的 _config.yml
# 设置语言,需要对应下面目录内的文件名,可以自定义文件内容
# https://github.com/fluid-dev/hexo-theme-fluid/tree/master/languages
language: zh-CN
# 关闭默认的代码高亮
highlight:
enable: false
依然是根目录中的 _config.yml
,如下修改:
# Extensions
theme: fluid
从 v1.4.0 版本开始可以使用 Hexo 数据文件存放主题配置:
- 进入博客根目录的
/source/_data/
目录(注意:不是主题的 source 目录),若_data
文件夹不存在,请自行创建 - 创建
fluid_config.yml
文件,并将主题配置文件中被修改的或者所有配置项复制到其中。这样fluid_config.yml
会在hexo g
时自动覆盖主题配置,并且不会在更新主题后丢失。 - 将您自定义的资源文件(head_img、about.md 等)移动到博客根目录的
source
文件夹中(别忘了修改配置文件中对资源的引用地址) - (v1.5.0 版本及以上)如果需要使用 CDN 或其他方式存放静态资源:将
_static_prefix.yml
复制到博客根目录的/source/_data/
中,重命名为fluid_static_prefix.yml
并按自己的需求修改配置。若_data/fluid_static_prefix.yml
存在则会自动覆盖/theme/fluid/_static_prefix.yml
。
完成上述步骤后,以后您只需用新的 release 覆盖 /theme/fluid
文件夹即可更新主题。
- 请确认已完成上述『关闭默认的代码高亮』步骤
- 尝试清除命令
hexo clean && hexo g
- 请检查配置文件是否符合 yml 语法,如冒号后需要有空格,缩进需要 2 个空格等
如果您是初次贡献,可以先从 help wanted 列表中认领一个比较小的任务来快速参与社区贡献。您可以直接在相应 issue 中回复参与意愿,然后参照下面的 GitHub 工作流指引解决 issue 并按照规范提交 PR,通过 review 后就会被 merge 到 master 分支。
推荐使用以下工作流参与贡献:
- 将仓库 fork 到自己的 GitHub,并 clone 到本地进行开发
- 创建新的分支,在新的分支上开发
- 保持分支与远程 develop 分支一致(通过 fetch 和 rebase 操作)
- 在本地提交变更(注意 commit log 保持简练、规范)
- 将提交 push 到 fork 的仓库下
- 创建一个 pull request 到 fluid-dev/hexo-theme-fluid 的 develop 分支
非代码贡献:@zhugaoqi