go.dev/_content: various formatting fixes

Add a standard 1rem margin above and below key block elements like h1, h2, ..., ol, ul, p.
Today it's very inconsistent and because you get a margin from either the block above
or below, it mostly works out, except in certain cases where text gets jammed together
a bit too much.

Add the auto-TOC generator for use in layouts that define #nav
(nothing yet, but golang.org-migrated pages will).

Add "Table of Contents" to the top of the TOC.

Allow pages to opt out of the TOC by setting HideTOC in their metadata.

Make subtitle heading (Version of Jan 1, 2021) line up horizontally with the TOC.

Preparation for the golang.org -> go.dev move.

Change-Id: Ic9121e5b636155c54e487bcb735ac0bc3f958733
Reviewed-on: https://go-review.googlesource.com/c/website/+/362502
Trust: Russ Cox <rsc@golang.org>
Reviewed-by: Jamal Carvalho <jamal@golang.org>
6 files changed
tree: 8b1c7fd92f673f306f1243562f99f6e20cba7dc2
  1. _content/
  2. cmd/
  3. go.dev/
  4. internal/
  5. tour/
  6. .gitattributes
  7. .prettierrc
  8. AUTHORS
  9. codereview.cfg
  10. content.go
  11. CONTRIBUTING.md
  12. CONTRIBUTORS
  13. go-app-deploy.sh
  14. go.mod
  15. go.sum
  16. LICENSE
  17. PATENTS
  18. README.md
README.md

Go website

Go Reference

This repo holds content and serving programs for the golang.org and go.dev web sites.

Content is in _content/ (golang.org), go.dev/_content/ (go.dev), and tour/ (tour.golang.org). Server code is in cmd/ and internal/.

To run the combined golang.org+go.dev server to preview local content changes, use:

go run ./cmd/golangorg

The supporting programs cmd/admingolangorg and cmd/googlegolangorg are the servers for admin.golang.org and google.golang.org. (They do not use the _content/ directories.)

Each command directory has its own README.md explaining deployment.

JS/CSS Formatting

This repository uses prettier to format JS and CSS files.

The version of prettier used is 1.18.2.

It is encouraged that all JS and CSS code be run through this before submitting a change. However, it is not a strict requirement enforced by CI.

Report Issues / Send Patches

This repository uses Gerrit for code changes. To learn how to submit changes to this repository, see https://golang.org/doc/contribute.html.

The main issue tracker for the website repository is located at https://github.com/golang/go/issues. Prefix your issue with “x/website:” in the subject line, so it is easy to find.