forked from Shiloh/githaven
Update golang links to use https (#28980)
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/28979
This commit is contained in:
parent
37ede3197a
commit
8ef53c871b
@ -110,7 +110,7 @@ See the [development setup instructions](https://docs.gitea.com/development/hack
|
|||||||
|
|
||||||
### Backend
|
### 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).
|
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. \
|
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`
|
* `GOOS`
|
||||||
* `GOARCH`
|
* `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 的文件目录
|
## 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
|
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_ 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:
|
are provided with a _metadata context_ assembled for each notification. The context contains the following elements:
|
||||||
|
|
||||||
| Name | Type | Available | Usage |
|
| Name | Type | Available | Usage |
|
||||||
@ -110,7 +110,7 @@ All names are case sensitive.
|
|||||||
|
|
||||||
### The _subject_ part of the template
|
### 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.
|
Please refer to the linked documentation for details about its syntax.
|
||||||
|
|
||||||
The _subject_ is built using the following steps:
|
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 _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.
|
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
|
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
|
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`
|
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
|
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.
|
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`。
|
不支持附件(例如图像或外部样式表)。但是,也可以引用其他模板,例如以集中方式提供 `<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
|
## 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.
|
environment correctly.
|
||||||
|
|
||||||
Next, [install Node.js with npm](https://nodejs.org/en/download/) which is
|
Next, [install Node.js with npm](https://nodejs.org/en/download/) which is
|
||||||
|
@ -25,7 +25,7 @@ menu:
|
|||||||
|
|
||||||
## 安装 Golang
|
## 安装 Golang
|
||||||
|
|
||||||
您需要 [安装 go]( https://golang.org/doc/install ) 并设置您的 go 环境。
|
您需要 [安装 go]( https://go.dev/doc/install ) 并设置您的 go 环境。
|
||||||
|
|
||||||
接下来,[使用 npm 安装 Node.js](https://nodejs.org/en/download/) ,这是构建
|
接下来,[使用 npm 安装 Node.js](https://nodejs.org/en/download/) ,这是构建
|
||||||
JavaScript 和 CSS 文件的必要工具。最低支持的 Node.js 版本是 @minNodeVersion@
|
JavaScript 和 CSS 文件的必要工具。最低支持的 Node.js 版本是 @minNodeVersion@
|
||||||
|
@ -17,7 +17,7 @@ menu:
|
|||||||
|
|
||||||
# Installation from source
|
# 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 correctly. In particular, it is recommended to set the `$GOPATH`
|
||||||
environment variable and to add the go bin directory or directories
|
environment variable and to add the go bin directory or directories
|
||||||
`${GOPATH//://bin:}/bin` to the `$PATH`. See the Go wiki entry for
|
`${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:
|
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/)
|
- `node` @minNodeVersion@ or higher with `npm`, see [here](https://nodejs.org/en/download/)
|
||||||
- `make`, see [here](development/hacking-on-gitea.md#installing-make)
|
- `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:
|
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.
|
- `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:
|
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
|
## 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).
|
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/)
|
- `node` @minNodeVersion@ 或更高版本,并且安装 `npm`, 请参阅 [这里](https://nodejs.org/zh-cn/download/)
|
||||||
- `make`, 请参阅 [这里](development/hacking-on-gitea.md)
|
- `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)。
|
要使用构建标签(`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 = 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>.
|
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 = 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 = Lightweight
|
||||||
lightweight_desc = Gitea has low minimal requirements and can run on an inexpensive Raspberry Pi. Save your machine energy!
|
lightweight_desc = Gitea has low minimal requirements and can run on an inexpensive Raspberry Pi. Save your machine energy!
|
||||||
license = Open Source
|
license = Open Source
|
||||||
|
Loading…
Reference in New Issue
Block a user