**このページの改善にご協力ください** 

このユーザーガイドに貢献するには、すべてのページの右側のペインにある「**GitHub でこのページを編集する**」リンクを選択してください。

# リンクを挿入する
<a name="insert-link"></a>

AsciiDoc は複数の種類のリンクをサポートしています。さまざまな環境でリンクが適切に機能するように、適切なリンク タイプを使用することが重要です。

## EKS User Guideのページまたはセクションへのリンク
<a name="_link_to_a_page_or_section_in_the_eks_user_guide"></a>

「EKS ユーザーガイド」など、同じドキュメントサイト内のページまたはセクション間をリンクするには、クロスリファレンス (xref) を使用します。対象セクションが移動または名前変更されると、自動的に更新されます。

### ページタイトルをリンクテキストとして使用する
<a name="_use_page_title_as_link_text"></a>

このユーザーガイド内で別の ID にリンクする場合、ほとんどのケースでは、必要に応じてリンクテキストが最新のタイトルに自動更新されるように、以下の手法を使用します。

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

### カスタムリンクテキストを定義する
<a name="_define_custom_link_text"></a>

カスタムリンクテキストが必要な場合、次の形式を使用します。

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

## AWS ドキュメント内の別のガイドへのリンク
<a name="link_to_another_guide_in_the_shared_aws_docs"></a>

1. AWS ドキュメントページへのリンクを見つけます。

1. `https://docs.aws.amazon.com/` プレフィックスを削除し、パスのみを残します。パスは文字で始まる必要があります。

1. 以下のようにリンクを作成します。

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

## 外部ウェブページへのリンク
<a name="_link_to_an_external_webpage"></a>

この形式では、Amazon がホストしていないページへの標準リンクが作成されます。例えば、これを GitHub リンクに使用します。

```
https://example.com[Link text]
```

**注記**  
外部ドメインの許可リストがあります。許可リストは `vale/styles/EksDocs/ExternalDomains.yml`にあります