Contribuisci a migliorare questa pagina

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Per contribuire a questa guida per l'utente, scegli il GitHub link Modifica questa pagina nel riquadro destro di ogni pagina.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento alla sintassi AsciiDoc

AsciiDoc è il linguaggio di markup preferito per la documentazione AWS. Sebbene lo strumento supporti parzialmente la sintassi Markdown (come intestazioni ed elenchi), consigliamo di utilizzare la sintassi AsciiDoc per tutti i contenuti al fine di garantire la coerenza e il corretto rendering.

Questa guida illustra gli elementi di sintassi più comuni necessari per contribuire alla documentazione di Amazon EKS. Per una sintassi più avanzata e informazioni dettagliate, consultare AsciiDoc documentation.

Nuova pagina

Ogni nuovo documento AsciiDoc deve iniziare con la struttura definita in Creazione di una nuova pagina.

Intestazioni

Usa le intestazioni per organizzare i contenuti in modo gerarchico:

= Page/topic title (level 1)
== Section title (level 2)
=== Level 3 heading
==== Level 4 heading
===== Level 5 heading
====== Level 6 heading

Nota: usare sempre le lettere maiuscole e minuscole per le intestazioni nella documentazione di AWS.

Formattazione del testo

Formattare il testo per enfatizzare le informazioni importanti:

Use *bold text* for UI labels.
Use _italic text_ for introducing terms or light emphasis.
Use `monospace text` for code, file names, and commands.

Elenchi

Elenchi non ordinati

Creare elenchi puntati per gli elementi senza una sequenza specifica:

* First item
* Second item
** Nested item
** Another nested item
* Third item

Elenchi ordinati

Creare elenchi numerati per fasi sequenziali o elementi con priorità:

. First step
. Second step
.. Substep 1
.. Substep 2
. Third step

Link

Consultare Inserire un link per informazioni su come formattare correttamente i link. I link in stile Markdown non sono supportati.

Esempi di codice

Codice inline

Usare gli apici retroversi per il codice inline:

Use the `kubectl get pods` command to list all pods.

Blocchi di codice

Creare blocchi di codice con evidenziazione della sintassi e supporto per gli attributi (simili alle entità):

 [source,python,subs="verbatim,attributes"]
 ----
 def hello_world():
     print("Hello, World!")
 ----

Immagini

Inserire immagini con testo alternativo per l’accessibilità:

image::images/image-file.png[Alt text description]

Tabelle

Creare tabelle per organizzare le informazioni:

[%header,cols="2"]
|===
|Header 1
|Header 2

|Cell 1,1
|Cell 1,2

|Cell 2,1
|Cell 2,2
|===

Per tabelle più complesse, consultare AsciiDoc table documentation.

Callout

Usare i callout per evidenziare informazioni e ammonizioni importanti:

NOTE: This is a note callout for general information.

TIP: This is a tip callout for helpful advice.

IMPORTANT: This is an important callout for critical information.

Anteprima:

Includere altri file

Includere contenuti da altri file:

 include::filename.adoc[]

Attributi (simili alle entità)

Utilizzare attributi predefiniti per mantenere la coerenza. In particolare, DEVI utilizzare gli attributi per AWS e arn:aws: .

{aws} provides Amazon EKS as a managed Kubernetes service.

 [source,bash,subs="verbatim,attributes"]
 ----
 aws iam attach-role-policy \
     --role-name AmazonEKSAutoClusterRole \
     --policy-arn {arn-aws}iam::aws:policy/AmazonEKSClusterPolicy
 ----

Per un elenco degli attributi, cercare nel file ../attributes.txt.

Procedure

Procedure dettagliate per il formato:

To create an Amaozon EKS cluster. do the following steps.

. Sign in to the {aws} Management Console.
. Open the Amazon EKS console.
. Choose *Create cluster*.

...