Merge branch 'main' into hello-updates

Author: nelsonfigueroa

contributing-guides/style-guide.md

@@ -430,6 +430,7 @@ For example, `[d]ownload` in English may be translated into `[d]escargar` in Spa
 - Prefer not grouping options that take in arguments (i.e. `{{[-it|--interactive --tty]}} {{[-w|--workdir]}} {{path/to/directory}}` instead of `{{[-itw|--interactive --tty --workdir]}} {{path/to/directory}}`)
 - Prefer using a space instead of the equals sign (`=`) to separate options from their arguments (i.e. use `--opt arg` instead of `--opt=arg`), unless the program does not support it.
 - Likewise prefer separating shortform options from their arguments with a space (i.e. use `-o arg` instead of `-oarg`), unless the program does not support it.
+- If a command only supports `-oarg` and `--opt=arg` the option placeholder should be written like this `{{[-o|--opt=]}}arg`. Keep in mind how the command would look if a client were to display only short or only long options.
 
 ### Placeholder syntax
 

pages.de/common/exa.md

@@ -1,35 +1,35 @@
 # exa
 
 > Ein moderner Ersatz für `ls` (Verzeichnisinhalte auflisten).
-> Weitere Informationen: <https://github.com/ogham/exa>.
+> Weitere Informationen: <https://github.com/ogham/exa#command-line-options>.
 
 - Liste eine Datei pro Zeile auf:
 
-`exa --oneline`
+`exa {{[-1|--oneline]}}`
 
 - Liste alle Dateien auf, einschließlich versteckter Dateien:
 
-`exa --all`
+`exa {{[-a|--all]}}`
 
 - Liste alle Dateien im langen Format auf (Berechtigungen, Eigentümer, Größe und Änderungsdatum):
 
-`exa --long --all`
+`exa {{[-l|--long]}} {{[-a|--all]}}`
 
 - Liste Dateien nach Größe absteigend sortiert auf:
 
-`exa --reverse --sort={{size}}`
+`exa {{[-r|--reverse]}} {{[-s|--sort]}} {{size}}`
 
 - Zeige Dateien in einer Baumstruktur an, die drei Ebenen tief ist:
 
-`exa --long --tree --level={{3}}`
+`exa {{[-l|--long]}} {{[-T|--tree]}} {{[-L|--level]}} {{3}}`
 
 - Liste Dateien nach Änderungsdatum aufsteigend sortiert auf:
 
-`exa --long --sort={{modified}}`
+`exa {{[-l|--long]}} {{[-s|--sort]}} {{modified}}`
 
 - Liste Dateien inklusive Header, Icons und Git-Status:
 
-`exa --long --header --icons --git`
+`exa {{[-l|--long]}} {{[-h|--header]}} --icons --git`
 
 - Liste keine Dateien auf, die in `.gitignore` erwähnt werden:
 

pages.es/common/exa.md

@@ -1,35 +1,35 @@
 # exa
 
 > Un reemplazo moderno para `ls` (Lista el contenido de los directorios).
-> Más información: <https://github.com/ogham/exa>.
+> Más información: <https://github.com/ogham/exa#command-line-options>.
 
 - Lista archivos uno por línea:
 
-`exa --oneline`
+`exa {{[-1|--oneline]}}`
 
 - Lista todos los archivos, incluidos los ocultos:
 
-`exa --all`
+`exa {{[-a|--all]}}`
 
 - Lista en formato largo (permisos, propiedad, tamaño y fecha de modificación) de todos los archivos:
 
-`exa --long --all`
+`exa {{[-l|--long]}} {{[-a|--all]}}`
 
 - Muestra los archivos con el más grande al principio:
 
-`exa --reverse --sort={{size}}`
+`exa {{[-r|--reverse]}} {{[-s|--sort]}} {{size}}`
 
 - Muestra un árbol de archivos de tres niveles de profundidad:
 
-`exa --long --tree --level={{3}}`
+`exa {{[-l|--long]}} {{[-T|--tree]}} {{[-L|--level]}} {{3}}`
 
 - Lista los archivos ordenados por fecha de modificación (los más antiguos primero):
 
-`exa --long --sort={{modified}}`
+`exa {{[-l|--long]}} {{[-s|--sort]}} {{modified}}`
 
 - Lista de archivos con sus cabeceras, iconos y estados Git:
 
-`exa --long --header --icons --git`
+`exa {{[-l|--long]}} {{[-h|--header]}} --icons --git`
 
 - No lista los archivos mencionados en `.gitignore`:
 

pages.es/osx/bc.md

@@ -14,16 +14,16 @@
 
 - Calcula una expresión:
 
-`bc --expression='{{5 / 3}}'`
+`bc --expression '{{5 / 3}}'`
 
 - Ejecuta un script:
 
 `bc {{ruta/al/script.bc}}`
 
 - Calcula una expresión con la escala especificada:
 
-`bc --expression='scale = {{10}}; {{5 / 3}}'`
+`bc --expression '{{scale = 10; 5 / 3}}'`
 
 - Calcula una función seno/coseno/arctangente/logaritmo natural/exponencial utilizando `mathlib`:
 
-`bc --mathlib --expression='{{s|c|a|l|e}}({{1}})'`
+`bc --mathlib --expression '{{s|c|a|l|e}}({{1}})'`

pages.es/osx/mktemp.md

@@ -9,7 +9,7 @@
 
 - Usa un directorio personalizado (por defecto la salida de `getconf DARWIN_USER_TEMP_DIR`, o `/tmp`):
 
-`mktemp --tmpdir={{/ruta/a/tempdir}}`
+`mktemp --tmpdir {{/ruta/a/tempdir}}`
 
 - Usa una plantilla de ruta personalizada (las `X` se sustituyen por caracteres alfanuméricos aleatorios):
 

pages.es/osx/say.md

@@ -9,20 +9,20 @@
 
 - Lee un archivo en voz alta:
 
-`say --input-file={{nombre_de_archivo.txt}}`
+`say --input-file {{nombre_de_archivo.txt}}`
 
 - Di una frase con una voz y un ritmo de voz personalizados:
 
-`say --voice={{voz}} --rate={{palabras_por_minuto}} "{{Lo siento David, no puedo dejarte hacer eso.}}"`
+`say --voice {{voz}} --rate {{palabras_por_minuto}} "{{Lo siento David, no puedo dejarte hacer eso.}}"`
 
 - Lista las voces disponibles (cada voz habla en un idioma distinto):
 
-`say --voice="?"`
+`say --voice "?"`
 
 - Di algo en polaco:
 
-`say --voice={{Zosia}} "{{Litwo, ojczyzno moja!}}"`
+`say --voice {{Zosia}} "{{Litwo, ojczyzno moja!}}"`
 
 - Crea un archivo de audio con el texto hablado:
 
-`say --output-file={{nombre_de_fichero.aiff}} "{{Aquí están los locos.}}"`
+`say --output-file {{nombre_de_fichero.aiff}} "{{Aquí están los locos.}}"`

pages.es/osx/shuf.md

@@ -13,7 +13,7 @@
 
 - Escribe el resultado en otro archivo:
 
-`shuf {{nombre_archivo}} --output={{nombre_archivo_salida}}`
+`shuf {{nombre_archivo}} --output {{nombre_archivo_salida}}`
 
 - Genera números aleatorios en el rango 1-10:
 

pages.fr/common/exa.md

@@ -1,35 +1,35 @@
 # exa
 
 > Une alternative moderne à `ls` (pour lister le contenu de répertoires).
-> Plus d'informations : <https://github.com/ogham/exa>.
+> Plus d'informations : <https://github.com/ogham/exa#command-line-options>.
 
 - Liste les fichiers, un par ligne :
 
-`exa --oneline`
+`exa {{[-1|--oneline]}}`
 
 - Liste tous les fichiers, y compris les fichiers cachés :
 
-`exa --all`
+`exa {{[-a|--all]}}`
 
 - Liste au format long (autorisations, propriété, taille et date de modification) de tous les fichiers :
 
-`exa --long --all`
+`exa {{[-l|--long]}} {{[-a|--all]}}`
 
 - Liste les fichiers avec le plus volumineux en haut :
 
-`exa --reverse --sort={{taille}}`
+`exa {{[-r|--reverse]}} {{[-s|--sort]}} {{size}}`
 
 - Affiche une arborescence de fichiers, sur trois niveaux de profondeur :
 
-`exa --long --tree --level={{3}}`
+`exa {{[-l|--long]}} {{[-T|--tree]}} {{[-L|--level]}} {{3}}`
 
 - Liste des fichiers triés par date de modification (le plus ancien en premier) :
 
-`exa --long --sort={{modifié}}`
+`exa {{[-l|--long]}} {{[-s|--sort]}} {{modified}}`
 
 - Liste les fichiers avec leur en-tête, leur icône et leur statut Git :
 
-`exa --long --header --icons --git`
+`exa {{[-l|--long]}} {{[-h|--header]}} --icons --git`
 
 - Liste les fichiers sauf ceux mentionnés dans `.gitignore` :
 

pages.fr/linux/ip.md

@@ -1,7 +1,7 @@
 # ip
 
 > Affiche / manipule l'adressage, le routage, les interfaces et périphériques réseau, les règles de routage et les tunnels.
-> Certaines commandes comme `ip {{[a|address]}}ess` ont leur propre documentation.
+> Certaines commandes comme `address` ont leur propre documentation.
 > Plus d'informations : <https://www.manned.org/ip.8>.
 
 - Liste les interfaces avec des infos détaillées :

pages.id/osx/shuf.md

@@ -13,7 +13,7 @@
 
 - Menuliskan output ke file lain:
 
-`shuf {{nama_file}} --output={{nama_file_output}}`
+`shuf {{nama_file}} --output {{nama_file_output}}`
 
 - Men-generate angka acak dari 1-10:
 

pages.it/common/exa.md

@@ -1,28 +1,28 @@
 # exa
 
 > Un moderno sostituto per `ls` (elenca i contenuti di una directory).
-> Maggiori informazioni: <https://github.com/ogham/exa>.
+> Maggiori informazioni: <https://github.com/ogham/exa#command-line-options>.
 
 - Elenca i file nella directory corrente, uno per riga:
 
-`exa --oneline`
+`exa {{[-1|--oneline]}}`
 
 - Elenca tutti i file, inclusi quelli nascosti:
 
-`exa --all`
+`exa {{[-a|--all]}}`
 
 - Elenca tutti i file e mostra informazioni (permessi, dimensione e data di ultima modifica):
 
-`exa --long --all`
+`exa {{[-l|--long]}} {{[-a|--all]}}`
 
 - Elenca i file, ordinandoli per dimensione decrescente:
 
-`exa --reverse --sort={{size}}`
+`exa {{[-r|--reverse]}} {{[-s|--sort]}} {{size}}`
 
 - Mostra un albero dei file con 3 livelli di profondità:
 
-`exa --long --tree --level={{3}}`
+`exa {{[-l|--long]}} {{[-T|--tree]}} {{[-L|--level]}} {{3}}`
 
 - Elenca i file e mostra informazioni, ordinandoli per ultima modifica (più vechci prima):
 
-`exa --long --sort={{modified}}`
+`exa {{[-l|--long]}} {{[-s|--sort]}} {{modified}}`

pages.it/linux/ip.md

@@ -1,7 +1,7 @@
 # ip
 
 > Mostra / manipola routing, dispositivi, criteri di routing e tunnel.
-> Alcuni sottocomandi, come `ip {{[a|address]}}ess`, hanno una propria documentazione d'uso.
+> Alcuni sottocomandi, come `address`, hanno una propria documentazione d'uso.
 > Maggiori informazioni: <https://www.manned.org/ip.8>.
 
 - Elenca le interfacce con informazioni dettagliate:

pages.ko/common/exa.md

@@ -1,35 +1,35 @@
 # exa
 
 > `ls`의 현대적인 대체품 (디렉토리 내용 나열).
-> 더 많은 정보: <https://github.com/ogham/exa>.
+> 더 많은 정보: <https://github.com/ogham/exa#command-line-options>.
 
 - 파일을 한 줄에 하나씩 나열:
 
-`exa --oneline`
+`exa {{[-1|--oneline]}}`
 
 - 숨김 파일을 포함한 모든 파일 나열:
 
-`exa --all`
+`exa {{[-a|--all]}}`
 
 - 모든 파일의 긴 형식 목록 (권한, 소유권, 크기 및 수정 날짜):
 
-`exa --long --all`
+`exa {{[-l|--long]}} {{[-a|--all]}}`
 
 - 가장 큰 파일을 맨 위에 나열:
 
-`exa --reverse --sort={{size}}`
+`exa {{[-r|--reverse]}} {{[-s|--sort]}} {{size}}`
 
 - 파일 트리를 3단계 깊이로 표시:
 
-`exa --long --tree --level={{3}}`
+`exa {{[-l|--long]}} {{[-T|--tree]}} {{[-L|--level]}} {{3}}`
 
 - 수정 날짜순으로 파일 나열 (오래된 것부터):
 
-`exa --long --sort={{modified}}`
+`exa {{[-l|--long]}} {{[-s|--sort]}} {{modified}}`
 
 - 헤더, 아이콘 및 Git 상태와 함께 파일 나열:
 
-`exa --long --header --icons --git`
+`exa {{[-l|--long]}} {{[-h|--header]}} --icons --git`
 
 - `.gitignore`에 언급된 파일은 나열하지 않음:
 

pages.ko/common/nokogiri.md

@@ -1,7 +1,7 @@
 # nokogiri
 
 > HTML, XML, SAX 및 Reader 파서.
-> 더 많은 정보: <https://nokogiri.org>.
+> 더 많은 정보: <https://manned.org/nokogiri>.
 
 - URL 또는 파일의 내용을 파싱:
 
@@ -17,7 +17,7 @@
 
 - 특정 인코딩을 사용하여 파싱:
 
-`nokogiri {{url|경로/대상/파일}} --encoding {{인코딩}}`
+`nokogiri {{url|경로/대상/파일}} {{[-E|--encoding]}} {{인코딩}}`
 
 - RELAX NG 파일을 사용하여 검증:
 

pages.ko/osx/bc.md

@@ -14,16 +14,16 @@
 
 - 수식 계산:
 
-`bc --expression='{{5 / 3}}'`
+`bc --expression '{{5 / 3}}'`
 
 - 스크립트 실행:
 
 `bc {{경로/대상/스크립트.bc}}`
 
 - 지정된 스케일로 수식 계산:
 
-`bc --expression='scale = {{10}}; {{5 / 3}}'`
+`bc --expression '{{scale = 10; 5 / 3}}'`
 
 - `mathlib`을 사용하여 사인/코사인/아크탄젠트/자연 로그/지수 함수 계산:
 
-`bc --mathlib --expression='{{s|c|a|l|e}}({{1}})'`
+`bc --mathlib --expression '{{s|c|a|l|e}}({{1}})'`

pages.ko/osx/mktemp.md

@@ -9,7 +9,7 @@
 
 - 사용자 정의 디렉터리 사용 (`getconf DARWIN_USER_TEMP_DIR`의 출력 또는 `/tmp`가 기본값):
 
-`mktemp --tmpdir={{/경로/대상/임시_폴더}}`
+`mktemp --tmpdir {{/경로/대상/임시_폴더}}`
 
 - 사용자 정의 경로 템플릿 사용 (`X`는 무작위 영숫자 문자로 대체됨):
 

pages.ko/osx/say.md

@@ -9,20 +9,20 @@
 
 - [f]파일을 소리내어 읽기:
 
-`say --input-file={{파일명.txt}}`
+`say --input-file {{파일명.txt}}`
 
 - 사용자 지정 음성과 속도로 문구 말하기:
 
-`say --voice={{음성}} --rate={{분당_단어_수}} "{{미안해 데이브, 그렇게 할 수 없어.}}"`
+`say --voice {{음성}} --rate {{분당_단어_수}} "{{미안해 데이브, 그렇게 할 수 없어.}}"`
 
 - 사용 가능한 음성 목록 나열 (다양한 언어로 말하는 음성):
 
-`say --voice="?"`
+`say --voice "?"`
 
 - 폴란드어로 말하기:
 
-`say --voice={{Zosia}} "{{Litwo, ojczyzno moja!}}"`
+`say --voice {{Zosia}} "{{Litwo, ojczyzno moja!}}"`
 
 - 음성 텍스트의 오디오 파일 생성:
 
-`say --output-file={{파일명.aiff}} "{{Here's to the Crazy Ones.}}"`
+`say --output-file {{파일명.aiff}} "{{Here's to the Crazy Ones.}}"`

pages.ko/osx/shuf.md

@@ -13,7 +13,7 @@
 
 - 출력을 다른 파일에 쓰기:
 
-`shuf {{경로/대상/입력_파일}} --output={{경로/대상/출력_파일}}`
+`shuf {{경로/대상/입력_파일}} --output {{경로/대상/출력_파일}}`
 
 - 1에서 10까지의 범위에서 무작위 숫자 생성: