Configuration

Setup and configure Shock.

Install Hugo

Hugo Extended edition is required for this theme. Refer to Hugo’s installation documentation .

Create a new hugo project. Refer to Hugo’s quick start guide .

Verify the project has been initliazed as a git repository.

git init --initial-branch=main

hugo.toml

To use the Shock theme, add a theme configuraton to the hugo.toml file.

theme = 'codeberg.org/aao-fyi/shock'

Configure site info in the hugo.toml file. Refer to the Hugo configuration documentation for project setup. For a working example, refer to Shock’s exampleSite config/hugo.toml file .

# Info
baseURL = 'https://example.com/'
languageCode = 'en-us'
title = 'Example'
copyright = 'Example'

# If you are not using Git: Set enableGitInfo to false.
enableGitInfo = true

params.toml

Set a site description and add other parameters in the params.toml file. Layouts and other components have additional configuration options detailed in their corresponding documentation.

description = 'Your site description here.'

Update

Update Hugo and the NPM modules.

hugo mod get -u && hugo mod clean

npm update

Start

Navigate to your-project.example.com and start the Hugo server .

hugo server