Hello World

Sep 29, 2022#hello #FixIt69

AI-generated summary

The document is a guide for getting started with the Hugo FixIt theme. It includes instructions on prerequisites (Go and Hugo version >= 0.112.0), how to use the template by creating a GitHub repository, and commands to launch and build the site in both development and production environments. It also provides commands for updating the theme and running local debugging servers via NPM scripts. Feedback is encouraged through issues or discussions.

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.

{{< link href="https://fixit.lruihao.cn/documentation/" content="All Documentation - FixIt" title="documentation of FixIt Theme" card=true >}}

Quick Start#

For a complete quick start, see this page.

Prerequisites#

Go
Hugo: >= 0.112.0 (extended version)

Use this Template#

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

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

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

Launching the Site#

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

Build the Site#

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

hugo

Update Theme#

Afterwards you can upgrade the theme with the following command:

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

Start via NPM script

# 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.