Build a blog with Hexo

, ,

ㅤ

Setup

  1. Install Node.js.

    • MacOS: Download Node.js from https://nodejs.org/. When you install Node.js, npm will be installed automatically.
    • Ubuntu 20.04: Download them from command line. 
      1
      2
      3
      $ sudo apt update
      $ sudo apt install nodejs
      $ sudo apt install npm

  2. When you install Node.js, npm will be installed automatically.

  3. Make sure you have git installed.

  4. Download Hexo’s framework using npm.

    1
    $ sudo npm install -g hexo-cli

Initialization

  1. Make a new folder and navigate to it through terminal.

  2. Initialize a blog with Hexo command line under the folder.

    1
    $ hexo init

  3. Start a local server to host your blog.

    1
    $ hexo server

  4. Now open a browser, and type localhost:4000 in address bar. You will see the blog that you just created!

Host the blog on Github

  1. In order to have others see your blog, you have to find a place to host your blog. Here I suggest using GitHub page, because each Github account can have a free domain ending with github.io.
    npm install hexo-deployer-git --save

  2. Go to Github, create a new repository and name it web-name.github.io (replace web-name with the name that you want). Make sure the repository is public.
    Make a new repo to host blogs

  3. Open _config.yml with your favorite editor, and configure it as follows:

    1
    2
    3
    4
    deploy:
      type: git
      repo: https://github.com/GaoxiangLuo/web-name.github.io.git
      branch: master

  4. Deploy your blog onto Github, login with username and password if being prompted

    1
    $ hexo deploy

  5. Congratulation! You blog has been published at web-name.github.io!

To be continued...