# 开始使用

# 主题简介

Fluid 是基于 Hexo 的一款 Material Design 风格的主题,由 Fluid-dev (opens new window) 负责开发与维护。

主题 GitHub: https://github.com/fluid-dev/hexo-theme-fluid (opens new window)

预览网站:Fluid's Blog (opens new window) zkqiang's blog (opens new window)

# 安装主题

# 搭建 Hexo 博客

如果你还没有 Hexo 博客,请按照 Hexo 官方文档 (opens new window) 进行安装、建站。

# 获取最新版本

# 方式一

Hexo 5.0.0 版本以上,推荐通过 npm 直接安装,进入博客目录执行命令:

npm install --save hexo-theme-fluid

然后在博客目录下创建 _config.fluid.yml,将主题的 _config.yml (opens new window) 内容复制过去。

# 方式二

下载 最新 release 版本 (opens new window) 解压到 themes 目录,并将解压出的文件夹重命名为 fluid

# 指定主题

如下修改 Hexo 博客目录中的 _config.yml

theme: fluid  # 指定主题

language: zh-CN  # 指定语言,会影响主题显示的语言,按需修改

# 创建「关于页」

首次使用主题的「关于页」需要手动创建:

hexo new page about

创建成功后修改 /source/about/index.md,添加 layout 属性。

修改后的文件示例如下:

---
title: about
date: 2020-02-23 19:20:33
layout: about
---

这里写关于页的正文,支持 Markdown, HTML

# 更新主题

# 方式一

TIP

适用于通过 Npm 安装主题。

在博客目录下执行命令:

npm update --save hexo-theme-fluid

# 方式二

TIP

适用于通过 Release 压缩包安装主题,且没有自行修改任何代码的情况(配置文件除外)。

  1. 将自己的配置文件备份(如果完整使用覆盖配置功能可忽略此步骤);

  2. 将 fluid 文件夹全部删除,重新下载 release (opens new window) 并解压;

  3. 如果某些配置发生了变化(改名或弃用),release 的说明里会特别提示,同步修改原配置文件即可。

# 方式三

TIP

适用于自定义了一些代码,或想体验 master 分支的情况。

  1. 确定自己的 fluid 目录已经开启 git,并且所有改动都已 commit;

  2. 把 fluid 仓库的 master 分支拉取到自己的分支上(可新建一个分支再拉取):

git pull https://github.com/fluid-dev/hexo-theme-fluid.git master
  1. 解决代码冲突,保留自己修改的部分(如何解决冲突可自行搜索)。

# 微信交流群

查看微信群二维码 (opens new window)

# 开源协议

MIT (opens new window)