From c82c0c300ebc2b32b26c500084ed07a3b829a6b5 Mon Sep 17 00:00:00 2001
From: Nelson Figueroa <30811275+nelsonfigueroa@users.noreply.github.com>
Date: Mon, 24 Nov 2025 05:22:56 -0800
Subject: [PATCH] asciidoctor: add short/long options (#19584)

---
 pages.es/common/asciidoctor.md    | 6 +++---
 pages.fr/common/asciidoctor.md    | 6 +++---
 pages.id/common/asciidoctor.md    | 6 +++---
 pages.ko/common/asciidoctor.md    | 6 +++---
 pages.pt_BR/common/asciidoctor.md | 6 +++---
 5 files changed, 15 insertions(+), 15 deletions(-)

diff --git a/pages.es/common/asciidoctor.md b/pages.es/common/asciidoctor.md
index 719daa90cb..da13661e0d 100644
--- a/pages.es/common/asciidoctor.md
+++ b/pages.es/common/asciidoctor.md
@@ -9,12 +9,12 @@
 
 - Convierte un archivo `.adoc` específico a HTML y vincula una hoja de estilos CSS:
 
-`asciidoctor -a stylesheet {{ruta/al/stylesheet.css}} {{ruta/al/archivo.adoc}}`
+`asciidoctor {{[-a|--attribute]}} stylesheet={{ruta/al/stylesheet.css}} {{ruta/al/archivo.adoc}}`
 
 - Convierte un archivo específico `.adoc` en HTML incrustable, eliminando todo excepto el cuerpo:
 
-`asciidoctor --embedded {{ruta/al/archivo.adoc}}`
+`asciidoctor {{[-e|--embedded]}} {{ruta/al/archivo.adoc}}`
 
 - Convierte un archivo `.adoc` dado en un PDF utilizando la biblioteca `asciidoctor-pdf`:
 
-`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{ruta/al/archivo.adoc}}`
+`asciidoctor {{[-b|--backend]}} pdf {{[-r|--require]}} asciidoctor-pdf {{ruta/al/archivo.adoc}}`
diff --git a/pages.fr/common/asciidoctor.md b/pages.fr/common/asciidoctor.md
index fd2c763da2..a9bbdc258f 100644
--- a/pages.fr/common/asciidoctor.md
+++ b/pages.fr/common/asciidoctor.md
@@ -9,12 +9,12 @@
 
 - Convertis un fichier `.adoc` vers un fichier HTML et lie une feuille de style CSS :
 
-`asciidoctor -a stylesheet {{chemin/vers/feuille_de_style.css}} {{chemin/vers/fichier.adoc}}`
+`asciidoctor {{[-a|--attribute]}} stylesheet={{chemin/vers/feuille_de_style.css}} {{chemin/vers/fichier.adoc}}`
 
 - Convertis un fichier `.adoc` vers un fichier HTML embarqué, en enlevant tout sauf le body :
 
-`asciidoctor --embedded {{chemin/vers/fichier.adoc}}`
+`asciidoctor {{[-e|--embedded]}} {{chemin/vers/fichier.adoc}}`
 
 - Convertis un fichier `.adoc` vers un PDF en utilisant la librairie `asciidoctor-pdf` :
 
-`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{chemin/vers/fichier.adoc}}`
+`asciidoctor {{[-b|--backend]}} pdf {{[-r|--require]}} asciidoctor-pdf {{chemin/vers/fichier.adoc}}`
diff --git a/pages.id/common/asciidoctor.md b/pages.id/common/asciidoctor.md
index dff72756dd..157e0e89dd 100644
--- a/pages.id/common/asciidoctor.md
+++ b/pages.id/common/asciidoctor.md
@@ -9,12 +9,12 @@
 
 - Ubah suatu berkas `.adoc` ke dalam format HTML dengan menggunakan suatu berkas definisi penggayaan (stylesheet) CSS:
 
-`asciidoctor -a stylesheet {{jalan/menuju/stylesheet.css}} {{jalan/menuju/berkas.adoc}}`
+`asciidoctor {{[-a|--attribute]}} stylesheet={{jalan/menuju/stylesheet.css}} {{jalan/menuju/berkas.adoc}}`
 
 - Ubah suatu berkas `.adoc` menuju format HTML layak semat (embeddable), hanya bangunkan isi tag body HTML:
 
-`asciidoctor --embedded {{jalan/menuju/berkas.adoc}}`
+`asciidoctor {{[-e|--embedded]}} {{jalan/menuju/berkas.adoc}}`
 
 - Ubah suatu berkas `.adoc` menuju PDF melalui pustaka pendukung `asciidoctor-pdf`:
 
-`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{jalan/menuju/berkas.adoc}}`
+`asciidoctor {{[-b|--backend]}} pdf {{[-r|--require]}} asciidoctor-pdf {{jalan/menuju/berkas.adoc}}`
diff --git a/pages.ko/common/asciidoctor.md b/pages.ko/common/asciidoctor.md
index 5563bd5403..a5244bc83e 100644
--- a/pages.ko/common/asciidoctor.md
+++ b/pages.ko/common/asciidoctor.md
@@ -9,12 +9,12 @@
 
 - 특정 `.adoc` 파일을 HTML로 변환하고 CSS 스타일시트 연결:
 
-`asciidoctor -a stylesheet {{경로/대상/스타일시트.css}} {{경로/대상/파일.adoc}}`
+`asciidoctor {{[-a|--attribute]}} stylesheet={{경로/대상/스타일시트.css}} {{경로/대상/파일.adoc}}`
 
 - 특정 `.adoc` 파일을 포함 가능한 HTML로 변환하고, 본문을 제외한 모든 항목을 제거:
 
-`asciidoctor --embedded {{경로/대상/파일.adoc}}`
+`asciidoctor {{[-e|--embedded]}} {{경로/대상/파일.adoc}}`
 
 - `asciidoctor-pdf` 라이브러리를 사용하여 특정 `.adoc` 파일을 PDF로 변환:
 
-`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{경로/대상/파일.adoc}}`
+`asciidoctor {{[-b|--backend]}} pdf {{[-r|--require]}} asciidoctor-pdf {{경로/대상/파일.adoc}}`
diff --git a/pages.pt_BR/common/asciidoctor.md b/pages.pt_BR/common/asciidoctor.md
index bb450f84a1..e106665014 100644
--- a/pages.pt_BR/common/asciidoctor.md
+++ b/pages.pt_BR/common/asciidoctor.md
@@ -9,12 +9,12 @@
 
 - Converte um arquivo `.adoc` em HTML e liga a uma folha de estilos CSS:
 
-`asciidoctor -a stylesheet {{caminho/para/estilos.css}} {{caminho/para/arquivo.adoc}}`
+`asciidoctor {{[-a|--attribute]}} stylesheet={{caminho/para/estilos.css}} {{caminho/para/arquivo.adoc}}`
 
 - Converte um arquivo `.adoc` em um HTML embutível, removendo tudo exceto o corpo:
 
-`asciidoctor --embedded {{caminho/para/arquivo.adoc}}`
+`asciidoctor {{[-e|--embedded]}} {{caminho/para/arquivo.adoc}}`
 
 - Converte um arquivo `.adoc` em PDF usando a biblioteca `asciidoctor-pdf`:
 
-`asciidoctor --backend {{pdf}} --require {{asciidoctor-pdf}} {{caminho/para/arquivo.adoc}}`
+`asciidoctor {{[-b|--backend]}} pdf {{[-r|--require]}} asciidoctor-pdf {{caminho/para/arquivo.adoc}}`