pengantar / bst-skeleton

Hugo Theme Bootstrap Skeleton

The starter template for Hugo Bootstrap Theme, which install the theme as a Hugo module.

Usage

Please make sure you have install the build tools prior to using this template.

1. Clone this repository

$ git clone https://github.com/razonyang/hugo-theme-bootstrap-skeleton.git blog
$ cd blog
$ rm -rf .git
$ git init -b main

The rm -rf .git is a dangerous action, please make sure that you enter the right folder.

2. Modify the go.mod

Replace the following line to yours, such as module github.com/user/repo.

module github.com/razonyang/hugo-theme-bootstrap-skeleton

3. Commit and push changes to your repository

$ git add -A
$ git commit -m 'First commit'
$ git remote set-url origin github.com/user/repo
$ git push origin main

Go Proxy(Optional)

If you're located at China mainland without VPN, the Hugo module download may fail.

There are two proxies for this: GOPROXY.CN and GOPROXY.IO.

$  go env -w GOPROXY=https://goproxy.cn,direct

or

$ go env -w GOPROXY=https://goproxy.io,direct

Server

1. Install dependencies

$ npm i

Generally, this step only needs to be performed once for each local project.

2. Start server

$ hugo server

Upgrade theme

$ hugo mod get -u
$ hugo mod npm pack
$ npm i
$ git add go.mod go.sum
$ git commit -m 'Update the theme'

Deployment

Please make sure you've change the baseURL on /config/production/config.toml before deploying your site.

This template supports Netlify out-of-box. You could find more deployment methods on Hosting & Deployment.

Documentations

• English
• 简体中文
• 繁體中文