Skip to content

Quick answers

Frequently asked questions

Short answers to the questions we hear most. Still stuck? Use search to dig into the full articles.

Getting started

How do I create my first article?
Add a Markdown file under content/articles/, give it a title and one or more categories in the front matter, and write away. It appears in Recent articles and search automatically.
Who can edit the knowledge hub?
Anyone with access to the site repository. Articles are plain Markdown, so editing is as simple as opening a pull request or committing a change.
Can I preview changes before they go live?
Yes — run hugo server locally for a live preview, or open a pull request to get a deploy preview if your host supports it.

Search & navigation

How does search work?
Search runs entirely in the browser against an index Hugo builds at /index.json. There’s no server or third-party service to set up, and it works on the static site. Press / anywhere to jump to the search box.
Why isn't my new article showing up in search?
The search index is rebuilt when the site builds. Re-run the build (or restart hugo server) and refresh the page.
How are related articles chosen?
Hugo’s built-in related-content engine matches articles on shared tags first, then categories. Add relevant tags to make the matches better.

Branding

Where do I put our company logo?
Drop your file in static/images/ and point params.logo in hugo.toml at it. If the file is missing, the hub shows a text wordmark instead, so nothing breaks.
How do I change the brand colour?
Edit the --accent value (and the --cat-* palette if you like) in assets/css/style.css. One change re-skins the whole hub.