README
¶
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
is generated from source files in the
cuelang.org/go module.
The site is deployed and hosted via Netlify.
Issue tracking
To raise an issue about a specific page or piece of content, scroll to the bottom of the published page and use the "Report an Issue" link in the site footer. This link will save you time by prepopulating the issue with information that you'll need to find and fill in if you raise the issue manually.
To raise an issue manually, please open it in the
main CUE issue tracker,
giving the issue's title a "cuelang.org: " prefix.
Requirements for local development
- NodeJS
v20.x - Go
>= go1.23(not needed for only runninghugo) - Hugo
== v0.128.2("extended" binary version) - Docker CLI
>= 19.03(fordocker buildxuse, amongst other things)- Podman has been used successfully, instead of Docker, but its use is currently undocumented
- When adding or changing pages that interact with the CUE Central Registry (or
making changes to "infra" bits like the
preprocessor), your registry account must have been granted thetest managerrole, and you must have runcue loginsuccessfully.
Directory structure
content: the unprocessed website contenthugo: hugo-specific content, likely generated from thecontentdirectory by the preprocessorplayground: the app code for the cue-playground (/play)functions: cloud functionsinternal: internal stuff that can be ignoredcue.mod/go.mod/go.sum: can be ignored
Developing the site locally
To serve the site locally run:
./_scripts/build.bash # one-off to ensure everything works
./_scripts/serve.bash [--update] # update flag writes changes back into source files under content/
The site will be served at http://localhost:1313/.
Updating the version of CUE documented by the site
The site's CUE content is formatted, tested, and used to produce output by the
latest version of CUE stored in site.cue.
See commit https://github.com/cue-lang/cuelang.org/commit/80c17ba707e239adfe7794ffcfc79f314ed51841 (and the commit that comes after, updating cache files) for an example of how to update this version.
The spec is handled by a different version of CUE, as tracked in cue-lang/cue#3013.
It is generated against the required version of the cuelang.org/go module:
go generate ./...
To update the generated spec you need to update the site's required version of cuelang.org/go:
go get cuelang.org/go@latest
tip.cuelang.org
tip.cuelang.org currently redirects to cuelang.org, but it is intended that this site should:
- have the same template and content as
cuelang.org, except that all pages will have their
data formatted and output emitted by
cuelang.org/go@master; - be redeployed when any commit is added to to
masteroncue-lang/cuelang.orgorcue-lang/cue.
This is not currently implemented, and is tracked in https://cuelang.org/issues/2538.
History
This site was setup using the following guides:
Documentation
¶
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
content
|
|
|
functions
|
|
|
internal
|
|
|
cmd/preprocessor
cueckoo is a development tool for working with the CUE project
|
cueckoo is a development tool for working with the CUE project |
|
fsnotify
Package fsnotify is a light wrapper around github.com/fsnotify/fsnotify that allows for recursively watching directories, and provides a simple wrapper for batching events.
|
Package fsnotify is a light wrapper around github.com/fsnotify/fsnotify that allows for recursively watching directories, and provides a simple wrapper for batching events. |
|
functions/snippets
package snippets defines a serverless function that proxies requests/responses to/from the Go playground, for the CUE playground.
|
package snippets defines a serverless function that proxies requests/responses to/from the Go playground, for the CUE playground. |
|
genkubtutredirect
gentipredirect regenerates a simple Hugo markdown file that acts as a redirect to the @master module documentation root on pkg.go.dev
|
gentipredirect regenerates a simple Hugo markdown file that acts as a redirect to the @master module documentation root on pkg.go.dev |
|
genspec
genspec regenerates the Hugo markdown language spec from the pinned source of truth in the cuelang.org/go module
|
genspec regenerates the Hugo markdown language spec from the pinned source of truth in the cuelang.org/go module |
|
gentipredirect
gentipredirect regenerates a simple Hugo markdown file that acts as a redirect to the @master module documentation root on pkg.go.dev
|
gentipredirect regenerates a simple Hugo markdown file that acts as a redirect to the @master module documentation root on pkg.go.dev |
|
gentour
gentour regenerates Hugo markdown files for the tour from the txtar source in the cuelang.org/go module
|
gentour regenerates Hugo markdown files for the tour from the txtar source in the cuelang.org/go module |
|
parse
Package parse builds parse trees for templates as defined by text/template and html/template.
|
Package parse builds parse trees for templates as defined by text/template and html/template. |
|
playground
module
|