Hexo Fluid Docs

# Start

(adsbygoogle = window.adsbygoogle || []).push({});

# Introduction

Developed by Fluid-dev (opens new window), Fluid is an elegant Material-Design theme for Hexo.

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

Preview: Fluid's blog (opens new window) zkqiang's blog (opens new window)

# Quick Start

# Installing Hexo

If you don't have a hexo blog, please follow Hexo Docs (opens new window) to install and initialize your blog.

# Downloading Fluid...

# via npm

Installing directly via Npm is recommended for Hexo version 5.0.0 and above. Run the following command in the blog directory:

npm install --save hexo-theme-fluid

Then create _config.fluid.yml in the blog directory and copy the content of _config.yml (opens new window)

# via releases

Download the latest release (opens new window), then extract it to themes directory and renamed to fluid.

# Setting theme

Edit _config.yml in the blog root directory as follows:

theme: fluid

# Creating the About Page

The about page needs to be created manually:

hexo new page about

Then edit /source/about/index.md under the blog directory and add layout attribute.

The modified example is as follows:

---
title: This is a title
layout: about
---

You can write the content here, with the support of Markdown and HTML

WARNING

layout: about must exist and can not be modified as other values, otherwise avatar and other styles will not be shown.

# Upgrading Fluid via...

# npm

Applicable for npm-installed theme.

Execute the command in your blog directory:

npm update --save hexo-theme-fluid

# files

Applicable for installed theme via release and all codes have not been modified.

  1. Backup your config files. We recommend you to use configuration override.

  2. Download the latest release (opens new window), then replace the fluid directory.

# or if you changed codes

Applicable to cases where some codes have been modified, or you want to pull the master branch.

  1. Make sure your fluid directory has git and all changes have been committed.

  2. Pull the master branch of fluid repo to your branch:

git pull https://github.com/fluid-dev/hexo-theme-fluid.git master
  1. Resolve code conflicts if any.
(adsbygoogle = window.adsbygoogle || []).push({});

# Code License

GPL-V3 (opens new window)