插入链接

AsciiDoc 支持多种类型的链接。使用正确的链接类型很重要，这样链接才能在不同的环境中正常工作。

链接到《EKS 用户指南》中的页面或章节

使用交叉引用（xref）在同一文档网站（例如《EKS 用户指南》）中的页面或章节之间进行链接。如果目标章节移动或重命名，链接会自动更新。

使用页面标题作为链接文本

对于本用户指南中链接到其他 ID 的大多数情况，请使用以下方法让链接文本根据需要自动更新为最新标题。

For more information, see <<page-or-section-id>>.

定义自定义链接文本

对于必须有自定义链接文本的情况，请使用以下格式。

Here's an example of a <<page-or-section-id,link with custom text>>.

链接到 AWS 文档中的其他指南

1. 查找指向 AWS 文档页面的链接。

2. 移除 https://docs.aws.amazon.com/ 前缀，仅保留路径。路径应以字母开头。

3. 创建一个链接，如下所示：

link:AmazonS3/latest/userguide/create-bucket-overview.html[Create a bucket, type="documentation"]

链接到外部网页

这种格式会创建一个指向非 Amazon 托管页面的标准链接。例如，GitHub 链接可使用此格式。

https://example.com[Link text]

注意

我们已设置外部域允许列表。允许名单位于 vale/styles/EksDocs/ExternalDomains.yml