Troubleshooting and FAQ Guide

🐣 We make use of this template called Hextra. Information on getting started with Hextra

Here is a link to the guide here on github

Preview the site locally

if hugo server is installed on your local machine, and you want to test changes out there first, you can use the following command to build a local server on your laptop. On the command line-

$ hugo server --buildDrafts --disableFastRender

Voila! You can see your new site at http://localhost:1313/.

Deployment

GitHub Pages

A GitHub Actions workflow is provided in .github/workflows/pages.yaml to publish to GitHub Pages for free.

For details, see Publishing with a custom GitHub Actions workflow.

Note: in the settings, make sure to set the Pages deployment source to GitHub Actions:

Run the workflow manually if it's not triggered automatically.

Override the configuration:

Local Development

Pre-requisites: Hugo, Go and Git

# Clone the repo
git clone https://github.com/imfing/hextra-starter-template.git

# Change directory
cd hextra-starter-template

# Start the server
hugo mod tidy
hugo server --logLevel debug --disableFastRender -p 1313

Update theme

hugo mod get -u
hugo mod tidy

See Update modules for more details.