Jump to content
From ArchWiki
< Help:Style (Español)
Esta traducción de Help:Style/Formatting and punctuation fue revisada el 2019-09-15. Si existen cambios puede actualizarla o avisar al equipo de traducción.

Artículos relacionados

- Help:Editing (Español)#Formato
- Help:Style (Español)#Formato

Las siguientes instrucciones definen cómo se deben resaltar las distintas partes del contenido de un artículo a través del formato o la puntuación.

## Reglas generales

Estas reglas generales se anteponen siempre a los #Casos específicos. Para los casos no tratados en esta guía, el manual de estilo de Wikipedia será la autoridad de referencia.

- No mezcle más de un método de resaltado, excepto para aquellos casos que lo permitan estas reglas explícitamente.
  Esta regla también se aplica a los casos en que las reglas de CSS ya establecen algún formato, por ejemplo, negrita en los términos de las listas de definiciones. Si el formato CSS preestablecido no está permitido en el elemento afectado (por ejemplo, negrita en #Nombres y rutas de archivos), deberá recurrir a un marcado de wiki compatible diferente (por ejemplo listas con viñetas en lugar de una lista de definiciones).
- No utilice diferentes métodos de resaltado de los definidos en este manual; esto incluye, aunque sin carácter exhaustivo, subrayado, tachado, uso de mayúsculas, colores, asteriscos, signos de exclamación, emoticonos, etiquetas HTML con un atributo `style`.

### Primeras instancias

- La primera aparición relevante de un término o nombre en un artículo (por ejemplo, nombres de ejecutables) se puede resaltar (ver a continuación) si se entiende que merece atención particular, considerando el tema del artículo o la sección específica. La primera aparición «relevante» puede no ser la primera aparición absoluta del nombre: su elección se deja al editor.
- La forma preferible de resaltar el nombre es mediante un enlace a un artículo estrechamente relacionado en la wiki o a una página externa, como Wikipedia. Si no hay enlaces pertinentes posibles, puede utilizarse negrita como solución alternativa.

  Los nombres de paquetes y grupos de paquetes deben usar las plantillas Template:Pkg, Template:AUR o Template:Grp.

- Si el nombre ya está introducido por el título del artículo o por un encabezado de sección, su primera aparición relevante en el cuerpo del texto solo se puede usar como un enlace, pero no se resalta simplemente en negrita, excepto en el caso de #Listas de nombres/términos.
- El resaltado de la primera instancia para los #Casos específicos solo se puede aplicar cuando se permita explícitamente.

### Enlaces

- No se aplicará ningún formato al texto asociado a los enlaces.

### Listas de nombres/términos

- Se permite (es decir, no es obligatorio), mantener un formato consistente en las listas de nombres o términos, incluso si normalmente no todos los elementos requieren formato. Esto puede implicar, por ejemplo, términos en mayúsculas, que no deben escribirse en cursiva por sí mismos, o nombres en una lista donde la mayoría de los elementos están formateados de acuerdo con lo expuesto en #Primeras instancias.
  Por «lista» debe entenderse en un sentido amplio, de modo que, por ejemplo, también todas las palabras iniciales de una serie de párrafos subsiguientes puedan considerarse como una lista de términos.

## Casos por formato/puntuación

Los casos marcados con 1 se ven afectados por lo dicho en #Primeras instancias. Los casos marcados con m le son de apliación el texto monoespaciado.

### Cursiva

Utilice la sintaxis de MediaWiki para el `''texto en cursiva''`, en lugar de la etiqueta `<i>`.

- #Nombres de ejecutables/aplicaciones1
- #Extensiones de archivos
- #Nombres de repositorios1
- #Nombres de paquetes y grupos1
- #Pseudovariables en archivos/contenidos de la línea de órdenesm
- #Texto de GUI/TUI
- #Términos técnicos1
- #Palabras o declaraciones enfatizadas/importantes
- #Expansión de acrónimos/abreviaturas

### Negrita

Utilice la sintaxis de MediaWiki para el `'''texto en negrita'''` en lugar de la etiqueta `<b>`.

- #Partes importante del archivo/contenidos de la línea de órdenesm
- #Palabras o declaraciones enfatizadas/importantes
- #Primeras instancias

### Monoespaciado

Utilice la plantilla Template:ic del `{{ic|texto monoespaciado}}`, en lugar de la etiqueta `<code>`, para el texto fuera de los bloques de código.

- #Nombres y rutas de archivos
- #Servicios/demonios, módulos del kernel
- #Parámetros de configuración, variables, opciones, propiedades...
- #Líneas de CLI
- #Contenidos de archivos
- #Teclas del teclado

### Entrecomillar las citas

Utilice comillas inglesas o dobles para el `"texto citado"`, en lugar de comillas simples `'texto citado'` o comillas tipográficas `“texto citado”`.

Nota: (del traductor): Las comillas inglesas o dobles se sustituirán, en las traducciones, por las comillas angulares (también llamadas latinas o españolas) del modo siguiente `«texto citado»`. Vea esto.

- #Referencias a títulos, encabezados...
- #Palabras/letras cuando hacen referencia a meras «entidades de texto»
- #Palabras genéricas usadas de manera inapropiada o cuestionable
- #Citas

## Casos específicos

Las #Reglas generales siempre prevalecen sobre los casos específicos.

### Expansión de acrónimos/abreviaturas

Utilice cursiva.

Ejemplos

- Pacman es el package manager —pacman — («administrador de paquetes») de Arch Linux.
- cat (catenate, «concatenar») es una utilidad estándar de Unix que concatena y enumera archivos.

### Líneas de CLI

Utilice `monoespaciado`. Deben ser ejemplos de órdenes en línea, no simples menciones de #Nombres de ejecutables/aplicaciones. También el texto y la salida de la consola que pueden ser razonablemente útiles para pegar en un terminal.

Ejemplos

- Se recomienda que escriba `man orden` para leer la página del manual de cualquier orden.
- Puede utilizar la orden `ip link` para descubrir los nombres de las interfaces.
- Si recibe un error `ping: unknown host`, verifique primero si hay un problema con el cableado de la red o con la potencia de la señal inalámbrica.
- Escriba `yes` y elija Quit (o presione `Q`) para salir sin hacer más cambios.
- Ejecute `pacman -Syu` con privilegios de root.

### Parámetros de configuración, variables, opciones, propiedades...

Utilice `monoespaciado`. También afecta a las opciones de órdenes, grupos de usuarios, direcciones IP, variables de entorno y variables en general.

Cuando se representa tanto la forma corta como la forma larga de una opción de orden, tilice el símbolo «/» sin espacios para separarlos, por ejemplo, `-a`/`--anything`.

Ejemplos

- De forma predeterminada, la distribución del teclado está establecida para `us`.
- [...] donde layout puede ser `fr`, `uk`, `dvorak`, `be-latin1`, etc.
- A partir de v197, udev ya no asigna nombres de interfaces de red según el esquema de nombres `wlanX` y `ethX`.
- En este ejemplo, la interfaz de ethernet es `enp2s0f0`.
- Si no está seguro, es probable que su interfaz de ethernet comience con la letra «e» o con la letra «w», siemdo improbabe que sea `lo`.
- Actualmente, puede incluir un máximo de tres líneas de `nameserver`.
- Necesitará crear una BIOS Boot Partition de 1007 KiB de tamaño y con el código tipo `EF02`.
- Todos los archivos deben tener permisos `644` y ser propiedad `root:root`.
- El indicador `-i` se puede omitir si desea instalar todos los paquetes del grupo base sin preguntar.
- Agregar su usuario a los grupos (`sys`, `disk`, `lp`, `network`, `video`, `audio`, `optical`, `storage`, `scanner`, `power`, etc.) no es necesario para la mayoría de los casos al uso con systemd.
- Si está detrás de un servidor proxy, deberá exportar las variables de entorno `http_proxy` y `ftp_proxy`.
- Para usar otras configuraciones regionales para otras variables `LC_*`, ejecute `locale` para ver las opciones disponibles y agréguelas a locale.conf. No se recomienda establecer la variable `LC_ALL`. Consulte Locale#Setting the system locale para ver un ejemplo avanzado.
- [...] esto equivale aproximadamente a lo que se incluía en la matriz `DAEMONS`.
- Si está ejecutando una red privada, es seguro usar direcciones IP en `192.168.*.*` para sus direcciones IP, con una máscara de subred de `255.255.255.0` y una dirección de broadcast de `192.168.*.255`. La puerta de enlace suele ser `192.168.*.1` o `192.168.*.254`.
- Al asignar el argumento `-net nic` a QEMU, ello asignará a una máquina virtual una interfaz de red con la dirección de nivel de enlace `52:54:00:12:34:56`.

### Servicios/demonios, módulos del kernel

Utilice `monoespaciado`.

Ejemplo

- El servicio `dhcpcd.service` inicia el demonio para todas las interfaces de red.
- Algunos nombres de unidades contienen un signo `@` (por ejemplo, `nombre@cadena.service`).

### Nombres de ejecutables/aplicaciones

Utilice cursiva, pero solo para minúsculas completas. Afectado por #Primeras instancias.

Tenga en cuenta que esta regla se aplica a los ejecutables solo cuando representan la aplicación/archivo en sí, no cuando se usan en #Líneas de CLI. En particular, preste atención a los ejecutables que normalmente se ejecutan sin ningún argumento. Vea también Help:Style (Español)#Ortografía.

Ejemplos

- Descomente la configuración regional seleccionada en `/etc/locale.gen` y genérela con la utilidad locale-gen.
- Descomente la configuración regional seleccionada en `/etc/locale.gen` y genérela con `locale-gen`.
- A partir de la v197, udev ya no asigna nombres de interfaces de red según el esquema de nombres `wlanX` y `ethX`.
- El soporte de instalación de Arch Linux incluye las siguientes herramientas de partición: fdisk, gdisk, cfdisk, cgdisk, parted.
- Si pacman no puede verificar sus paquetes, compruebe la hora del sistema con `cal`.
- Establezca una contraseña de root con la orden `passwd`.

### Contenidos de archivos

Utilice `monoespaciado` para el contenido que se puede leer o escribir en un archivo o que puede ser útil para copiar o pegar en un editor de texto.

Ejemplos

- Al final de la cadena escriba `nomodeset` y presione `Intro`. En otro caso, pruebe con `video=SVIDEO-1:d` que, si funciona, no desactivará la configuración del modo kernel.
- Elimine el signo `#` delante del locale[enlace roto 2022-09-23] que desee, presente en `/etc/locale.gen`.

### Extensiones de archivos

Utilice cursiva.

Ejemplo

- Pacman está escrito en lenguaje de programación C y utiliza el formato .pkg.tar.xz para los paquetes.

### Nombres y rutas de archivos

Utilice `monoespaciado`. También se ven afectados nombres de dispositivos y nombres con comodines. Sin embargo, las #Extensiones de archivos se tratan de manera diferente.

Ejemplos

- Para comprobar si ha arrancado en modo UEFI, compruebe que se ha creado el directorio `/sys/firmware/efi`.
- Todos los archivos y directorios aparecen en el directorio raíz `/`, incluso si están almacenados en diferentes dispositivos físicos.
- Edite `/etc/resolv.conf`, sustituyendo las direcciones IP de sus servidores de nombres y su nombre de dominio local.
- Antes de instalar, es posible que desee editar el archivo `mirrorlist` y colocar primero su servidor de réplica preferido.
- Para que los módulos del kernel se carguen durante el arranque, coloque un archivo .conf con el nombre del programa que lo va a usar en `/etc/modules-load.d/`.
- Cada partición se identifica con un sufijo numérico. Por ejemplo, `sda1` especifica la primera partición de la primera unidad, mientras que `sda` designa la unidad completa.

### Palabras genéricas usadas de manera inapropiada o cuestionable

Utilice «comillas dobles».

Ejemplo

- Palabras/letras cuando hacen referencia a meras "entidades de texto".

### Texto de GUI/TUI

Utilice cursiva. Por ejemplo para entradas de menú. Al representar la navegación en los menús, use el símbolo «>», emarcados en «cursiva», para separar los elementos.

Ejemplos

- Luego, seleccione Boot Arch Linux en el menú y presione `Intro` para comenzar la instalación.
- Cuando se usa Gparted, al seleccionar la opción para crear una nueva tabla de partición, se obtiene una tabla de partición msdos de forma predeterminada. Si tiene la intención de seguir los consejos para crear una tabla de particionado GPT, debe seleccionar Avanzado y luego seleccionar gpt en el menú desplegable.
- Escriba `yes` y elija Quit (o presione `Q`) para salir sin hacer más cambios.
- Para que los complementos se actualicen, debe verificar que sus repositorios de sincronización estén activados en Ventana > Preferencias > Instalar/Actualizar > Sitios de software disponibles.

### Partes importante del archivo/contenidos de la línea de órdenes

Utilice negrita. Dado que estos contenidos son códigos en sí mismos, cuando se hace referencia fuera de la plantilla, se debe conservar el `monoespaciado`.

Ejemplo

-     # ln -s /usr/src/linux-$(uname -r)/include/generated/uapi/linux/version.h /usr/src/linux-$(uname -r)/include/linux/

  Puede reemplazar `$(uname -r)` con cualquier kernel que no se esté ejecutando en ese momento.

### Teclas del teclado

Utilice `monoespaciado`.

Ejemplo

- Tiene que presionar una tecla (generalmente `Supr`, `F1`, `F2`, `F11`, o `F12`) durante el POST.

### Nombres de paquetes y grupos

Utilice cursiva. Afectado por #Primeras instancias.

Ejemplo

- El paquete wireless_tools le proporcionará a la postre un conjunto básico de herramientas para administrar la conexión inalámbrica.

### Pseudovariables en archivos/contenidos de la línea de órdenes

Utilice cursiva. Cuando se menciona una variable fuera de la plantilla, se debe conservar el `monoespaciado`.

Asegúrese de que las variables no contengan espacios: deben usarse en su lugar guiones bajos.

Asegure igualmente de la consistencia de los nombres con el resto del artículo, que puede ser que ya esté usando una pseudovariable. Por ejemplo, no introduzca una nueva variable como `distribuciónteclado`, si ya está usando `distribución_teclado`.

Ejemplo

-     # loadkeys distribución_teclado

  [...] donde `distribución_teclado` puede ser `fr`, `uk`, `dvorak`, `be-latin1`, etc.

- Abra la interfaz con `ip link set interfaz up`.
- Puede conectarte a la red con:

      # wifi-menu nombre-interfaz

  donde `nombre-interfaz` es la interfaz de su tarjeta inalámbrica.

### Citas

Para citas en línea, utilice «comillas dobles». Para las citas de bloque, use la sangría a través de dos puntos al inicio de la línea sin ninguna puntuación o formato adicional.

Ejemplos

- "Todos sus datos nos pertenecen" – Google
- De https://www.x.org/wiki/:

  El proyecto X.Org proporciona una implementación de código abierto del sistema X Window. El trabajo de desarrollo se está realizando en conjunto con la comunidad freedesktop.org. La Fundación X.Org es una corporación educativa sin fines de lucro cuyo dirección sirve a este esfuerzo y cuyos miembros lideran este trabajo.

### Referencias a títulos, encabezados...

Utilice «comillas dobles». Sin embargo, al hacer referencia a los encabezados de las secciones, utilice enlaces internos a la (`[[#Sección]]`).

Ejemplo

- La columna "dm-crypt +/- LUKS" denota las características de dm-crypt para los modos de encriptación LUKS ("+") y plain ("-"). Si una característica específica requiere el uso de LUKS, esto se indica mediante "(con LUKS)". Del mismo modo, la indicación "(sin LUKS)" manifiesta que el uso de LUKS es contraproducente para lograr la función y se debe usar la modalidad plain.

### Nombres de repositorios

Utilice cursiva para los nombres de repositorios. Afectado por #Primeras instancias.

Ejemplo

- Para activar el repositorio testing, debe descomentar la sección `[testing]` en `/etc/pacman.conf`.
- Si activa el repositorio testing, también debe activar el repositorio community-testing.

### Palabras o declaraciones enfatizadas/importantes

Utilice cursiva para palabras cuya importancia en dar el significado a una oración no se reconocería de otra manera. Por lo general, se pronuncian de manera enfática si se lee en voz alta.

Sin embargo, cuando se necesita una atención particular, palabras como «no», «solo», «exactamente», «fuertemente», «antes de»... se pueden resaltar en negrita.

Lo mismo ocurre con las declaraciones muy importantes que no se pueden colocar en una Advertencia o Nota por separado, ya que son una parte esencial de la sección en sí.

Ejemplos

- Elija el mejor entorno para sus necesidades.
- Esta orden puede sincronizar las bases de datos del repositorio y actualizar los paquetes del sistema.
- Si la pantalla no se queda vacía y el proceso de arranque se atasca.
- [...] así que, por favor, escríbalo exactamente como lo ve.
- Si lo desea, puede convertirlo como el único servidor de réplica disponible eliminando todo lo demás.
- La partición puede destruir datos. Se le advierte y recomienda encarecidamente que realice una copia de seguridad de los datos críticos antes de continuar.
- Manténgase actualizado con los cambios en Arch Linux que requieren una intervención manual antes de actualizar su sistema.
- 'Al realizar una actualización del sistema, es esencial que los usuarios lean toda la información que proporciona pacman y utilicen el sentido común.
- Esto significa que las actualizaciones parciales no son compatibles.

### Términos técnicos

Utilice cursiva, excepto para los términos en mayúsculas (generalmente siglas). Afectado por #Primeras instancias.

Ejemplos

- Se recomienda que escriba `man orden` para leer la página del manual de cualquier orden.
- Este artículo trata sobre las denomidanas utilidades core en un sistema GNU/Linux.
- Las particiones primarias pueden ser de arranque y están limitadas a cuatro particiones por disco o volumen RAID.
- Esta es una partición separada por defecto, al estar montada como tmpf por systemd.
- Tiene que presionar una tecla (generalmente `Supr`, `F1`, `F2`, `F11` o `F12`) durante la fase POST (Power On Self-Test).

### Palabras/letras cuando hacen referencia a meras «entidades de texto»

Utilice «comillas dobles».

Ejemplos

- Sin embargo, cuando se necesita una atención particular, palabras como «no», «solo», «exactamente», «fuertemente», «antes de»... se pueden resaltar en negrita
- Si no está seguro, es probable que su interfaz de ethernet comience con la letra «e» o con la letra «w», siemdo improbabe que sea `lo`.

Category:

- Help (Español)

Hidden category:

- Pages with dead links