How to deploy hexo to github

Hexo is a very excellent static blog generator. It can help users quickly build a blog website, and it supports a variety of themes and is very flexible.

So how to deploy Hexo to Github? Below I will introduce this process in detail to you.

1. Preparation

1. Register a Github account

If you don’t have a Github account, you need to register one first. Github official website: https://github.com/

2. Install Git

Hexo To upload the generated blog to Github, you need to use Git for code management and submit. Therefore, Git needs to be installed.

On Windows, you can download the latest version of the installation program from the Git official website https://git-scm.com/.

On Linux, you can directly use the yum or apt-get command to install.

3. Installing Node.js

Hexo is developed based on the Node.js language, so the Node.js runtime environment needs to be installed.

Download and install the latest version from the Node.js official website https://nodejs.org/.

2. Hexo blog initialization

1. Installation Hexo

Open the command line tool and enter the following command to install:

npm install -g hexo-cli

2. Initialize Hexo

Create a new empty directory to store the blog. After entering the directory, enter the following command on the command line to initialize:

hexo init

3. Install plug-in

After the initialization is completed, you need to install a plug-in to support the generation and display of blogs. Commonly used plug-ins are as follows:

• hexo-deployer-git: used to publish locally generated websites to Github.
• hexo-generator-sitemap: used to generate sitemap.
• hexo-generator-baidu-sitemap: used to generate Baidu included sitemap.
• hexo-renderer-pug: used to support Pug template engine rendering.

Enter the following command on the command line to install:

npm install hexo-deployer-git --save
npm install hexo-generator-sitemap --save
npm install hexo-generator-baidu-sitemap --save
npm install hexo-renderer-pug --save

3. Hexo configuration

1. Website configuration

Yes Configure the basic information of the website in the _config.yml file, such as the website's title, author, language, theme, etc.

2. Themes

Hexo has many themes to choose from, which can be viewed on the official website https://hexo.io/themes/. Commonly used themes are as follows:

• hexo-theme-next: A very popular theme that supports a variety of configuration items.
• hexo-theme-matery: Another excellent theme with great visual effects.

After downloading the theme locally, you can install it through the command line:

git clone https://github.com/theme-next/hexo-theme-next themes/next

3. Deployment configuration

In the _config.yml file Find the deployment part and make relevant configurations as follows:

deploy:
  type: git
  repository: git@github.com:username/username.github.io.git
  branch: master

Among them, type is the deployment type, repository is the Github warehouse address, and branch is the Github branch. Just replace username in the repository with your own Github username.

4. Generate a blog and upload it to Github

1. Generate blog

Enter the following command in the command line to generate a blog:

hexo g

2. Local Preview

After generating the blog, you can preview it locally and enter the following command to start the local service:

hexo s

Then enter http://localhost in the browser: 4000 to preview the blog.

3. Upload blog

Enter the following command in the command line to upload the blog to Github:

hexo d

After the upload is successful, enter https in the browser You can access the blog at ://username.github.io.

If this is the first upload, you need to enter your Github username and password.

5. Summary

Through the above steps, we can quickly deploy the blog built by Hexo to Github.

During use, you can put the Hexo blog source code on Github for backup and version management to facilitate future blog iteration and maintenance. At the same time, Github Pages is also a very good blog hosting platform, and you can enjoy free hosting services.

If you encounter problems during the blog building process, you can check the documentation on the Hexo official website https://hexo.io/ and the theme warehouse on Github, or you can go to the Hexo official forum https://bbs.hexo .io/ for discussion and help.

The above is the detailed content of How to deploy hexo to github. For more information, please follow other related articles on the PHP Chinese website!