Required Environment

  • Node.js
  • Git

Installation

yarn global add hexo-cli
npm install hexo-cli -g

Creating a Site

hexo init <folder>
cd <folder>
yarn or npm install

After creation, the directory structure of the specified folder is as follows:

.
├── _config.yml
├── package.json
├── scaffolds
├── source
|   ├── _drafts
|   └── _posts
└── themes

Now you can start writing your blog…

Generating Static Files

hexo generate 

Hexo will create a directory for static files according to the public_dir configuration item in the _config.yml file (static files must run in an HTTP server environment). Here you need to set its value to docs, because Github Pages reads static files from the docs directory of the repository by default.

Deployment

yarn add hexo-deployer-git
npm install hexo-deployer-git --save

Configure Deployment Parameters

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repository: [email protected]:USERNAME_OR_ORGNAME/REPOSITORY_NAME.git
  branch: master

Deploy

hexo deploy

You can also deploy directly when generating static files

hexo generate --deploy or hexo deploy --generate

The above two commands produce the same result: first generate static files, then execute the deployment task! For detailed instructions, you can read the official documentation

Next, I will write a blog post about how to set up a custom domain based on Github Pages and enable HTTPS.

I hope this is helpful, Happy hacking…