Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Berkontribusi pada panduan ini
Siapa pun dapat berkontribusi pada panduan praktik terbaik. Panduan Praktik Terbaik EKS ditulis dalam AsciiDoc format pada GitHub.
## Ringkasan untuk kontributor yang ada
+ Buka [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)dengan VS Code untuk menginstal AsciiDoc ekstensi secara otomatis.
+ Pelajari lebih lanjut tentang [AsciiDoc Ekstensi](https://marketplace.visualstudio.com/items?itemName=asciidoctor.asciidoctor-vscode) di Marketplace Visual Studio.
+ File sumber untuk situs web AWS Docs disimpan di [https://github.com/aws/aws-eks-best-practices/tree/master/latest/bpg](https://github.com/aws/aws-eks-best-practices/tree/master/latest/bpg)
+ Sintaksnya sangat mirip dengan penurunan harga.
+ Tinjau [Referensi Sintaks](https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/) di AsciiDoctor dokumen.
+ Platform dokumen hanya menerapkan`latest/bpg/images`. Setiap bagian panduan memiliki tautan simbolis kembali ke direktori ini. Misalnya, `latest/bpg/networking/images` menunjuk ke`latest/bpg/images`.
## Siapkan lingkungan pengeditan lokal
Jika Anda berencana untuk sering mengedit panduan, siapkan lingkungan pengeditan lokal.
### Garpu dan kloning repo
Anda harus terbiasa dengan`git`,`github`, dan editor teks. Untuk informasi tentang memulai `git` dan`github`, lihat [Memulai GitHub akun Anda](https://docs.github.com/en/get-started/onboarding/getting-started-with-your-github-account) di GitHub dokumen.
1. Lihat [Panduan Praktik Terbaik EKS di GitHub](https://github.com/aws/aws-eks-best-practices).
1. Buat fork dari repo proyek. Pelajari cara melakukan [fork repositori](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#forking-a-repository) di dokumen. GitHub
1. Kloning garpu repo proyek Anda. Pelajari cara [mengkloning repositori bercabang Anda](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo#cloning-your-forked-repository).
### Buka Ruang Kerja VS Code
AWS merekomendasikan penggunaan Visual Studio Code dari Microsoft untuk mengedit panduan. Untuk informasi selengkapnya tentang VS Code, lihat [Download Visual Studio Code](https://code.visualstudio.com/download) dan [Memulai Visual Studio Code](https://code.visualstudio.com/docs/getstarted/getting-started) di Visual Studio Code Documentation.
1. Buka Kode VS.
1. Buka `bpg-docs.code-workspace` file dari repo kloning.
1. Jika ini adalah pertama kalinya Anda membuka ruang kerja ini, terima prompt untuk menginstal AsciiDoc ekstensi. Ekstensi ini memeriksa sintaks AsciiDoc file dan menghasilkan pratinjau langsung.
1. Jelajahi `latest/bpg` direktori. Direktori ini menyimpan file sumber yang diterapkan ke situs dokumentasi AWS. File sumber diatur oleh bagian panduan, seperti “keamanan” atau “jaringan”.
### Mengedit file
1. Buka file di editor.
+ Lihat AsciiDoc Sintaks untuk mempelajari cara membuat judul, tautan, dan daftar.
+ Anda dapat menggunakan sintaks Markdown untuk memformat teks, membuat daftar, dan judul. Anda tidak dapat menggunakan sintaks Markdown untuk membuat tautan.
1. Buka pratinjau langsung halaman.
+ Pertama, tekan `ctrl-k` atau `cmd-k` (tergantung keyboard). Kedua, tekan`v`. Ini membuka pratinjau dalam tampilan terpisah.
AWS menyarankan untuk menggunakan cabang fitur untuk mengatur perubahan Anda. Pelajari cara membuat cabang dengan git.
### Kirim Permintaan Tarik
Anda dapat membuat permintaan tarik dari GitHub situs web atau GitHub cli.
Pelajari cara [membuat permintaan tarik dari garpu](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) dengan menggunakan GitHub Situs Web.
Pelajari cara [membuat permintaan tarik](https://cli.github.com/manual/gh_pr_create) dengan menggunakan GitHub cli.
## Gunakan editor berbasis web github.dev
Editor `github.dev` berbasis web didasarkan pada VS Code. Ini adalah cara yang bagus untuk mengedit banyak file dan mempratinjau konten tanpa pengaturan apa pun.
Ini memiliki dukungan untuk AsciiDoc ekstensi. Anda dapat melakukan operasi git dengan menggunakan GUI. Editor berbasis web tidak memiliki shell atau terminal untuk menjalankan perintah.
Anda harus memiliki GitHub akun. Anda akan diminta untuk login jika diperlukan.
[🚀 Luncurkan editor GitHub berbasis web.](https://github.dev/aws/aws-eks-best-practices/blob/master/bpg-docs.code-workspace?workspace=true)
## Mengedit satu halaman
Anda dapat dengan cepat memperbarui halaman individual dengan menggunakan GitHub. Setiap halaman berisi tautan "📝 Edit halaman ini di GitHub" di bagian bawah.
1. Arahkan ke halaman dalam panduan ini yang ingin Anda edit
1. Klik tautan “Edit halaman ini di GitHub” di bagian bawah
1. Klik ikon edit pensil di kanan atas penampil GitHub file, atau tekan `e`
1. Edit file
1. Kirim perubahan Anda menggunakan tombol “Komit perubahan...”. Tombol ini membuat permintaan GitHub tarik. Pengelola panduan akan meninjau permintaan tarik ini. Peninjau akan menyetujui permintaan tarik, atau meminta perubahan.
## Melihat dan mengatur ID untuk halaman
Halaman ini menjelaskan cara melihat dan mengatur ID halaman.
ID halaman adalah string unik yang mengidentifikasi setiap halaman di situs dokumentasi. Anda dapat melihat ID halaman di bilah alamat browser Anda saat Anda berada di halaman tertentu. ID halaman digunakan untuk URL, nama file, dan untuk membuat tautan referensi silang.
Misalnya, jika Anda melihat halaman ini, URL di bilah alamat browser Anda akan terlihat mirip dengan:
```
https://docs.aws.amazon.com/view-set-page-id.html
```
Bagian terakhir dari URL (`view-set-page-id`) adalah ID halaman.
### Mengatur ID halaman
Saat membuat halaman baru, Anda perlu mengatur ID halaman di file sumber. ID halaman harus berupa string ringkas dan tanda hubung yang menjelaskan konten halaman.
1. Buka file sumber untuk halaman baru Anda di editor teks.
1. Di bagian atas file, tambahkan baris berikut. Itu harus di atas judul pertama.
```
[#my-new-page]
```
Ganti `my-new-page` dengan ID halaman untuk halaman baru Anda.
1. Simpan file tersebut.
**catatan**
Halaman IDs harus unik di seluruh situs dokumentasi. Jika Anda mencoba menggunakan ID halaman yang ada, Anda akan mendapatkan error build.
## Buat halaman baru
Pelajari cara membuat halaman baru dan memperbarui daftar isi panduan.
### Buat metadata halaman
1. Tentukan judul halaman, dan judul pendek halaman. Judul pendek halaman adalah opsional, tetapi disarankan jika judul halaman lebih dari beberapa kata.
1. Tentukan ID halaman. Ini harus unik dalam Panduan Praktik Terbaik EKS. Konvensi adalah menggunakan semua huruf kecil, dan memisahkan kata-kata dengan. `-`
1. Buat file asciidoc baru, dalam folder jika diperlukan, dan tambahkan teks berikut ke file:
**Example**
[.” topik "] [\$1] = :info\$1titleabbrev: < > page-short-title
Misalnya,
**Example**
[.” topik "] [\$1scalability] = Praktik terbaik skalabilitas EKS:info\$1titleabbrev: Skalabilitas
### Tambahkan ke daftar isi
1. Buka file untuk halaman induk dalam daftar isi. Untuk bagian panduan tingkat atas yang baru, file induknya adalah`book.adoc`.
1. Di bagian bawah file induk, perbarui dan masukkan arahan berikut:
**Example**
termasuk:: [leveloffset = \$11]
Sebagai contoh,
**Example**
termasuk: :dataplane.adoc [leveloffset = \$11]
## Sisipkan gambar
1. Temukan awalan gambar untuk halaman yang Anda edit. Tinjau `:imagesdir:` properti di judul file. Sebagai contoh, ``:imagesdir: images/reliability/`
1. Tempatkan gambar Anda di jalur ini, seperti `latest/bpg/images/reliability`
1. Tentukan alt-text yang sesuai untuk gambar Anda. Tulis deskripsi singkat tingkat tinggi dari gambar. Misalnya, “diagram VPC dengan tiga zona ketersediaan” adalah teks alt yang sesuai.
1. Perbarui contoh berikut dengan alt-text dan nama file gambar. Masukkan di lokasi yang diinginkan.
**Example**
gambar:: [< image-alt-text >]
Misalnya,
**Example**
gambar:: eks-data-plane-connectivity .jpeg [Diagram jaringan]
## Periksa gaya dengan Vale
1. [Instal CLI Vale.](https://vale.sh/docs/vale-cli/installation/)
1. Jalankan `vale sync`
1. Instal [Vale Extension](https://marketplace.visualstudio.com/items?itemName=ChrisChinchilla.vale-vscode) dari Visual Studio Marketplace.
1. Mulai ulang VS Code, dan buka AsciiDoc file
1. VS Code menggarisbawahi teks bermasalah. Pelajari cara bekerja dengan [Kesalahan dan Peringatan](https://code.visualstudio.com/docs/editor/editingevolved#_errors-warnings) di dokumen VS Code.
## Membangun pratinjau lokal
1. Instal `asciidoctor` alat menggunakan `brew` di Linux atau macOS
+ Pelajari cara [menginstal asciidoctor cli](https://docs.asciidoctor.org/asciidoctor/latest/install/) di dokumen. AsciiDoctor
+ Pelajari caranya [instal manajer paket brew](https://brew.sh/index.html).
1. Buka terminal, dan arahkan ke `latest/bpg/`
1. Jalankan `asciidoctor book.adoc`
+ Tinjau peringatan dan kesalahan sintaks apa pun
1. Buka file `book.html` output.
+ Di macOS, Anda dapat menjalankan `open book.html` untuk membuka pratinjau di browser default Anda.
## AsciiDoc Lembar Cheat
### Pemformatan Dasar
```
*bold text*
_italic text_
`monospace text`
```
### Header
```
= Document Title (Header 1)
== Header 2
=== Header 3
==== Header 4
===== Header 5
====== Header 6
```
### Daftar
Daftar Tidak Berurutan:
```
- Item 1
- Item 2
-- Subitem 2.1
-- Subitem 2.2
- Item 3
```
Daftar yang Dipesan:
```
. First item
. Second item
.. Subitem 2.1
.. Subitem 2.2
. Third item
```
### Tautan
```
External link: https://example.com[Link text]
Internal link: <>
Internal link: xref:page-id[Link text]
```
### Citra
```
image::image-file.jpg[Alt text]
```
### Blok Kode
```
[source,python]
----
def hello_world():
print("Hello, World!")
----
```
### Tabel
[Pelajari cara membuat tabel dasar.](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
|===
```
### Peringatan
```
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.
```
Pratinjau:
**catatan**
Ini adalah peringatan catatan.
### Penyertaan
```
include::filename.adoc[]
```