Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Tragen Sie zu diesem Leitfaden bei
Jeder kann zu dem Best-Practice-Leitfaden beitragen. Der EKS Best Practices Guide ist in dem AsciiDoc Format auf verfasst GitHub.
## Zusammenfassung für bestehende Mitwirkende
+ Öffnen Sie das [https://github.com/aws/aws-eks-best-practices/blob/master/bpg-docs.code-workspace](https://github.com/aws/aws-eks-best-practices/blob/master/bpg-docs.code-workspace)mit VS Code, um die AsciiDoc Erweiterung automatisch zu installieren.
+ Erfahren Sie mehr über die [AsciiDoc Erweiterung](https://marketplace.visualstudio.com/items?itemName=asciidoctor.asciidoctor-vscode) auf dem Visual Studio Marketplace.
+ Die Quelldateien für die AWS Docs-Website werden gespeichert in [https://github.com/aws/aws-eks-best-practices/tree/master/latest/bpg](https://github.com/aws/aws-eks-best-practices/tree/master/latest/bpg)
+ Die Syntax ist Markdown sehr ähnlich.
+ Lesen Sie die [Syntaxreferenz](https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/) in den AsciiDoctor Dokumenten.
+ Die Docs-Plattform wird nur bereitgestellt. `latest/bpg/images` Jeder der Leitfadenabschnitte enthält einen symbolischen Link zurück zu diesem Verzeichnis. Zeigt zum Beispiel `latest/bpg/networking/images` auf`latest/bpg/images`.
## Richten Sie eine lokale Bearbeitungsumgebung ein
Wenn Sie das Handbuch häufig bearbeiten möchten, richten Sie eine lokale Bearbeitungsumgebung ein.
### Forke und klone das Repo
Sie müssen mit`git`, `github` und Texteditoren vertraut sein. Informationen zu den ersten Schritten mit `git` und `github` finden Sie in den GitHub Dokumenten unter [Erste Schritte mit Ihrem GitHub Konto](https://docs.github.com/en/get-started/onboarding/getting-started-with-your-github-account).
1. Den [EKS Best Practices Guide finden Sie unter GitHub](https://github.com/aws/aws-eks-best-practices).
1. Erstellen Sie einen Fork des Projekt-Repos. In den GitHub Dokumenten erfahren Sie[, wie Sie ein Repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#forking-a-repository) forken.
1. Klonen Sie Ihren Fork des Projekt-Repositorys. Erfahre, wie du [dein geforktes Repository klonen kannst](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#cloning-your-forked-repository).
### Öffnen Sie den VS Code Workspace
AWS empfiehlt, Visual Studio Code von Microsoft zu verwenden, um den Leitfaden zu bearbeiten. Weitere Informationen zu VS Code finden [Sie unter Visual Studio Code herunterladen](https://code.visualstudio.com/download) und [Erste Schritte mit Visual Studio Code](https://code.visualstudio.com/docs/getstarted/getting-started) in der Visual Studio Code-Dokumentation.
1. Öffnen Sie VS Code.
1. Öffnen Sie die `bpg-docs.code-workspace` Datei aus dem geklonten Repo.
1. Wenn Sie diesen Arbeitsbereich zum ersten Mal öffnen, akzeptieren Sie die Aufforderung zur Installation der AsciiDoc Erweiterung. Diese Erweiterung überprüft die Syntax von AsciiDoc Dateien und generiert eine Live-Vorschau.
1. Navigieren Sie zum `latest/bpg` Verzeichnis. Dieses Verzeichnis enthält die Quelldateien, die auf der AWS-Dokumentationsseite bereitgestellt werden. Die Quelldateien sind nach Abschnitten mit Anleitungen wie „Sicherheit“ oder „Netzwerk“ gegliedert.
### Bearbeiten einer Datei
1. Öffnen Sie eine Datei im Editor.
+ In der AsciiDoc Syntax erfahren Sie, wie Sie Überschriften, Links und Listen erstellen.
+ Sie können die Markdown-Syntax verwenden, um Text zu formatieren, Listen und Überschriften zu erstellen. Sie können die Markdown-Syntax nicht verwenden, um Links zu erstellen.
1. Öffnen Sie eine Live-Vorschau der Seite.
+ Drücken Sie zunächst `ctrl-k` oder `cmd-k` (je nach Tastatur). Zweitens drücken Sie`v`. Dadurch wird eine Vorschau in geteilter Ansicht geöffnet.
AWS schlägt vor, Feature-Branches zu verwenden, um Ihre Änderungen zu organisieren. Erfahren Sie, wie Sie mit Git Branches erstellen.
### Reichen Sie eine Pull-Anfrage ein
Sie können eine Pull-Anfrage von der GitHub Website oder der GitHub CLI aus erstellen.
Erfahre, wie du mithilfe der GitHub Website [eine Pull-Anfrage von einem Fork aus erstellst](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork).
Erfahre, wie du mithilfe der GitHub CLI [eine Pull-Anfrage erstellst](https://cli.github.com/manual/gh_pr_create).
## Verwenden Sie den webbasierten Editor github.dev
Der `github.dev` webbasierte Editor basiert auf VS Code. Dies ist eine hervorragende Möglichkeit, mehrere Dateien zu bearbeiten und eine Vorschau von Inhalten ohne Einrichtung anzuzeigen.
Es unterstützt die AsciiDoc Erweiterung. Sie können Git-Operationen mit der GUI ausführen. Der webbasierte Editor verfügt weder über eine Shell noch über ein Terminal zum Ausführen von Befehlen.
Sie müssen ein GitHub Konto haben. Bei Bedarf werden Sie aufgefordert, sich anzumelden.
[🚀 Starten Sie den GitHub webbasierten Editor.](https://github.dev/aws/aws-eks-best-practices/blob/master/bpg-docs.code-workspace?workspace=true)
## Bearbeiten Sie eine einzelne Seite
Sie können einzelne Seiten schnell aktualisieren, indem Sie GitHub Jede Seite enthält unten den Link GitHub "📝 Diese Seite bearbeiten auf".
1. Navigieren Sie zu der Seite in diesem Handbuch, die Sie bearbeiten möchten
1. Klicken Sie unten auf den Link GitHub „Diese Seite bearbeiten auf“
1. Klicken Sie oben rechts im GitHub Dateiviewer auf das Bleistiftsymbol „Bearbeiten“ oder drücken Sie `e`
1. Bearbeiten Sie die Datei
1. Reichen Sie Ihre Änderungen mit der Schaltfläche „Änderungen übernehmen...“ ein. Diese Schaltfläche erstellt einen GitHub Pull-Request. Die Betreuer des Leitfadens werden diesen Pull-Request überprüfen. Ein Prüfer wird den Pull-Request genehmigen oder Änderungen beantragen.
## Die ID für eine Seite anzeigen und festlegen
Auf dieser Seite wird erklärt, wie die Seiten-ID angezeigt und festgelegt wird.
Die Seiten-ID ist eine eindeutige Zeichenfolge, die jede Seite auf der Dokumentationsseite identifiziert. Sie können die Seiten-ID in der Adressleiste Ihres Browsers sehen, wenn Sie sich auf einer bestimmten Seite befinden. Die Seiten-ID wird für die URL, den Dateinamen und zum Erstellen von Querverweislinks verwendet.
Wenn Sie sich diese Seite ansehen, sieht die URL in der Adressleiste Ihres Browsers beispielsweise wie folgt aus:
```
https://docs.aws.amazon.com/view-set-page-id.html
```
Der letzte Teil der URL (`view-set-page-id`) ist die Seiten-ID.
### Stellen Sie die Seiten-ID ein
Wenn Sie eine neue Seite erstellen, müssen Sie die Seiten-ID in der Quelldatei festlegen. Die Seiten-ID sollte eine kurze Zeichenfolge mit Bindestrich sein, die den Seiteninhalt beschreibt.
1. Öffnen Sie die Quelldatei für Ihre neue Seite in einem Texteditor.
1. Fügen Sie am Anfang der Datei die folgende Zeile hinzu. Sie sollte über der ersten Überschrift stehen.
```
[#my-new-page]
```
`my-new-page`Ersetzen Sie es durch die Seiten-ID für Ihre neue Seite.
1. Speichern Sie die Datei.
**Anmerkung**
Die Seite IDs muss auf der gesamten Dokumentationsseite eindeutig sein. Wenn Sie versuchen, eine vorhandene Seiten-ID zu verwenden, erhalten Sie einen Erstellungsfehler.
## Erstellen einer neuen Seite
Erfahren Sie, wie Sie eine neue Seite erstellen und das Inhaltsverzeichnis der Anleitung aktualisieren.
### Seitenmetadaten erstellen
1. Ermitteln Sie den Seitentitel und den Kurztitel der Seite. Der Kurztitel der Seite ist optional, wird jedoch empfohlen, wenn der Seitentitel mehr als ein paar Wörter umfasst.
1. Ermitteln Sie die ID der Seite. Dies muss innerhalb des EKS Best Practices Guide eindeutig sein. Die Konvention besteht darin, ausschließlich Kleinbuchstaben und separate Wörter mit `-` zu verwenden.
1. Erstellen Sie eine neue ASCIIDOC-Datei, falls erforderlich, in einem Ordner, und fügen Sie der Datei den folgenden Text hinzu:
**Example**
[.“ Thema "] [\$1] = :info\$1titleabbrev: < > page-short-title
Zum Beispiel
**Example**
[.“ topic "] [\$1scalability] = Bewährte Methoden zur Skalierbarkeit von EKS: info\$1titleabbrev: Skalierbarkeit
### Zum Inhaltsverzeichnis hinzufügen
1. Öffnen Sie die Datei für die übergeordnete Seite im Inhaltsverzeichnis. Für neue Abschnitte des Leitfadens auf oberster Ebene lautet die übergeordnete Datei`book.adoc`.
1. Aktualisieren Sie am Ende der übergeordneten Datei die folgende Anweisung und fügen Sie sie ein:
**Example**
beinhalten: [leveloffset=\$11]
Zum Beispiel
**Example**
beinhalten: :dataplane.adoc [leveloffset=\$11]
## Fügen Sie ein Bild ein
1. Suchen Sie das Bildpräfix für die Seite, die Sie bearbeiten. Überprüfen Sie die `:imagesdir:` Eigenschaft in der Überschrift der Datei. Zum Beispiel ``:imagesdir: images/reliability/`
1. Platzieren Sie Ihr Bild in diesem Pfad, z. B. `latest/bpg/images/reliability`
1. Ermitteln Sie den passenden Alt-Text für Ihr Bild. Schreiben Sie eine kurze allgemeine Beschreibung des Bildes. Beispielsweise ist „Diagramm einer VPC mit drei Verfügbarkeitszonen“ ein geeigneter Alt-Text.
1. Aktualisieren Sie das folgende Beispiel mit dem Alt-Text und dem Bilddateinamen. Fügen Sie es an der gewünschten Stelle ein.
**Example**
Bild:: [< image-alt-text >]
Zum Beispiel
**Example**
image:: eks-data-plane-connectivity .jpeg [Netzwerkdiagramm]
## Überprüfen Sie den Stil mit Vale
1. [Installieren Sie die Vale-CLI.](https://vale.sh/docs/vale-cli/installation/)
1. Führen Sie Folgendes aus:`vale sync`
1. Installieren Sie die [Vale-Erweiterung](https://marketplace.visualstudio.com/items?itemName=ChrisChinchilla.vale-vscode) vom Visual Studio Marketplace.
1. Starten Sie VS Code neu und öffnen Sie eine AsciiDoc Datei
1. VS Code unterstreicht problematischen Text. In den VS Code-Dokumenten erfahren Sie, wie Sie mit [Fehlern und Warnungen](https://code.visualstudio.com/docs/editor/editingevolved#_errors-warnings) arbeiten.
## Erstellen Sie eine lokale Vorschau
1. Installieren Sie das `asciidoctor` Tool `brew` unter Linux oder macOS
+ In den Dokumenten erfahren [Sie, wie Sie asciidoctor cli installieren](https://docs.asciidoctor.org/asciidoctor/latest/install/). AsciiDoctor
+ Erfahren Sie, wie Sie [den Brew-Paketmanager installieren](https://brew.sh/index.html).
1. Öffnen Sie ein Terminal und navigieren Sie zu `latest/bpg/`
1. Führen Sie Folgendes aus:`asciidoctor book.adoc`
+ Überprüfen Sie alle Syntaxwarnungen und Fehler
1. Öffnen Sie die `book.html` Ausgabedatei.
+ Unter macOS können Sie ausführen, `open book.html` um die Vorschau in Ihrem Standardbrowser zu öffnen.
## AsciiDoc Spickzettel
### Grundlegende Formatierung
```
*bold text*
_italic text_
`monospace text`
```
### Kopfzeilen
```
= Document Title (Header 1)
== Header 2
=== Header 3
==== Header 4
===== Header 5
====== Header 6
```
### Listen
Ungeordnete Listen:
```
- Item 1
- Item 2
-- Subitem 2.1
-- Subitem 2.2
- Item 3
```
Geordnete Listen:
```
. First item
. Second item
.. Subitem 2.1
.. Subitem 2.2
. Third item
```
### Links
```
External link: https://example.com[Link text]
Internal link: <>
Internal link: xref:page-id[Link text]
```
### Bilder
```
image::image-file.jpg[Alt text]
```
### Code-Blöcke
```
[source,python]
----
def hello_world():
print("Hello, World!")
----
```
### Tabellen
[Erfahren Sie, wie Sie eine einfache Tabelle erstellen.](https://docs.asciidoctor.org/asciidoc/latest/tables/build-a-basic-table/)
```
[cols="1,1"]
|===
|Cell in column 1, row 1
|Cell in column 2, row 1
|Cell in column 1, row 2
|Cell in column 2, row 2
|Cell in column 1, row 3
|Cell in column 2, row 3
|===
```
### Ermahnungen
```
NOTE: This is a note admonition.
WARNING: This is a warning admonition.
TIP: This is a tip admonition.
IMPORTANT: This is an important admonition.
CAUTION: This is a caution admonition.
```
Vorversion:
**Anmerkung**
Dies ist eine kurze Ermahnung.
### Umfasst
```
include::filename.adoc[]
```