Help:Editing (Español)

From ArchWiki
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.
Estado de la traducción: esta traducción de Help:Editing fue revisada el 2019-09-15. Si existen cambios puede actualizarla o avisar al equipo de traducción.

ArchWiki está basado en MediaWiki, un paquete de software wiki libre escrito en PHP, originariamente para su uso en Wikipedia. Se puede encontrar información más detallada en Help:Contents de MediaWiki y en Ayuda:Contenidos de Wikipedia.

Este es un breve tutorial sobre cómo editar en ArchWiki. Antes de editar o crear páginas, se recomienda a los usuarios familiarizarse con el tono general, el diseño y el estilo de los artículos existentes. Se debe hacer un esfuerzo para mantener un nivel de coherencia en toda la wiki. Consulte ArchWiki:Contributing (Español), Help:Style y Help:Reading para obtener una descripción general de las convenciones comunes. Para experimentar con la edición, utilice sandbox. Para obtener una descripción general del marcado de wiki, consulte Help:Cheatsheet (Español).

Crear una cuenta

Debe crear una cuenta antes de poder editar artículos de ArchWiki; para responder a la pregunta de captcha requiere un entorno actualizado de Arch Linux: los usuarios que no utilicen Arch son bienvenidos a contribuir con la wiki, y para responder a sus preguntas, puede, por ejemplo, iniciarse en un sistema Arch live con la última imagen de instalación.

Una vez que tenga una cuenta, inicie sesión desde Special:UserLogin.

Edición

Para modificar una página, pinche en la pestaña editar que verá en la parte superior de la página. También se puede modificar una sección específica de un artículo pinchando en el enlace editar que se encuentra a la derecha del encabezado de la sección. Se mostrará la edición de la página o sección, que consta de los siguientes elementos:

  • En la parte superior: una barra de herramientas, con iconos, para dar formato al texto (opcional).
  • En la parte central: un recuadro para insertar el cuerpo de la edición.
  • En la parte inferior:
  • Campo para el Resumen de la edición.
  • Botones para: Guardar cambios, Mostrar previsualización, Mostrar Cambios, Cancelar y Ayuda de edición (se abre en una ventana nueva)

El cuerpo de la edición contendrá el wikitexto (esto es, el código fuente editable del cual el servidor genera la página web) para la revisión actual de la página o sección. Para realizar una edición:

  1. Modifique la wikitexto conforme lo que considere necesario (vea #Formato para más detalles).
  2. Explique el motivo de la edición en el campo Resumen (por ejemplo, «corregir ortografía» o «información adicional sobre xyz» (consulte Help:Edit summary para más detalles).
    Nota: todas las ediciones deben ir acompañadas de un breve resumen descriptivo. Consulte ArchWiki:Contributing#The 3 fundamental rules para obtener más información.
  3. Utilice el botón Mostrar previsualización para facilitar la corrección de pruebas y verificar el formato antes de guardar.
  4. Señale la edición como menor, marcando la casilla Esta es una edición menor si considera que la edición es superficial o indiscutible.
  5. Guarde los cambios haciendo clic en Guardar cambios. Si no queda satisfecho, haga clic en Cancelar, en su lugar (o repita el proceso hasta que esté satisfecho).
Nota: los artículos no deberían ir firmados, ya que son obras compartidas. Un colaborador no debería ser señalado por encima de otros.
Sugerencia: si no va a utilizar un editor externo como vim, es posible que desee considerar el uso de wikEd, que auna resaltado de sintaxis, búsqueda y reemplazo de expresiones regulares, y otras características interesantes para el editor estándar de MediaWiki. El script de greasemonkey funciona a la perfección con ArchWiki. Recuerde verificar siempre cualquier tarea automatizada.

Revertir ediciones

Si una página ha sido editada incorrectamente, los procedimientos siguientes describen cómo revertir un artículo a una versión anterior. Para revertir a la edición inmediatamente anterior:

  1. Haga clic en la pestaña historial en la parte superior de la página para modificar (al lado de la pestaña editar). Se listará un historial de revisiones en la pantalla.
  2. Haga clic en el enlace deshacer a la derecha de la edición. Una vista previa de la edición muestra la versión actual en la izquierda y el texto que se guardó en la derecha.
  3. Escriba la razón por la que está deshaciendo esta edición en el campo de resumen de edición.
  4. Si está conforme, haga clic en el botón Guardar cambios en la parte inferior de la página, y la versión anterior (la de la derecha) será restablecida.

La página del wiki debería estar de nuevo en su estado original.

En ocasiones, puede ser necesario revertir a una edición retrocediendo varias ediciones anteriores a la vez. Para volver un artículo a una versión más antigua:

  1. Haga clic en la pestaña historial situada en la parte superior de la página que va a modificar (al lado derecho de la pestaña editar). Se mostrará una lista de revisiones en pantalla.
  2. Busque la revisión deseada (es decir, la última versión buena) haciendo clic en la marca de fecha apropiada. Dicha versión se mostrará.
  3. Si está satisfecho, haga clic en la pestaña editar en la parte superior de la página. Se mostrará una advertencia: Está usted editando una versión desactualizada de esta páginaYou are editing an out-of-date revision of this page»).
  4. Escriba la marca de tiempo de la revisión (que se muestra en la parte superior de la página) y una razón por la que está revertiendo el estado de la página en el campo de resumen de edición.
  5. Si está satisfecho, basta con hacer clic en Guardar cambios para restablecer esta versión.
Nota: evite combinar simultáneamente deshacer y editar. Revierta la edición en primer lugar, y, a continuación, realice los cambios adicionales. La vista previa no modifica la revisión.

Creación de páginas

Antes de crear una nueva página, por favor tenga en cuenta las siguientes consideraciones:

  • ¿Es su tema relevante para Arch Linux? Los artículos irrelevantes o poco útiles serán eliminados.
  • ¿Es su tema de interés para los demás? Considere no solo lo que desea escribir, sino también lo que otros pueden querer leer. Las notas personales tienen su sitio en su página de usuario.
  • ¿Es su tema digno de una nueva página? Busque en la wiki artículos similares. Si existen, estudie la posibilidad de mejorarla o añadir una sección en el artículo ya existente.
  • ¿Su contribución será significativa? Evite la creación de notas a menos que planee expandirlas en un futuro.

La creación de una nueva página requiere la selección de un título descriptivo y una categoría adecuada.

Por favor, lea Directrices para titular artículos y Abreviar nombres de los artículos para obtener asesoramiento sobre los nombres de los artículos. No incluya «Arch Linux» o variaciones en los títulos de página. Este es el wiki Arch Linux, se presume que los artículos estarán relacionados con Arch Linux. (Por ejemplo, «Instalación de Openbox», no «Instalación de Openbox en Arch Linux»).

Visite la Tabla de contenidos para ayudarle a elegir la categoría adecuada. Los artículos pueden pertenecer a varias categorías.

Para crear una página nueva debemos, como hemos dicho antes, seguir dos pasos: titularla y agregarla a una categoría (por ejemplo «My_new_page» a «Categoría ABC»), del modo siguiente:

  1. Crearemos una página escribiendo en la barra de navegación del navegador: https://wiki.archlinux.org/title/My_new_page, donde «My_new_page» es el título elegido para su nueva página (advierta que: primero, el título debe estar en inglés y, segundo, no hay espacios en blanco, los cuales se rellenan con guiones bajos).
  2. Añada [[Category:alguna categoría]] a la parte superior de la página.
Nota: no cree páginas sin categorizar. Todas las páginas deben pertenecer, al menos, a una categoría. Si no puede encontrar una categoría apropiada, considere la posibilidad de crear una categoría nueva.

En esta etapa, el nuevo artículo todavía se considera un artículo huérfano. Para completar el trabajo, tómese un poco más de tiempo para enlazar otros artículos con el nuevo: esto mejorará su visibilidad y alentará a más usuarios a contribuir. Los posibles candidatos son artículos sobre software relacionado, páginas de información general más genéricas o incluso listas simples como List of applications (Español).

Formato

El formato del texto se logra con lenguaje wiki siempre que sea posible; el uso y conocimiento del lenguaje HTML no es necesario. También están disponibles diversas plantillas (templates) para tareas comunes de formato, véase Help:Template (Español) para obtener información acerca de las mismas. El artículo Help:Cheatsheet (Español) resume las opciones de formato más comunes.

Títulos y subtítulos

Los títulos y subtítulos son una manera fácil de mejorar la estructura de un artículo. Si un tema es susceptible de dividirse en varias partes, se puede organizar un artículo insertando un título para cada sección. Consulte Help:Style (Español)#Títulos de las secciones y Help:Effective use of headers (Español) para información sobre el estilo.

Los encabezados (o títulos) deben partir del segundo nivel, y pueden crearse de la siguiente manera:

== Segundo nivel de encabezado ==

=== Tercer nivel de encabezado ===

==== Cuarto nivel de encabezado ====

===== Quinto nivel de encabezado =====

====== Sexto nivel de encabezado ======
Nota: el primer nivel de encabezado no está permitido, su formato es reservado para el título del artículo.

Si un artículo tiene, al menos, cuatro encabezados, se generará automáticamente un índice o tabla de contenidos (TOC). Si no desea que dicha tabla se visualice en el artículo, coloque __NOTOC__ en el artículo al editarlo. Trate de crear algunas entradas en Sandbox y ver el efecto sobre la TOC.

Saltos de línea

Una línea en blanco se utiliza para iniciar un nuevo párrafo, mientras que si, durante la edición, se rompe una línea, sin espacio entre ambas, no producirá ningún efecto en la continuidad de la oración al visualizarla.

El código HTML proporciona la etiqueta <br> con la que se puede insertar manualmente los saltos de línea, pero se debe evitar. Una ruptura manual puede ser realizada con otros elementos de formato, como las listas.

wikitexto visualización
Esta declaración
se divide en
tres líneas.

Esta declaración se divide en tres líneas.

Este es el párrafo número uno.

Este es el párrafo número dos.

Este es el párrafo número uno.

Este es el párrafo número dos.

* Esta frase  <br>  se rompe en dos líneas
* Esta frase
termina la lista
  • Esta frase
    se rompe en dos líneas
  • Esta frase

termina la lista

Consulte Help:Style/White space (Español) para obtener información sobre el uso de líneas en blanco.

Texto en negrita y/o cursiva

El texto en cursiva, negrita (o ambas) se consigue agregando alrededor de una palabra o frase dos, tres o cinco apóstrofes ('), respectivamente:

wikitexto visualización

''texto en cursiva''

texto en cursiva

'''texto en negrita'''

texto en negrita

'''''texto en cursiva y negrita'''''

texto en cursiva y negrita

Texto tachado

Utilice texto tachado para indicar que el texto ya no se aplica o no tiene relevancia.

wikitexto visualización
<s>texto tachado</s>

texto tachado

Otros posibles formatos

Texto subrayado

Utilice texto subrayado para resaltar una o varias palabras de una oración sobre las que haya que reparar o darles un cierto énfasis.

wikitexto visualización
<u>texto subrayado</u>

texto subrayado

Texto centrado

El centrado del texto se consigue insertando la palabra o frase en cuestión entre las etiquetas HTML <center>.

wikitexto visualización
<center> texto centrado </center> 
texto centrado

Listas

Recuerde que la sintaxis wiki no permite elementos de listas multilínea; cada carácter de la nueva línea termina la definición del elemento de la lista. Para iniciar una nueva línea dentro de un elemento de la lista, utilice la etiqueta <br>. Para introducir un bloque de código de varias líneas dentro de un elemento de la lista, utilice Template:bc y termine el contenido utilizando las etiquetas <nowiki>. Véase también Help:Style/White space (Español) y Help:Template (Español).

Listas con viñetas

Las viñetas no aportan ningún orden aparente de elementos.

Para insertar una viñeta, use un asterisco (*). Multiples asteriscos consecutivos * aumentarán la profundidad de sangrado.

wikitexto visualización
* Primer elemento
* Segundo elemento
** Sublista dentro del segundo elemento
* Tercer elemento
  • Primer elemento
  • Segundo elemento
    • Sublista dentro del segundo elemento
  • Tercer elemento

Listas numeradas

Las listas numeradas introducen una numeración correlativa y de esa manera ordenan los elementos de una lista. En general, deberían utilizarse para un listado aleatorio de elementos, de modo que el orden en el que aparezcan los elementos no sea el principal objetivo.

Para crear listas numeradas, utilice o bien números o bien el símbolo almohadilla (#). Multiples símbolos # consecutivos aumentarán la profundidad del sangrado y el inicio de una nueva numeración.

wikitexto visualización
# Primer elemento
# Segundo elemento
## Sub-item dentro del segundo elemento
# Tercer elemento
  1. Primer elemento
  2. Segundo elemento
    1. Sub-item dentro del segundo elemento
  3. Tercer elemento
# Primer elemento
# Segundo elemento
#* Subnivel dentro del segundo elemento
# Tercer elemento
  1. Primer elemento
  2. Segundo elemento
    • Subnivel dentro del segundo elemento
  3. Tercer elemento

Listas de definiciones

Las listas de definiciones se crean con un punto y coma inicial (;) y dos puntos (:) después del término a definir.

wikitexto visualización
Listas de definiciones:
; Teclado: Dispositivo de entrada con botones o teclas
; Ratón: Dispositivo apuntador de entrada bidimensional
o
; Teclado
: Dispositivo de entrada con botones o teclas
; Ratón
: Dispositivo apuntador de entrada bidimensional

Listas de definiciones:

Teclado
Dispositivo de entrada con botones o teclas
Ratón
Dispositivo apuntador de entrada bidimensional

o

Teclado
Dispositivo de entrada con botones o teclas
Ratón
Dispositivo apuntador de entrada bidimensional
Utilice dos puntos adicionales si la definición tiene múltiples definiciones:
; Término
: Primera definición
: Segunda definición

Utilice dos puntos adicionales si la definición tiene múltiples definiciones:

Término
Primera definición
Segunda definición

Las listas de definiciones no deben ser utilizadas simplemente para dar formato al texto, vea W3's ejemplos.

Texto sangrado

Nota: el sangrado de un texto se debe utilizar, preferentemente, para las páginas de discusión, consulte Wikipedia:Sangría

Para sangrar un texto, coloque dos puntos (:) al principio de la línea. Con cada dos puntos más, se sangrará aún más el texto. Una nueva línea marcará el final del párrafo con sangría.

wikitexto visualización
Este texto no está sangrado en absoluto.
: Este está un poco sangrado.
:: Este lo está un poco más.

Este texto no está sangrado en absoluto.

Este está un poco sangrado.
Este lo está un poco más.

Código

Para agregar código a la wiki, utilice una de las plantillas de formato del código. Como alternativa, para enmarcar una línea de código, simplemente comience cada línea precedida de un espacio en blanco, por ejemplo:

 $ echo Hello World

Consulte Help:Style (Español)#Plantillas de formato del código.

Tablas

Sugerencia: consulte Mediawiki Tables Generator[enlace roto 2021-11-19] para generar tablas automáticamente.

Utilizadas con eficacia las tablas pueden ayudar a organizar y resumir relaciones de datos. Para conocer la sintaxis avanzada del formato de tablas consulte Ayuda:Tablas.

wikitexto representación
{| class="wikitable"
|+ Tabla de datos
! Distro !! Color
|-
| Arch || Azul
|-
| Gentoo || Púrpura
|-
| Ubuntu || Naranja
|}
Tabla de datos
Distro Color
Arch Azul
Gentoo Púrpura
Ubuntu Naranja
{| class="wikitable"
! Sistema de archivos!! Tamaño !! Usado !! Disponible !! %Usado !! Montado en
|-
| rootfs || 922G || 463G || 413G || 53% || /
|-
| /dev || 1.9G || 0 || 1.9G || 0% || /dev
|}
Sistema de archivos Tamaño Usado Disponible %Usado Montado en
rootfs 922G 463G 413G 53% /
/dev 1.9G 0 1.9G 0% /dev

Enlaces

Los enlaces son esenciales para ayudar a los lectores a navegar por el sitio. En general, los editores deben asegurarse de que cada artículo contiene enlaces salientes a otros artículos (evite las páginas sin salida) y haga referencia a enlaces entrantes de otros artículos (la página especial lo que enlaza aquí se puede utilizar para mostrar los enlaces entrantes). Vea también Help:Style/Formatting and punctuation (Español)#Primeras instancias.

Enlaces internos

Se puede hacer extensivamente una referencia cruzada de las páginas wiki usando enlaces internos. Puede agregar vínculos a los títulos existentes, y también a títulos que creemos deberían existir en el futuro.

Para crear un enlace a otra página de la misma wiki, solo hay que poner el título entre dobles corchetes.

Por ejemplo, si se desea hacer un enlace con el artículo pacman (Español), utilice:

[[pacman (Español)]]
Nota: si la página de destino no existe, el resultado será un enlace (de color) rojo, los cuales deben evitarse según Help:Style (Español)#Metáfora del hipertexto.

Si quiere usar otras palabras distintas de las del título del artículo enlazado, puede agregar un texto alternativo después de la barra vertical («|») separadora.

Por ejemplo:

 [[ArchWiki:About (Español)|ArchWiki]] es la fuente principal de documentación de Arch Linux. 

...se vería así:

ArchWiki es la fuente principal de documentación de Arch Linux.
Sugerencia: el símbolo de tubería («|»), también conocido como barra vertical, se puede componer con Shift+\ en el diseño del teclado en inglés y similares —Alt Gr+1 en el teclado español—

Si desea utilizar el plural del título de un artículo (o añadir cualquier otro sufijo) para el enlace, puede agregar las letras adicionales directamente fuera de los corchetes.

Por ejemplo:

makepkg se utiliza en combinación con [[PKGBUILD]]s. 

...se vería así:

makepkg se utiliza en combinación con PKGBUILDs.

Enlaces a las secciones de un documento

Para crear un enlace a una sección de un artículo, basta con añadir el símbolo # seguido de la sección a la que se dirige.

Por ejemplo:

[[Help:Editing (Español)#Enlaces a las secciones de un documento]]

...se vería así:

Help:Editing (Español)#Enlaces a las secciones de un documento
Sugerencia: si enlaza a una sección dentro de la misma página, el nombre de la página se puede omitir (por ejemplo, [[#Enlaces a las secciones de un documento]]).

Truco de la barra vertical

En algunos casos, es posible usar el truco de la barra vertical para guardar la escritura de la etiqueta de los enlaces wiki. Los casos más importantes utilizables en ArchWiki son:

  1. En títulos de artículos, permite ocultar el sufijo del idioma. Por ejemplo, [[Main page (Česky)|]] se convierte en Main page.
  2. En enlaces a diferentes espacios de nombres o wiki, el truco de la tubería oculta el prefijo. Por ejemplo, [[ArchWiki:About|]] se convierte en About y [[Wikipedia:Help:Pipe trick|]] en Help:Pipe trick.

Cuando se guarda la página, el truco de la tubería generará automáticamente la etiqueta del enlace y cambiará el wikitexto en consecuencia.

Enlaces interlingüísticos

Véase Help:i18n (Español)#Enlaces interlingüísticos

Enlaces interwikis

Los llamados enlaces interwiki pueden ser utilizados para conectar fácilmente los artículos con otras Wikis externas, como por ejemplo Wikipedia. La sintaxis para este tipo de enlaces consiste en el nombre de la wiki seguido de dos puntos y el título del artículo con el que se desea establecer el vínculo, insertándolo todo en dobles corchetes.

Si desea acceder al artículo Wikipedia:Arch Linux (Español) se puede utilizar lo siguiente:

[[Wikipedia:Arch Linux (Español)]]

O bien, puede crear el mismo enlace con una etiqueta alternativa (con el uso de la barra vertical separadora —|—), como Artículo de Wikipedia sobre Arch Linux:

[[Wikipedia:Arch Linux|Artículo de Wikipedia sobre Arch Linux]]
Nota: reserve la utilización de enlaces con una etiqueta alternativa para abreviar URLs largas

Consulte: Wikipedia:InterWikimedia links

La lista de todos los enlaces interwiki disponibles en ArchWiki se puede se pueden ver en Special:Interwiki and a través de la API.

Sugerencia: de manera predeterminada, todos los enlaces interwiki a páginas alojadas en Wikipedia se consideran enlaces a páginas en inglés. Si desea crear un enlace a una página en otro idioma, puede agregar un prefijo de idioma al nombre de la página. Por ejemplo, para crear un enlace a una página rusa, añada el prefijo ru al nombre:
[[Wikipedia:ru:Arch Linux]]

cuyo resultado será: Wikipedia:ru:Arch Linux.

Tenga en cuenta que esto depende de la configuración interwiki para la wiki de destino, por lo que no funciona en todas las wiki. Sin embargo, si funciona para Wikipedia.

Enlaces externos

Si desea enlazar a un sitio externo, solo tiene que escribir la URL completa de la página con la que desea establecer el vínculo.

http://www.google.com/

A menudo es más útil hacer que el enlace muestre un nombre distinto al de la dirección URL, lo cual se puede conseguir poniento entre corchetes (no dobles corchetes, solo uno en cada extremo), la URL seguida del título alternativo, separando ambos con un espacio en blanco (no con una barra vertical). De modo que si se quiere que el enlace aparezca como motor de búsqueda de Google, escriba:

[http://www.google.com/ motor de búsqueda de Google]

También es posible generar una etiqueta autonumerada simplemente encerrando la URL entre corchetes individuales. Esto a menudo se prefiere a frases como «véase aquí». Para producir una frase «véase [1]», donde el número variará dependiendo del orden del enlace en la página, simplemente escriba:

véase [https://www.google.com/]
Nota: si el enlace se dirige a páginas de ArchWiki (por ejemplo los enlaces comienzan con https://wiki.archlinux.org/) utilice #Enlaces internos. Utilice un enlace #Enlaces interwikis. si el enlace es a páginas de Wikipedia (por ejemplo https://en.wikipedia.org/).

Redirecciones

Para redirigir automáticamente una página a otra, agregue #REDIRECT e inserte, entre dobles corchetes, el nombre de la página a donde se quiere pasar automáticamente.

Por ejemplo, puede redirigir de «Penguins» a «Penguin»:

#redirect [[Penguin]]

Por lo tanto, cualquiera de las versiones que se escriba en el cuadro de búsqueda automáticamente irá a «Penguin».

Los redireccionamientos también permiten hacer un seguimiento del motivo por el que se crean los enlaces, por ejemplo, agruparlos en páginas WhatLinksHere, y actualizar rápidamente los fragmentos del enlace en caso de que se renombren las secciones. Como una desventaja, los redireccionamientos no muestran el último objetivo de enlace en el navegador.

Antes de crear un redireccionamiento, puede realizar una búsqueda para verificar si existen otras compatibles. Por ejemplo, Xorg.

Véase también Help:Style (Español)#Páginas de redirección y Help:Procedures (Español)#Tratamiento de las páginas de discusión después de redirigir una página a otra.

Nota:

Las variables Wiki, magic words y las plantillas

MediaWiki reconoce ciertas cadenas especiales dentro de un artículo que alteran el comportamiento estándar. Por ejemplo, la adición de la palabra __NOTOC__ en cualquier parte de un artículo evita la generación de una tabla de contenido. Del mismo modo, la palabra __TOC__ puede ser usada para alterar la posición por defecto de la tabla de contenido. Consulte mw:Help:Magic words para más detalles.

Las plantillas (templates) y las variables son fragmentos predefinidos de wikitexto que se pueden insertar en un artículo para ayudar a dar formato al contenido.

Las variables son definidas por el sistema y se pueden utilizar para mostrar información sobre la página actual, la wiki, o una fecha. Por ejemplo, utilice {{SITENAME}} para mostrar el nombre del sitio wiki (que, en este wiki, es: ArchWiki). Para establecer una cabecera de título alternativo para la página actual, existe esta variable wiki: {{DISPLAYTITLE:Título Nuevo}} (Pero está muy restringido: solo se le permite cambiar la primera letra a minúsculas y reemplazar los espacios con guiones bajos: la cadena de título normalizada debe coincidir con el nombre de la página real; de lo contrario, no funcionará; use {{Lowercase title}} para mostrar la primera letra del título en minúsculas).

Las plantillas, por otra parte, son definidas por el usuario. El contenido de cualquier página pueden ser incluido en otra página añadiendo {{Namespace:Nombre de la página}} para un artículo, pero esto rara vez se utilizan con páginas fuera del espacio de nombres de la Plantilla. (Si se omite el espacio de nombres, se asume la Plantilla) Por ejemplo, Template:Note (Español), se puede incluir en un artículo con el wikitexto siguiente:

{{Nota|esto es una nota}}

...se vería así:

Nota: esto es una nota

Consulte Help:Template (Español) para más informacion.