Merge branch 'main' into patch-3

.github/workflows/codespell.yml

@@ -17,7 +17,7 @@ jobs:
 
       - name: Get changed files
         id: changed-files
-        uses: tj-actions/[email protected].4
+        uses: tj-actions/[email protected].5
         with:
           # Ignore all other languages except English
           files_ignore: |

.github/workflows/labeler.yml

@@ -1,11 +1,15 @@
 name: PR Labeler
-on: pull_request_target
+on: 
+  pull_request_target:
+  pull_request:
+    types:
+      - ready_for_review
 permissions:
   pull-requests: write
 jobs:
   labeler:
     runs-on: ubuntu-latest
     steps:
-    - uses: tldr-pages/tldr-labeler-action@v0.4.0
+    - uses: tldr-pages/tldr-labeler-action@v0.5.0
       with:
         token: "${{ secrets.GITHUB_TOKEN }}"

contributing-guides/style-guide.md

@@ -468,7 +468,20 @@ When documenting optional placeholders like paths or file extensions, it is sugg
 
 ## Language-Specific Rules
 
-The below section contains additional language-specific rules for translating pages:
+The below section contains additional language-specific rules:
+
+### English-Specific Rules
+
+A normal hyphen (`-`) should be used in places where various style guides may recommend en dash (`–`) or em dash (`—`).
+
+- For example, use `for lengths 3-12` rather than `for lengths 3–12`
+
+The reason for this is four-fold:
+
+1. There is no widely accepted standard among various style guides on when each of these dashes should be used.
+2. Hyphen (`-`) is the only dash-like character in ASCII, which reduces the likelihood of compatibility issues.
+3. Hyphen (`-`) is by far the easiest to type.
+4. Many English speakers, especially non-native ones, are not aware of the difference.
 
 ### Chinese-Specific Rules
 

pages.ar/common/id.md

@@ -0,0 +1,28 @@
+# id
+
+> يعرض معرف المستخدم الحالي ومعرف المجموعة.
+> لمزيد من التفاصيل: <https://www.gnu.org/software/coreutils/id>.
+
+- عرض معرف المستخدم الحالي (UID) ومعرف المجموعة (GID) والمجموعات التي ينتمي إليها:
+
+`id`
+
+- عرض اسم المستخدم الحالي:
+
+`id -un`
+
+- عرض معرف المستخدم الحالي كرقم:
+
+`id -u`
+
+- عرض معرف المجموعة الأساسية الحالي:
+
+`id -gn`
+
+- عرض معرف المجموعة الأساسية الحالي كرقم:
+
+`id -g`
+
+- عرض معرف مستخدم آخر (UID) ومعرف المجموعة (GID) والمجموعات التي ينتمي إليها:
+
+`id {{اسم المستخدم}}`

pages.ar/linux/rm.md

@@ -0,0 +1,29 @@
+# rm
+
+> يستخدم الأمر لحذف الملفات او المجلدات
+> أنظر أيضًا: `rmdir`.
+> لمزيد من التفاصيل: <https://www.gnu.org/software/coreutils/rm>.
+
+- حذف ملفات محددة:
+
+`rm {{المسار/إلى/الملف1 المسار/إلى/الملف2 ...}}`
+
+- حذف ملفات محددة وتجاهل الملفات الغير موجودة:
+
+`rm --force {{المسار/إلى/الملف1 المسار/إلى/الملف2 ...}}`
+
+- حذف ملفات محددة مع واجهة تفاعلية قبل اي حذف للتأكد:
+
+`rm --interactive {{المسار/إلى/الملف1 المسار/إلى/الملف2 ...}}`
+
+- حذف ملفات محددة مع عرض تفاصيل حول كل عملية حذف:
+
+`rm --verbose {{المسار/إلى/الملف1 المسار/إلى/الملف2 ...}}`
+
+- حذف ملفات ومجلدات محددة بشكل تسلسلي:
+
+`rm --recursive {{المسار/إلى/الملف_أو_المجلد1 المسار/إلى/الملف_أو_المجلد2 ...}}`
+
+- حذف المجلدات الفارغة (هذه الطريقة تعتبر آمنة):
+
+`rm --dir {{المسار/إلى/المجلد}}`

pages.bs/common/false.md

@@ -1,7 +1,7 @@
 # false
 
 > Vrati izlazni kod od 1.
-> Više informacija: <https://www.gnu.org/software/coreutils/false>.
+> Više informacija: <https://www.gnu.org/software/coreutils/manual/html_node/false-invocation.html>.
 
 - Vrati izlazni kod od 1:
 

pages.de/osx/gawk.md

@@ -1,7 +1,7 @@
 # gawk
 
-> Dieser Befehl ist ein Alias von `-p linux awk`.
+> Dieser Befehl ist ein Alias von `awk`.
 
 - Zeige die Dokumentation für den originalen Befehl an:
 
-`tldr -p linux awk`
+`tldr awk`

pages.es/common/ac.md

@@ -3,18 +3,18 @@
 > Imprime estadísticas sobre cuanto tiempo han estado conectados los usuarios.
 > Más información: <https://man.openbsd.org/ac>.
 
-- Imprime cuanto tiempo ha estado conectado el usuario actual en horas:
+- Imprime cuanto tiempo ha estado conectado el usuario actual, en horas:
 
 `ac`
 
-- Imprime cuanto tiempo han estado conectados los usuarios en horas:
+- Imprime cuanto tiempo han estado conectados los usuarios, en horas:
 
 `ac -p`
 
-- Imprime cuanto tiempo ha estado conectado un usuario en particular en horas:
+- Imprime cuanto tiempo ha estado conectado un usuario en particular, en horas:
 
 `ac -p {{usuario}}`
 
-- Imprime cuánto tiempo ha estado conectado un usuario en particular en horas por día (con total):
+- Imprime cuanto tiempo ha estado conectado un usuario en particular, en horas por día (con total):
 
 `ac -dp {{usuario}}`

pages.es/common/apkeep.md

@@ -0,0 +1,16 @@
+# apkeep
+
+> Descarga archivos APK de varias fuentes.
+> Más información: <https://github.com/EFForg/apkeep>.
+
+- Descarga un archivo APK al directorio especificado:
+
+`apkeep --app {{com.example.application}} {{ruta/al/directorio}}`
+
+- Lista todas las versiones disponibles para descarga:
+
+`apkeep --app {{com.example.application}} --list-versions {{ruta/al/directorio}}`
+
+- Especifica la tienda para hacer la descarga:
+
+`apkeep --app {{com.example.application}} --download-source {{apk-pure|google-play|f-droid|huawei-app-gallery}} {{ruta/al/directorio}}`

pages.es/common/caller.md

@@ -0,0 +1,16 @@
+# caller
+
+> Imprime el contexto de la función.
+> Más información: <https://www.gnu.org/software/bash/manual/bash.html#index-caller>.
+
+- Imprime la línea y el nombre de archivo desde donde se invocó a la función actual:
+
+`caller`
+
+- Imprime la línea, la función y el nombre de archivo desde donde se invocó a la función actual:
+
+`caller 0`
+
+- Imprime la línea, el nombre de la función y el nombre del archivo de una llamada a una función `n`:
+
+`caller {{n}}`

pages.es/common/declare.md

@@ -0,0 +1,28 @@
+# declare
+
+> Declara variables y les da atributos.
+> Más información: <https://www.gnu.org/software/bash/manual/bash.html#index-declare>.
+
+- Describe una variable de cadena con el valor especificado:
+
+`declare {{variable}}="{{valor}}"`
+
+- Declara una variable entera con el valor especificado:
+
+`declare -i {{variable}}="{{valor}}"`
+
+- Describe una variable arreglo con el valor especificado:
+
+`declare -a {{variable}}=({{item_a item_b item_c}})`
+
+- Declara una variable arreglo asociativo con el valor especificado:
+
+`declare -A {{variable}}=({{[key_a]=item_a [key_b]=item_b [key_c]=item_c}})`
+
+- Declara una variable de cadena de solo lectura con el valor especificado:
+
+`declare -r {{variable}}="{{valor}}"`
+
+- Declara una variable global dentro de una función con el valor especificado:
+
+`declare -g {{variable}}="{{valor}}"`

pages.es/common/fc-list.md

@@ -0,0 +1,24 @@
+# fc-list
+
+> Lista las fuentes disponibles instaladas en el sistema.
+> Más información: <https://manned.org/fc-list>.
+
+- Devuelve una lista de las fuentes instaladas en su sistema:
+
+`fc-list`
+
+- Devuelve una lista de las fuentes instaladas con el nombre dado:
+
+`fc-list | grep '{{DejaVu Serif}}'`
+
+- Devuelve el número de fuentes instaladas con el nombre dado:
+
+`fc-list | wc -l`
+
+- Devuelve una lista de las fuentes instaladas que soportan el idioma basado en su código de idioma:
+
+`fc-list :lang={{jp}}`
+
+- Devuelve una lista de las fuentes instaladas que contienen el glifo especificado por su código Unicode:
+
+`fc-list :charset={{f303}}`

pages.es/common/latexpand.md

@@ -0,0 +1,24 @@
+# latexpand
+
+> Simplifica los archivos fuente LaTeX eliminando comentarios y resolviendo `\include`s, `\input`s, etc.
+> Más información: <https://www.ctan.org/pkg/latexpand>.
+
+- Simplifica el archivo fuente dado y guarda el resultado en el archivo de salida especificado:
+
+`latexpand --output {{ruta/a/salida.tex}} {{ruta/al/archivo.tex}}`
+
+- No elimina los comentarios:
+
+`latexpand --keep-comments --output {{ruta/a/salida.tex}} {{ruta/al/archivo.tex}}`
+
+- No expande `\include`s, `\input`s etc.:
+
+`latexpand --keep-includes --output {{ruta/a/salida.tex}} {{ruta/al/archivo.tex}}`
+
+- Expande `\usepackage`s hasta encontrar los archivos STY correspondientes:
+
+`latexpand --expand-usepackage --output {{ruta/a/salida.tex}} {{ruta/al/archivo.tex}}`
+
+- Incorpora el archivo BBL especificado:
+
+`latexpand --expand-bbl {{ruta/a/bibliografía.bbl}} --output {{ruta/a/salida.tex}} {{ruta/al/archivo.tex}}`

pages.es/common/lit.md

@@ -0,0 +1,21 @@
+# lit
+
+> Comprobador integrado LLVM para ejecutar conjuntos de pruebas estilo LLVM y Clang, resumiendo los resultados.
+> Parte de LLVM.
+> Más información: <https://www.llvm.org/docs/CommandGuide/lit.html>.
+
+- Ejecuta un caso de prueba especificado:
+
+`lit {{ruta/al/archivo_de_prueba.test}}`
+
+- Ejecuta todos los casos de prueba en un directorio especificado:
+
+`lit {{ruta/al/suite_de_pruebas}}`
+
+- Ejecuta todos los escenarios de prueba y comprueba el tiempo de ejecución de cada uno de ellos:
+
+`lit {{ruta/a/suite_de_pruebas}} --time-tests`
+
+- Ejecuta pruebas individuales con Valgrind (comprobación de memoria y prueba de fuga de memoria):
+
+`lit {{ruta/al/archivo_prueba.test}} --vg --vg-leak --vg-args={{args_con_valgrind}}`

pages.es/common/llc.md

@@ -0,0 +1,20 @@
+# llc
+
+> Compila Representación intermedia LLVM o código bit (bitcode) para el lenguaje ensamblador objetivo específico.
+> Más información: <https://www.llvm.org/docs/CommandGuide/llc.html>.
+
+- Compila un bitcode o archivo IR a un archivo ensamblador con el mismo nombre base:
+
+`llc {{ruta/al/archivo.ll}}`
+
+- Habilita todas las optimizaciones:
+
+`llc -O3 {{ruta/al/archivo.ll}}`
+
+- Dirige la salida a un archivo específico:
+
+`llc --output {{ruta/al/resultado.s}}`
+
+- Emite código, independiente de la posición que pueda reubicarse completamente:
+
+`llc -relocation-model=pic {{ruta/a/la/entrada.ll}}`

pages.es/common/lldb.md

@@ -0,0 +1,16 @@
+# lldb
+
+> El depurador LLVM de bajo nivel.
+> Más información: <https://lldb.llvm.org>.
+
+- Depura un ejecutable:
+
+`lldb {{ejecutable}}`
+
+- Asocia `lldb` a un proceso de ejecución con un PID dado:
+
+`lldb -p {{pid}}`
+
+- Espera un nuevo proceso con un nombre dado para ejecutarse y asociarse al mismo:
+
+`lldb -w -n {{nombre_del_proceso}}`

pages.es/common/lli.md

@@ -0,0 +1,20 @@
+# lli
+
+> Ejecuta directamente programas desde el código de bits LLVM (bitcode).
+> Más información: <https://www.llvm.org/docs/CommandGuide/lli.html>.
+
+- Ejecuta un código de bits o un archivo IR:
+
+`lli {{ruta/al/archivo.ll}}`
+
+- Ejecuta con argumentos de línea de comandos:
+
+`lli {{ruta/al/archivo.ll}} {{primer_argumento segundo_argumento ...}}`
+
+- Habilita todas las optimizaciones:
+
+`lli -O3 {{ruta/al/archivo.ll}}`
+
+- Carga una biblioteca dinámica antes de vincular:
+
+`lli --dlopen={{ruta/a/biblioteca.dll}} {{ruta/al/archivo.ll}}`

pages.es/common/llm.md

@@ -0,0 +1,32 @@
+# llm
+
+> Interactúa con modelos grandes de lenguaje (LLMs) a través de APIs y modelos remotos que pueden instalarse y ejecutarse en su máquina.
+> Más información: <https://llm.datasette.io/en/stable/help.html>.
+
+- Configura una clave API de OpenAI:
+
+`llm keys set openai`
+
+- Ejecuta un prompt:
+
+`llm "{{Diez nombres divertidos para un pelícano}}"`
+
+- Ejecuta un prompt de [s]istema contra un archivo:
+
+`cat {{ruta/al/archivo.py}} | llm --system "{{Explica este código}}"`
+
+- Instala paquetes de PyPI en el mismo entorno que LLM:
+
+`llm install {{paquete1 paquete2 ...}}`
+
+- Descarga y ejecuta un prompt frente a un [m]odelo:
+
+`llm --model {{orca-mini-3b-gguf2-q4_0}} "{{¿Cuál es la capital de Francia?}}"`
+
+- Crea un prompt de [s]istema y lo [s]alva como una plantilla:
+
+`llm --system '{{Eres una torta de queso sensible}}' --save {{torta_de_queso_sensible}}`
+
+- Establece un chat interactivo con un [m]odelo específico utilizando una plan[t]illa específica:
+
+`llm chat --model {{chatgpt}} --template {{torta_de_queso_sensible}}`

pages.es/common/pangolin.md

@@ -0,0 +1,12 @@
+# pangolin
+
+> Implementa la nomenclatura dinámica de linajes de SARS-CoV-2 (nomenclatura Pango).
+> Más información: <https://cov-lineages.org/resources/pangolin/usage.html>.
+
+- Ejecuta `pangolin` en el archivo FASTA especificado:
+
+`pangolin {{ruta/al/archivo.fa}}`
+
+- Utiliza el motor de análisis especificado:
+
+`pangolin --analysis-mode {{accurate|fast|pangolearn|usher}}`