commit | 5bd3da9b648833748dabf31f571d5f752c307659 | [log] [tgz] |
---|---|---|
author | Russ Cox <rsc@golang.org> | Fri Aug 28 12:33:28 2020 -0400 |
committer | Russ Cox <rsc@golang.org> | Fri Feb 12 16:44:11 2021 +0000 |
tree | e239fc455636928d32056ef2a02aaed284432ca1 | |
parent | 9eba6e1578c0e266628eefd47f0b750a6a63cf07 [diff] |
godoc: convert Markdown files to HTML during serving For golang.org today, Markdown is converted to HTML during the static file embedding, but that precludes using Markdown with "live serving". Moving the code here lets godoc itself do the conversion and therefore works with live serving. It is also more consistent with re-executing templates during serving for Template:true files. When a file is .md but also has Template: true, templates apply first, so that templates can generate Markdown. This is reversed from what x/website was doing (Markdown before templates) but that decision was mostly forced by doing it during static embedding and not necessarily the right one. There's no reason to force switching to raw HTML just because you want to use a template. (A template can of course still generate HTML.) Change-Id: I7db6d54b43e45803e965df7a1ab2f26293285cfd Reviewed-on: https://go-review.googlesource.com/c/tools/+/251343 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> gopls-CI: kokoro <noreply+kokoro@google.com> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
This subrepository holds the source for various packages and tools that support the Go programming language.
Some of the tools, godoc
and vet
for example, are included in binary Go distributions.
Others, including the Go guru
and the test coverage tool, can be fetched with go get
.
Packages include a type-checker for Go and an implementation of the Static Single Assignment form (SSA) representation for Go programs.
The easiest way to install is to run go get -u golang.org/x/tools/...
. You can also manually git clone the repository to $GOPATH/src/golang.org/x/tools
.
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.
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 tools repository is located at https://github.com/golang/go/issues. Prefix your issue with “x/tools/(your subdir):” in the subject line, so it is easy to find.