Site template for Hexo Next

• Hexo static site generator.
• Fast and elegant Next theme.
• GitHub actions building the website to GitHub pages

Copy over my template site

Hosting GitHub: click use as template

In _config.yml, Change baseurl and your personal settings. See also Hexo configuration.

url: https://username.github.io
root: /repo-name/  # root:/ for personal website (username.github.io)

To enable GitHub pages

Open your repository settings => Pages => GitHub Pages => Build and deployment => Source, Select GitHub actions

Customizations

You can customize the theme settings by editing _config.next.yml. See also Next theme settings.

How to develop (in VSCode)

Clone this repository

git clone git@github.com:sosiristseng/sosiristseng.github.io.git
cd sosiristseng.github.io

Install npm dpendencies with Node package manager (npm).

npm install

Install the Live Server VSCode extension. The settings file .vscode/settings.json already points the website root to the public folder.

If you are using a subdirectory for your site (e.g., This project resides in https://sosiristseng.github.io/template-hexo-next, so template-hexo-next is the subdirectory, corresponding to the root entry in _config.yml), you may need the mount option for the website to work properly.

The option in .vscode/settings.json is:

{
    "liveServer.settings.mount": [
      ["/public", "/template-hexo-next"]
    ],
}

Build the website locally and Hexo will watch for file changes

npm run gwatch

Open Live Server by VSCode command palette (Shift + Command + P (Mac) / Ctrl + Shift + P (Windows/Linux)) and see the built website.