dvob / cuelang.org

Source for the https://cuelang.org site

github.com/cue-lang/cuelang.org - the home of cuelang.org

This repo is the home of cuelang.org. The site is built using Hugo and is based on the docsy theme.

The CUE Language Specification and tour are generated from source files in the cuelang.org/go module; the results are currently not committed to this repository.

The site is deployed and hosted via Netlify.

Requirements for local development

• NodeJS >= v12.14.1
• Go (stable version)
• Hugo == v0.67.0

Developing the site locally

# Ensure you have the correct version of the docsy theme
git submodule update -f --init --recursive

# Install Hugo's Node requirements
npm install

# Generate the language spec and tour
go generate ./...

# Serve (with auto-reload)
hugo serve -D

Updating the language spec and tour for cuelang.org

The tour and spec and generated against the required version of the cuelang.org/go module:

go generate ./...

Therefore to update the generated version you need to update the required version of cuelang.org/go:

go get cuelang.org/go@latest

tip.cuelang.org

tip.cuelang.org has the exact same site template and content as cuelang.org except for the fact the language spec and tour are generated based on cuelang.org/go@master. Any commit to master of this repository or github.com/cue-lang/cue will result in a redeploy of tip.cuelang.org.

History

This site was setup using the following guides:

• https://gohugo.io/hosting-and-deployment/hosting-on-netlify/
• https://www.docsy.dev/docs/getting-started
• https://www.docsy.dev/docs/deployment/