[mirror] Home of the go.dev and golang.org websites
Перейти к файлу
Heschi Kreinick b04a5fd548 _content/assets: add logos and brand book
These are referenced from go-brand.md via short links, which I'll update
once this CL is deployed.

Change-Id: Iecd5d1a95bffa3fdd608e0691568cb7bda810225
Reviewed-on: https://go-review.googlesource.com/c/website/+/418114
Run-TryBot: Heschi Kreinick <heschi@google.com>
TryBot-Result: Gopher Robot <gobot@golang.org>
Auto-Submit: Heschi Kreinick <heschi@google.com>
Reviewed-by: Jamal Carvalho <jamal@golang.org>
2022-07-18 19:49:47 +00:00
_content _content/assets: add logos and brand book 2022-07-18 19:49:47 +00:00
_later/security go.dev: merge go.dev/_content into root _content 2021-11-22 16:42:59 +00:00
cmd _content/ref: specify redirect for /ref and /ref/ using /ref/index.md 2022-06-24 14:11:52 +00:00
internal internal/history: document Go 1.18.4 and Go 1.17.12 2022-07-12 20:06:07 +00:00
tour all: fix a lot of typos 2022-06-15 16:32:49 +00:00
.eslintrc.yaml website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
.gitattributes blog: delete per-repo files, update README.md, go.mod 2021-05-26 13:23:13 +00:00
.prettierrc.yaml go.dev: merge go.dev/_content into root _content 2021-11-22 16:42:59 +00:00
.stylelintrc.yaml website: fixed stylelint dependency 2022-01-11 22:47:06 +00:00
AUTHORS initial commit 2019-01-04 09:34:42 -05:00
CONTRIBUTING.md initial commit 2019-01-04 09:34:42 -05:00
CONTRIBUTORS initial commit 2019-01-04 09:34:42 -05:00
LICENSE initial commit 2019-01-04 09:34:42 -05:00
PATENTS initial commit 2019-01-04 09:34:42 -05:00
README.md website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
codereview.cfg x/website: add code and static files for website 2019-01-08 18:22:29 +00:00
content.go internal/tour: fix go.dev/tour 2021-11-23 03:31:47 +00:00
go-app-deploy.sh website: publish all commits, eliminating Website-Publish+1 vote 2021-12-06 20:46:19 +00:00
go.mod internal/screentest: add support for writing test output to GCS 2022-01-04 19:30:38 +00:00
go.sum internal/screentest: add support for writing test output to GCS 2022-01-04 19:30:38 +00:00
jest-transform.cjs website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
npm website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
npx website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00
package-lock.json website: ran npm audit fix 2022-03-10 16:48:22 +00:00
package.json website: fixed stylelint dependency 2022-01-11 22:47:06 +00:00
tsconfig.json website: add support for JS/TS unit testing 2022-01-11 22:46:10 +00:00

README.md

Go website

Go Reference

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

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

To run the combined go.dev+golang.org 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/TS/CSS Formatting

This repository uses eslint to format JS and TS files, and stylelint to format CSS files.

See also:

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

Installing npm Dependencies:

  1. Install docker
  2. Create a .gitignore file at repo root
  3. Add .gitignore and node_modules to .gitignore
  4. Run ./npm install

Run ESlint

./npx eslint [options] [file] [dir]

Run Stylelint

./npx stylelint [input] [options]

TypeScript Support

TypeScript files served from _content are transformed into JavaScript. Reference .ts files in html templates as module code.

<script type="module" src="/ts/filename.ts">

Write unit tests for TypeScript code using the jest testing framework.

Run Jest

./npx jest [TestPathPattern]

Deploying

Each time a CL is reviewed and submitted, the code is deployed to App Engine. See cmd/golangorg/README.md for details.

Report Issues / Send Patches

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

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.