go
/
website
зеркало из
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность
website/README.md

55 строки
2.1 KiB
Markdown
Исходник Обычный вид История

website: update README.md Update README.md to explain how to make basic content changes, with a link to the content/README.md for advanced things. Fixes golang/go#39687. Change-Id: Ie2a603422f4c7057ffdab71f434b60f53e99a828 Reviewed-on: https://go-review.googlesource.com/c/website/+/251121 Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-08-27 23:34:57 +03:00
# Go website
initial commit
2019-01-04 17:06:45 +03:00
README.md: add badge to pkg.go.dev A badge is added to the x/website README to link to pkg.go.dev/golang.org/x/website. Change-Id: Ia54daec1cee91bd37510d07fb509174ac1344f4c Reviewed-on: https://go-review.googlesource.com/c/website/+/275193 Trust: Julie Qiu <julie@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-12-04 01:43:40 +03:00
[![Go Reference](https://pkg.go.dev/badge/golang.org/x/website.svg)](https://pkg.go.dev/golang.org/x/website)
cmd/golangorg: move blog from blog.golang.org to go.dev/blog This is the first of a sequence of consolidations of web sites into the single site go.dev. An accompanying blog post (next CL) will explain the change. The blog/_content tree moves to go.dev/_content/blog. The *.article files were converted to *.md files using rsc.io/tmp/blog2md. The old dot directives are now template function invocations, so that blog content files are now exactly the same format and semantics as regular site content files. All the old blog redirects are carried forward, of course. Also add exhaustive test that every .md file renders correctly. Also rename rawhtml to raw, because it gets used for raw Markdown too. The raw Markdown issue is working around a bigger problem (html/template is not really right for Markdown) that we will have to solve at some point, but not in this CL. Change-Id: Ifa9b3b8d656a72af30d0d4e57e4c7bc8dacbc386 Reviewed-on: https://go-review.googlesource.com/c/website/+/342091 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Jamal Carvalho <jamal@golang.org>
2021-08-03 07:54:24 +03:00
This repo holds content and serving programs for the golang.org and go.dev web sites.
initial commit
2019-01-04 17:06:45 +03:00
go.dev: merge go.dev/_content into root _content Many renames. And then adjust references. Change-Id: I4d03c76dbc0bf4d070208d568861ee820904c0dc Reviewed-on: https://go-review.googlesource.com/c/website/+/365097 Trust: Russ Cox <rsc@golang.org> Reviewed-by: Jamal Carvalho <jamal@golang.org>
2021-11-18 06:51:08 +03:00
Content is in _content/ (go.dev) and tour/ (tour.golang.org).
cmd/golangorg: move blog from blog.golang.org to go.dev/blog This is the first of a sequence of consolidations of web sites into the single site go.dev. An accompanying blog post (next CL) will explain the change. The blog/_content tree moves to go.dev/_content/blog. The *.article files were converted to *.md files using rsc.io/tmp/blog2md. The old dot directives are now template function invocations, so that blog content files are now exactly the same format and semantics as regular site content files. All the old blog redirects are carried forward, of course. Also add exhaustive test that every .md file renders correctly. Also rename rawhtml to raw, because it gets used for raw Markdown too. The raw Markdown issue is working around a bigger problem (html/template is not really right for Markdown) that we will have to solve at some point, but not in this CL. Change-Id: Ifa9b3b8d656a72af30d0d4e57e4c7bc8dacbc386 Reviewed-on: https://go-review.googlesource.com/c/website/+/342091 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Jamal Carvalho <jamal@golang.org>
2021-08-03 07:54:24 +03:00
Server code is in cmd/ and internal/.
initial commit
2019-01-04 17:06:45 +03:00
cmd/golangorg: move blog from blog.golang.org to go.dev/blog This is the first of a sequence of consolidations of web sites into the single site go.dev. An accompanying blog post (next CL) will explain the change. The blog/_content tree moves to go.dev/_content/blog. The *.article files were converted to *.md files using rsc.io/tmp/blog2md. The old dot directives are now template function invocations, so that blog content files are now exactly the same format and semantics as regular site content files. All the old blog redirects are carried forward, of course. Also add exhaustive test that every .md file renders correctly. Also rename rawhtml to raw, because it gets used for raw Markdown too. The raw Markdown issue is working around a bigger problem (html/template is not really right for Markdown) that we will have to solve at some point, but not in this CL. Change-Id: Ifa9b3b8d656a72af30d0d4e57e4c7bc8dacbc386 Reviewed-on: https://go-review.googlesource.com/c/website/+/342091 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Jamal Carvalho <jamal@golang.org>
2021-08-03 07:54:24 +03:00
To run the combined golang.org+go.dev server to preview local content changes, use:
website: update README.md Update README.md to explain how to make basic content changes, with a link to the content/README.md for advanced things. Fixes golang/go#39687. Change-Id: Ie2a603422f4c7057ffdab71f434b60f53e99a828 Reviewed-on: https://go-review.googlesource.com/c/website/+/251121 Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-08-27 23:34:57 +03:00
cmd/golangorg: simplify local vs prod programs There was too much duplicated code between main.go and appinit.go and too many build-tagged-out files. Make main.go the func main for both prod and local. Introduce local.go, merging dl.go and play.go. Introduce prod.go, holding the prod-specific bits of appinit.go (the rest are in main.go). Rename the build tag to prod instead of golangorg (the whole program is golangorg; it's very confusing). Fixes golang/go#41102. Change-Id: I261ce8e9171110f01798025f8218ce9f8253af81 Reviewed-on: https://go-review.googlesource.com/c/website/+/293413 Trust: Russ Cox <rsc@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2021-02-17 05:26:23 +03:00
go run ./cmd/golangorg
website: update README.md Update README.md to explain how to make basic content changes, with a link to the content/README.md for advanced things. Fixes golang/go#39687. Change-Id: Ie2a603422f4c7057ffdab71f434b60f53e99a828 Reviewed-on: https://go-review.googlesource.com/c/website/+/251121 Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-08-27 23:34:57 +03:00
_content: move content/static/* to _content/* The extra level of hierarchy here is unnecessary and confusing. The directory is now _content so that any Go source files in our docs are not considered by commands like "go mod tidy" and "go test all". Change-Id: Ib6d7cb12920193798ee825155a8f8b33f16e60d8 Reviewed-on: https://go-review.googlesource.com/c/website/+/291691 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2021-02-12 22:32:52 +03:00
The supporting programs cmd/admingolangorg and cmd/googlegolangorg
are the servers for admin.golang.org and google.golang.org.
cmd/golangorg: move blog from blog.golang.org to go.dev/blog This is the first of a sequence of consolidations of web sites into the single site go.dev. An accompanying blog post (next CL) will explain the change. The blog/_content tree moves to go.dev/_content/blog. The *.article files were converted to *.md files using rsc.io/tmp/blog2md. The old dot directives are now template function invocations, so that blog content files are now exactly the same format and semantics as regular site content files. All the old blog redirects are carried forward, of course. Also add exhaustive test that every .md file renders correctly. Also rename rawhtml to raw, because it gets used for raw Markdown too. The raw Markdown issue is working around a bigger problem (html/template is not really right for Markdown) that we will have to solve at some point, but not in this CL. Change-Id: Ifa9b3b8d656a72af30d0d4e57e4c7bc8dacbc386 Reviewed-on: https://go-review.googlesource.com/c/website/+/342091 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Jamal Carvalho <jamal@golang.org>
2021-08-03 07:54:24 +03:00
(They do not use the _content/ directories.)
website: update README.md Update README.md to explain how to make basic content changes, with a link to the content/README.md for advanced things. Fixes golang/go#39687. Change-Id: Ie2a603422f4c7057ffdab71f434b60f53e99a828 Reviewed-on: https://go-review.googlesource.com/c/website/+/251121 Run-TryBot: Russ Cox <rsc@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2020-08-27 23:34:57 +03:00
_content: move content/static/* to _content/* The extra level of hierarchy here is unnecessary and confusing. The directory is now _content so that any Go source files in our docs are not considered by commands like "go mod tidy" and "go test all". Change-Id: Ib6d7cb12920193798ee825155a8f8b33f16e60d8 Reviewed-on: https://go-review.googlesource.com/c/website/+/291691 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2021-02-12 22:32:52 +03:00
Each command directory has its own README.md explaining deployment.
initial commit
2019-01-04 17:06:45 +03:00
all: add a section on JS/CSS formatting to README Updates golang/go#21719 Change-Id: Ie33b439c929c466089398c4f24dc243239c48f10 Reviewed-on: https://go-review.googlesource.com/c/website/+/183879 Run-TryBot: Agniva De Sarker <agniva.quicksilver@gmail.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Andrew Bonventre <andybons@golang.org>
2019-06-26 12:03:53 +03:00
## JS/CSS Formatting
This repository uses [prettier](https://prettier.io/) to format JS and CSS files.
go.dev: merge go.dev/_content into root _content Many renames. And then adjust references. Change-Id: I4d03c76dbc0bf4d070208d568861ee820904c0dc Reviewed-on: https://go-review.googlesource.com/c/website/+/365097 Trust: Russ Cox <rsc@golang.org> Reviewed-by: Jamal Carvalho <jamal@golang.org>
2021-11-18 06:51:08 +03:00
See also:
- [CSS](https://golang.org/wiki/CSSStyleGuide)
- [JavaScript](https://google.github.io/styleguide/jsguide.html)
all: add a section on JS/CSS formatting to README Updates golang/go#21719 Change-Id: Ie33b439c929c466089398c4f24dc243239c48f10 Reviewed-on: https://go-review.googlesource.com/c/website/+/183879 Run-TryBot: Agniva De Sarker <agniva.quicksilver@gmail.com> TryBot-Result: Gobot Gobot <gobot@golang.org> Reviewed-by: Andrew Bonventre <andybons@golang.org>
2019-06-26 12:03:53 +03:00
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.
go.dev: merge go.dev/_content into root _content Many renames. And then adjust references. Change-Id: I4d03c76dbc0bf4d070208d568861ee820904c0dc Reviewed-on: https://go-review.googlesource.com/c/website/+/365097 Trust: Russ Cox <rsc@golang.org> Reviewed-by: Jamal Carvalho <jamal@golang.org>
2021-11-18 06:51:08 +03:00
## Deploying
Each time a CL is reviewed and submitted, the blog is automatically deployed to App Engine.
If the CL is submitted with a Website-Publish +1 vote,
the new deployment automatically becomes https://go.dev/.
Otherwise, the new deployment can be found in the
[App Engine versions list](https://console.cloud.google.com/appengine/versions?project=golang-org&serviceId=default) and verified and manually promoted.
If the automatic deployment is not working, or to check on the status of a pending deployment,
see the “website-redeploy-go-dev” trigger in the
[Cloud Build console](https://console.cloud.google.com/cloud-build/builds?project=golang-org).
initial commit
2019-01-04 17:06:45 +03:00
## 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.
all: Fix reference to time repository in README Change-Id: I21e409e523722883b5a4b67153db669f1f8167dd Reviewed-on: https://go-review.googlesource.com/c/163897 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
2019-02-27 03:15:19 +03:00
The main issue tracker for the website repository is located at
initial commit
2019-01-04 17:06:45 +03:00
https://github.com/golang/go/issues. Prefix your issue with "x/website:" in the
subject line, so it is easy to find.
_content: move content/static/* to _content/* The extra level of hierarchy here is unnecessary and confusing. The directory is now _content so that any Go source files in our docs are not considered by commands like "go mod tidy" and "go test all". Change-Id: Ib6d7cb12920193798ee825155a8f8b33f16e60d8 Reviewed-on: https://go-review.googlesource.com/c/website/+/291691 Trust: Russ Cox <rsc@golang.org> Run-TryBot: Russ Cox <rsc@golang.org> TryBot-Result: Go Bot <gobot@golang.org> Reviewed-by: Dmitri Shuralyov <dmitshur@golang.org>
2021-02-12 22:32:52 +03:00