charlo-o / hexo-theme-fluid Goto Github PK

中文简体 | English

一款 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. 修改主题配置文件，或使用「平滑升级功能」。

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

请优先下载 最新 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 数据文件存放主题配置：

1. 进入博客根目录的 /source/_data/ 目录（注意：不是主题的 source 目录），若 _data 文件夹不存在，请自行创建
2. 创建 fluid_config.yml 文件，并将主题配置文件中被修改的或者所有配置项复制到其中。这样 fluid_config.yml 会在 hexo g 时自动覆盖主题配置，并且不会在更新主题后丢失。
3. 将您自定义的资源文件（head_img、about.md 等）移动到博客根目录的 source 文件夹中（别忘了修改配置文件中对资源的引用地址）
4. (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 根目录的 _config.yml 中高亮已关闭：

highlight:
  enable: false

修改后使用清除命令 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 分支

非 PR 贡献：@zhugaoqi @julydate

MIT

查看微信群二维码