serpentos.com

This repository hosts the hugo based website of Serpent OS

We make use of docsy for the theme.

Prerequisites

Build the extended version of hugo (and make sure ~/go/bin is in your PATH):

CGO_ENABLED=1 go install -tags extended github.com/gohugoio/hugo@latest

Install npm:

# This is how would do it on Serpent OS
sudo moss it 'binary(npm)'

Building

Assuming hugo is in your path, you'll need to get postcss-cli available:

npm i

Now run the live server for testing:

PATH=$(pwd)/node_modules/bin:${PATH} hugo server --disableFastRender

Generating new pages

By and large contributors will be changing the documentation. The root of the tree is considered to be content/en, and is already understood by the hugo configuration.

To create a new documentation page in content/en/docs/packaging, we'd do:

hugo new content docs/packaging/my_new_file.md

Updating documentation (content/en/docs)

Note that the boulder macro docs are automatically generated from the boulder/data/macros files in the moss repository.

Currently we manually copy the files across but a more dynamic approach will be used soon.