Skip to content

dexidp/website

Folders and files

NameName
Last commit message
Last commit date

Latest commit

9ac240c · Nov 11, 2024
Aug 25, 2024
Nov 11, 2024
Aug 25, 2024
Apr 12, 2024
Apr 12, 2024
Apr 20, 2023
Apr 20, 2023
Apr 12, 2024
Apr 12, 2024
Apr 15, 2024
Oct 1, 2020
Apr 13, 2024
Apr 12, 2024
Apr 20, 2023
Apr 12, 2024
Aug 25, 2024
Apr 12, 2024
Apr 13, 2024

Repository files navigation

CNCF Hugo Starter

This repository contains a boilerplate static site generator setup for creating CNCF documentation projects. We strongly recommend using this setup (it helps us help you and your project!), but none of the technologies in the stack are strictly required.

The starter uses the following:

  • Hugo as a static site generator
  • Docsy as a documentation theme
  • Netlify for building, hosting, and DNS management

Running locally

Make sure you have npm and yarn installed. Clone this repository and run the following two commands in its directory:

# Run the server locally
make serve

Running on Netlify

Netlify is a CI/CD build tool and hosting solution for (among other things) static sites. We strongly recommend using Netlify unless you have a good reason not to.

This repository comes with a pre-configured netlify.toml file. To build to Netlify:

  1. Go to netlify.com and sign up. We recommend signing up using a GitHub account.
  2. Click New Site from Git, and give Netlify access to your GitHub account.

Note: For projects with lots of contributors, it can be handy to create a general/bot account instead of granting access with a personal account.

  1. Install Netlify with access to your documentation site repository.
  2. Leave all other settings as default and click Deploy Site.