Many of the golang links point to the old site and don't use https. This pull request updates these outdated links to https://go.dev . https://github.com/go-gitea/gitea/issues/28979tags/v1.22.0-rc0
@@ -110,7 +110,7 @@ See the [development setup instructions](https://docs.gitea.com/development/hack | |||
### Backend | |||
Go dependencies are managed using [Go Modules](https://golang.org/cmd/go/#hdr-Module_maintenance). \ | |||
Go dependencies are managed using [Go Modules](https://go.dev/cmd/go/#hdr-Module_maintenance). \ | |||
You can find more details in the [go mod documentation](https://go.dev/ref/mod) and the [Go Modules Wiki](https://github.com/golang/go/wiki/Modules). | |||
Pull requests should only modify `go.mod` and `go.sum` where it is related to your change, be it a bugfix or a new feature. \ |
@@ -29,9 +29,9 @@ GITEA_CUSTOM=/home/gitea/custom ./gitea web | |||
* `GOOS` | |||
* `GOARCH` | |||
* [`GOPATH`](https://golang.org/cmd/go/#hdr-GOPATH_environment_variable) | |||
* [`GOPATH`](https://go.dev/cmd/go/#hdr-GOPATH_environment_variable) | |||
您可以在[官方文档](https://golang.org/cmd/go/#hdr-Environment_variables)中查阅这些配置参数的详细信息。 | |||
您可以在[官方文档](https://go.dev/cmd/go/#hdr-Environment_variables)中查阅这些配置参数的详细信息。 | |||
## Gitea 的文件目录 | |||
@@ -85,7 +85,7 @@ Text and macros for the mail body | |||
Specifying a _subject_ section is optional (and therefore also the dash line separator). When used, the separator between | |||
_subject_ and _mail body_ templates requires at least three dashes; no other characters are allowed in the separator line. | |||
_Subject_ and _mail body_ are parsed by [Golang's template engine](https://golang.org/pkg/text/template/) and | |||
_Subject_ and _mail body_ are parsed by [Golang's template engine](https://go.dev/pkg/text/template/) and | |||
are provided with a _metadata context_ assembled for each notification. The context contains the following elements: | |||
| Name | Type | Available | Usage | | |||
@@ -110,7 +110,7 @@ All names are case sensitive. | |||
### The _subject_ part of the template | |||
The template engine used for the mail _subject_ is golang's [`text/template`](https://golang.org/pkg/text/template/). | |||
The template engine used for the mail _subject_ is golang's [`text/template`](https://go.dev/pkg/text/template/). | |||
Please refer to the linked documentation for details about its syntax. | |||
The _subject_ is built using the following steps: | |||
@@ -138,7 +138,7 @@ the two templates, even if a valid subject template is present. | |||
### The _mail body_ part of the template | |||
The template engine used for the _mail body_ is golang's [`html/template`](https://golang.org/pkg/html/template/). | |||
The template engine used for the _mail body_ is golang's [`html/template`](https://go.dev/pkg/html/template/). | |||
Please refer to the linked documentation for details about its syntax. | |||
The _mail body_ is parsed after the mail subject, so there is an additional _metadata_ field which is | |||
@@ -146,7 +146,7 @@ the actual rendered subject, after all considerations. | |||
The expected result is HTML (including structural elements like`<html>`, `<body>`, etc.). Styling | |||
through `<style>` blocks, `class` and `style` attributes is possible. However, `html/template` | |||
does some [automatic escaping](https://golang.org/pkg/html/template/#hdr-Contexts) that should be considered. | |||
does some [automatic escaping](https://go.dev/pkg/html/template/#hdr-Contexts) that should be considered. | |||
Attachments (such as images or external style sheets) are not supported. However, other templates can | |||
be referenced too, for example to provide the contents of a `<style>` element in a centralized fashion. |
@@ -81,7 +81,7 @@ custom/templates/mail/pull/comment.tmpl | |||
指定 _主题_ 部分是可选的(因此也是虚线分隔符)。在使用时,_主题_ 和 _邮件正文_ 模板之间的分隔符需要至少三个虚线;分隔符行中不允许使用其他字符。 | |||
_主题_ 和 _邮件正文_ 由 [Golang的模板引擎](https://golang.org/pkg/text/template/) 解析,并提供了为每个通知组装的 _元数据上下文_。上下文包含以下元素: | |||
_主题_ 和 _邮件正文_ 由 [Golang的模板引擎](https://go.dev/pkg/text/template/) 解析,并提供了为每个通知组装的 _元数据上下文_。上下文包含以下元素: | |||
| 名称 | 类型 | 可用性 | 用途 | | |||
| -------------------- | ------------------ | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | |||
@@ -105,7 +105,7 @@ _主题_ 和 _邮件正文_ 由 [Golang的模板引擎](https://golang.org/pkg/t | |||
### 模板中的主题部分 | |||
用于邮件主题的模板引擎是 Golang 的 [`text/template`](https://golang.org/pkg/text/template/)。 | |||
用于邮件主题的模板引擎是 Golang 的 [`text/template`](https://go.dev/pkg/text/template/)。 | |||
有关语法的详细信息,请参阅链接的文档。 | |||
主题构建的步骤如下: | |||
@@ -130,12 +130,12 @@ _主题_ 和 _邮件正文_ 由 [Golang的模板引擎](https://golang.org/pkg/t | |||
### 模板中的邮件正文部分 | |||
用于邮件正文的模板引擎是 Golang 的 [`html/template`](https://golang.org/pkg/html/template/)。 | |||
用于邮件正文的模板引擎是 Golang 的 [`html/template`](https://go.dev/pkg/html/template/)。 | |||
有关语法的详细信息,请参阅链接的文档。 | |||
邮件正文在邮件主题之后进行解析,因此还有一个额外的 _元数据_ 字段,即在考虑所有情况之后实际呈现的主题。 | |||
期望的结果是 HTML(包括结构元素,如`<html>`,`<body>`等)。可以通过 `<style>` 块、`class` 和 `style` 属性进行样式设置。但是,`html/template` 会进行一些 [自动转义](https://golang.org/pkg/html/template/#hdr-Contexts),需要考虑这一点。 | |||
期望的结果是 HTML(包括结构元素,如`<html>`,`<body>`等)。可以通过 `<style>` 块、`class` 和 `style` 属性进行样式设置。但是,`html/template` 会进行一些 [自动转义](https://go.dev/pkg/html/template/#hdr-Contexts),需要考虑这一点。 | |||
不支持附件(例如图像或外部样式表)。但是,也可以引用其他模板,例如以集中方式提供 `<style>` 元素的内容。外部模板必须放置在 `custom/mail` 下,并相对于该目录引用。例如,可以使用 `{{template styles/base}}` 包含 `custom/mail/styles/base.tmpl`。 | |||
@@ -25,7 +25,7 @@ To get a quick working development environment you could use Gitpod. | |||
## Installing go | |||
You should [install go](https://golang.org/doc/install) and set up your go | |||
You should [install go](https://go.dev/doc/install) and set up your go | |||
environment correctly. | |||
Next, [install Node.js with npm](https://nodejs.org/en/download/) which is |
@@ -25,7 +25,7 @@ menu: | |||
## 安装 Golang | |||
您需要 [安装 go]( https://golang.org/doc/install ) 并设置您的 go 环境。 | |||
您需要 [安装 go]( https://go.dev/doc/install ) 并设置您的 go 环境。 | |||
接下来,[使用 npm 安装 Node.js](https://nodejs.org/en/download/) ,这是构建 | |||
JavaScript 和 CSS 文件的必要工具。最低支持的 Node.js 版本是 @minNodeVersion@ |
@@ -17,7 +17,7 @@ menu: | |||
# Installation from source | |||
You should [install go](https://golang.org/doc/install) and set up your go | |||
You should [install go](https://go.dev/doc/install) and set up your go | |||
environment correctly. In particular, it is recommended to set the `$GOPATH` | |||
environment variable and to add the go bin directory or directories | |||
`${GOPATH//://bin:}/bin` to the `$PATH`. See the Go wiki entry for | |||
@@ -82,7 +82,7 @@ git checkout v@version@ # or git checkout pr-xyz | |||
To build from source, the following programs must be present on the system: | |||
- `go` @minGoVersion@ or higher, see [here](https://golang.org/dl/) | |||
- `go` @minGoVersion@ or higher, see [here](https://go.dev/dl/) | |||
- `node` @minNodeVersion@ or higher with `npm`, see [here](https://nodejs.org/en/download/) | |||
- `make`, see [here](development/hacking-on-gitea.md#installing-make) | |||
@@ -119,7 +119,7 @@ TAGS="bindata sqlite sqlite_unlock_notify" make build | |||
The `build` target is split into two sub-targets: | |||
- `make backend` which requires [Go @minGoVersion@](https://golang.org/dl/) or greater. | |||
- `make backend` which requires [Go @minGoVersion@](https://go.dev/dl/) or greater. | |||
- `make frontend` which requires [Node.js @minNodeVersion@](https://nodejs.org/en/download/) or greater. | |||
If pre-built frontend files are present it is possible to only build the backend: | |||
@@ -165,7 +165,7 @@ Running `gitea help` will allow you to review what the computed settings will be | |||
## Cross Build | |||
The `go` compiler toolchain supports cross-compiling to different architecture targets that are supported by the toolchain. See [`GOOS` and `GOARCH` environment variable](https://golang.org/doc/install/source#environment) for the list of supported targets. Cross compilation is helpful if you want to build Gitea for less-powerful systems (such as Raspberry Pi). | |||
The `go` compiler toolchain supports cross-compiling to different architecture targets that are supported by the toolchain. See [`GOOS` and `GOARCH` environment variable](https://go.dev/doc/install/source#environment) for the list of supported targets. Cross compilation is helpful if you want to build Gitea for less-powerful systems (such as Raspberry Pi). | |||
To cross build Gitea with build tags (`TAGS`), you also need a C cross compiler which targets the same architecture as selected by the `GOOS` and `GOARCH` variables. For example, to cross build for Linux ARM64 (`GOOS=linux` and `GOARCH=arm64`), you need the `aarch64-unknown-linux-gnu-gcc` cross compiler. This is required because Gitea build tags uses `cgo`'s foreign-function interface (FFI). | |||
@@ -62,7 +62,7 @@ git checkout v@version@ # or git checkout pr-xyz | |||
要从源代码进行构建,系统必须预先安装以下程序: | |||
- `go` @minGoVersion@ 或更高版本,请参阅 [这里](https://golang.org/dl/) | |||
- `go` @minGoVersion@ 或更高版本,请参阅 [这里](https://go.dev/dl/) | |||
- `node` @minNodeVersion@ 或更高版本,并且安装 `npm`, 请参阅 [这里](https://nodejs.org/zh-cn/download/) | |||
- `make`, 请参阅 [这里](development/hacking-on-gitea.md) | |||
@@ -128,7 +128,7 @@ Gitea 将从`CustomPath`中查找许多信息。默认的,这会在运行 Gite | |||
## 交叉编译 | |||
`go`编译器工具链支持将代码交叉编译到不同的目标架构上。请参考[`GOOS`和`GOARCH`环境变量](https://golang.org/doc/install/source#environment) 以获取支持的目标列表。如果您想为性能较弱的系统(如树莓派)构建 Gitea,交叉编译非常有用。 | |||
`go`编译器工具链支持将代码交叉编译到不同的目标架构上。请参考[`GOOS`和`GOARCH`环境变量](https://go.dev/doc/install/source#environment) 以获取支持的目标列表。如果您想为性能较弱的系统(如树莓派)构建 Gitea,交叉编译非常有用。 | |||
要使用构建标签(`TAGS`)进行交叉编译Gitea,您还需要一个 C 交叉编译器,该编译器的目标架构与`GOOS`和`GOARCH`变量选择的架构相同。例如,要为 Linux ARM64(`GOOS=linux`和`GOARCH=arm64`)进行交叉编译,您需要`aarch64-unknown-linux-gnu-gcc`交叉编译器。这是因为 Gitea 构建标签使用了`cgo`的外部函数接口(FFI)。 | |||
@@ -186,7 +186,7 @@ app_desc = A painless, self-hosted Git service | |||
install = Easy to install | |||
install_desc = Simply <a target="_blank" rel="noopener noreferrer" href="https://docs.gitea.com/installation/install-from-binary">run the binary</a> for your platform, ship it with <a target="_blank" rel="noopener noreferrer" href="https://github.com/go-gitea/gitea/tree/master/docker">Docker</a>, or get it <a target="_blank" rel="noopener noreferrer" href="https://docs.gitea.com/installation/install-from-package">packaged</a>. | |||
platform = Cross-platform | |||
platform_desc = Gitea runs anywhere <a target="_blank" rel="noopener noreferrer" href="http://golang.org/">Go</a> can compile for: Windows, macOS, Linux, ARM, etc. Choose the one you love! | |||
platform_desc = Gitea runs anywhere <a target="_blank" rel="noopener noreferrer" href="https://go.dev/">Go</a> can compile for: Windows, macOS, Linux, ARM, etc. Choose the one you love! | |||
lightweight = Lightweight | |||
lightweight_desc = Gitea has low minimal requirements and can run on an inexpensive Raspberry Pi. Save your machine energy! | |||
license = Open Source |