diff options
| author | Russ Cox <rsc@golang.org> | 2021-11-09 15:44:24 -0500 |
|---|---|---|
| committer | Russ Cox <rsc@golang.org> | 2021-11-17 17:48:31 +0000 |
| commit | cbd24723f5e2232966bd94d3a2371a1d22ae62ca (patch) | |
| tree | 8b1c7fd92f673f306f1243562f99f6e20cba7dc2 /_content | |
| parent | 44e466c7fc58471c854ae9b98f9e55c8cd5cd341 (diff) | |
| download | go-x-website-cbd24723f5e2232966bd94d3a2371a1d22ae62ca.tar.xz | |
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>
Diffstat (limited to '_content')
| -rw-r--r-- | _content/doc/install.html | 3 | ||||
| -rw-r--r-- | _content/doc/tutorial/getting-started.html | 6 | ||||
| -rw-r--r-- | _content/site.tmpl | 2 |
3 files changed, 7 insertions, 4 deletions
diff --git a/_content/doc/install.html b/_content/doc/install.html index d238e17f..a0be5594 100644 --- a/_content/doc/install.html +++ b/_content/doc/install.html @@ -1,5 +1,6 @@ <!--{ - "Title": "Download and install" + "Title": "Download and install", + "HideTOC": true }--> <p> Download and install Go quickly with the steps described here. diff --git a/_content/doc/tutorial/getting-started.html b/_content/doc/tutorial/getting-started.html index 2946f272..6ca9e43c 100644 --- a/_content/doc/tutorial/getting-started.html +++ b/_content/doc/tutorial/getting-started.html @@ -127,11 +127,11 @@ go: creating new go.mod: module example/hello </li> <li> - In your text editor, create a file hello.go in which to write your code. + <p>In your text editor, create a file hello.go in which to write your code.</p> </li> <li> - Paste the following code into your hello.go file and save the file. + <p>Paste the following code into your hello.go file and save the file.</p> <pre> package main @@ -170,7 +170,7 @@ func main() { </li> <li> - Run your code to see the greeting. + <p>Run your code to see the greeting.</p> <pre> $ go run . diff --git a/_content/site.tmpl b/_content/site.tmpl index 13cf8d13..f12fad12 100644 --- a/_content/site.tmpl +++ b/_content/site.tmpl @@ -99,7 +99,9 @@ window.trackEvent = function(category, action, opt_label, opt_value, opt_noninte {{/* The Table of Contents is automatically inserted in this <div>. Do not delete this <div>. */}} +{{if not .hidetoc}} <div id="nav"></div> +{{end}} {{block "layout" .}}{{.Content}}{{end}} |