Hello World

Welcome to Hugo FixIt! This is your very first post.

Head to the documentation page linked below for a complete guidence to get started with the FixIt theme.

Quick Start

For a complete quick start, see this page.

Prerequisites

• Go
• Hugo (extended version)

Use this Template

1. Click Use this template, and create your repository on GitHub.

   

2. Once the repository is created, just clone and enjoy it!

   1 2	# Clone with your own repository url git clone --recursive https://github.com/<your_name>/<your_blog_repo>.git

Launching the Site

1
2
3
4

# Development environment
hugo server
# Production environment
hugo server -e production

Build the Site

When your site is ready to deploy, run the following command:

1

hugo

Deploy to GitHub Pages

1. Head to Setting => Actions => General => Workflow permissions => Check “Read and write permissions”.
2. Manually run Workflow: Actions => Hugo build and deploy => Click Run workflow button.
3. GitHub Pages settings: Setting => Pages => Source: Deploy from a branch => Branch: gh-pages => Save.

Only need to manually run the Workflow the first time you deploy, and it will be automatically deployed every time you push to the main branch.

Update Theme

Afterwards you can upgrade the theme with the following command:

1
2
3

# Update theme manually
hugo mod get -u github.com/hugo-fixit/FixIt@latest
hugo mod tidy

1
2
3
4
5
6
7
8

# build the blog
npm run build
# run a local debugging server with watch
npm run server
# run a local debugging server in production environment
npm run server:production
# update theme submodules
npm run update:theme

Feedback

Whether it’s questions, ideas, bugs or pull requests, all feedback is welcome!

Head over to the issues or discussions tracker.