Hugo Theme Bootstrap Skeleton

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

Demo

Platform	URL
Netlify	https://hbs-skeleton.netlify.app/
GitHub Pages	https://razonyang.github.io/hugo-theme-bootstrap-skeleton/
Cloudflare Pages	https://hbs-skeleton.pages.dev/
Docker image	See also Dockerfile

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.

$ export HUGO_MODULE_PROXY=https://goproxy.cn

Please note that, Hugo doesn't respect the GOPROXY env var, please use HUGO_MODULE_PROXY instead.

You can also set the module.proxy instead of using env var.

module:
  proxy: https://goproxy.cn

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 github.com/razonyang/hugo-theme-bootstrap@master
$ hugo mod npm pack
$ npm update
$ git add go.mod go.sum package.json package-lock.json
$ git commit -m 'Update the theme'

You can also replace the master with stable releases.

Deployment

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

This template supports GitHub Pages, Docker image, Netlify out-of-box. See also Deployment for getting more detail.

Documentations

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

command after fresh clone

git submodule update --init
pnpm install
hugo server