How to install Hexo on Github and write a first blog post

How to install Hexo on Github

Hexo is a static website generator. You can use Hexo as a Github blog.
In this post, I’ll let you know how to install Hexo on Github.

Keep the node and npm version up to date before installing Hexo.

• Check node version

  $ node -v

• Check npm version

  $ npm -v

• If node and npm is not latest version, please install latest version of node @ nodejs.org

Hexo installation

• Install hexo-cli using npm gloabally

  $ npm install -g hexo-cli

• (FYI) Check global npm packages installation location

  $ npm root -g

• (FYI) global npm packages intallation location

  C:/Users/user/AppData/Roaming/npm/node_modules

• Create Hexo files inside blog folder

  $ hexo init blog

Github repository and Hexo Deploy Setting

• Create the github respository

  [github-username].github.io

• Set the github repository.
  Modify the _config.yml file as below.

  deploy:
    type: git
    repo: https://github.com/[github-username]/[github-username].github.io.git

Hexo Setting

• If you want to create asset folder for each blog post, please update the _config.yml file below:

  post_asset_folder: true

Write a first hexo blog post

• Create a draft

  $ hexo new draft [title]

• Create a Thumbnail Image

  width * height = 520*245

• Set thumbnail for blog post
  create images folder inside source folder then set the path as blow

  thumbnail: ../images/image.png

• Insert the image on blog post
  If you have an asset folder for each blog post.

  ![](image.png)

• Preview draft

  $ hexo server --draft

• Publish draft

  $ hexo publish

• Preview publish

  $ hexo server

Publish Blog Post

• publish blog post

  $ hexo publish [title]

• Create static files before deploy

  $ hexo generate

• Deploy the static files on Github

  $ hexo deploy