Help:Editing (Español)
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 mw:Help:Contents/es 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. Véase ArchWiki:Contributing (Español), Ayuda:Estilo y Ayuda:Lectura 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 Ayuda:Trucos.
Crear una cuenta
Debe crear una cuenta de ArchWiki 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, utilice (los binarios precompilados están disponibles) o simplemente use una imagen de contenedor utilizando herramientas como Docker.
Una vez que tenga una cuenta, inicie sesión desde Special:UserLogin.
Edición
Para comenzar a editar una página, haga clic en la pestaña editar en la parte superior de la página. Alternativamente, los usuarios pueden editar una sección específica de un artículo haciendo clic en el enlace editar a la derecha del encabezado de la sección. Se mostrará la página Edición, que consta de los siguientes elementos:
- Barra de herramientas de edición (opcional)
- Caja de edición
- Caja de resumen de edición
- Enlaces o , Show preview, Show changes, y
La caja de 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:
- Modifique la wikitexto conforme lo que considere necesario (vea #Formato para más detalles).
- Explique el motivo de la edición en la caja Resumen (por ejemplo, "corregir ortografía" o "información adicional sobre xyz" (consulte Help:Edit summary para más detalles).
- Utilice el botón Show preview para facilitar la corrección de pruebas y verificar el formato antes de guardar.
- Señale la edición como menor, marcando la casilla si considera que la edición es superficial o indiscutible.
- Guarde los cambios haciendo clic en . Si no queda satisfecho, haga clic en , en su lugar (o repita el proceso hasta que esté satisfecho).
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:
- Haga clic en la pestaña en la parte superior de la página para modificar (al lado de la pestaña ). Se listará un historial de revisiones en la pantalla.
- Haga clic en el enlace 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.
- Escriba la razón por la que está deshaciendo esta edición en la caja de resumen de edición.
- Si está conforme, haga clic en el botón 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:
- Haga clic en la pestaña situada en la parte superior de la página que va a modificar (al lado derecho de la pestaña ). Se mostrará una lista de revisiones en pantalla.
- 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á.
- Haga clic en la pestaña en la parte superior de la página. Se muestra una advertencia:
- 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 la caja de resumen de edición.
- Si está satisfecho, basta con hacer clic en para restablecer esta versión.
- 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.
- Considere la posibilidad de utilizar un resumen de edición especialmente detallado y verboso al realizar una operación de deshacer para evitar debates prolongados.
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, siempre que una categoría no sea ya la principal de la otra (véase Help:Style (Español)#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 "Mi nueva página" a "Alguna categoría"), del modo siguiente:
- Crearemos una página escribiendo en la barra de navegación del navegador: , donde "Mi nueva página" 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).
- Añada
[[Category:alguna categoría]]a la parte superior de la página.
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).
En algunos casos, puede tener sentido crear una subpágina, es decir, una página secundaria de otra página: los títulos de las subpáginas están separados del título de la superpágina con símbolos "/" (barra oblicua). Esto suele ser útil para preparar borradores en la propia página de usuario, por ejemplo .
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 ======
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 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 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 |
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 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 |
|---|---|
|
| |
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 |
|---|---|
|
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 |
|---|---|
|
| |
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 . 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 . 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 |
|
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 |
|
# Primer elemento # Segundo elemento #* Subnivel dentro del segundo elemento # 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:
o
|
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:
|
Las listas de definiciones no deben ser utilizadas simplemente para dar formato al texto, vea W3's ejemplos.
Texto sangrado
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.
|
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
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
|}
|
| ||||||||||||||||||
| |||||||||||||||||||
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)]]
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.
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 (Español)|PKGBUILD]].
...se vería así:
- makepkg se utiliza en combinación con PKGBUILD.
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í:
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:
- En títulos de artículos, permite ocultar el sufijo del idioma. Por ejemplo, se convierte en Main page.
- En enlaces a diferentes espacios de nombres o wiki, el truco de la tubería oculta el prefijo. Por ejemplo, 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
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]]
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.
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://archlinux.org/
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 Arch Linux, escriba:
[http://archlinux.org/ Arch Linux]
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 ", donde el número variará dependiendo del orden del enlace en la página, simplemente escriba:
véase [https://archlinux.org/]
Redirecciones
Para redirigir automáticamente una página a otra, agregue 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.
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 en cualquier parte de un artículo evita la generación de una tabla de contenido. Del mismo modo, la palabra 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 para mostrar el nombre del sitio wiki (que, en este wiki, es: ). 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 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 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:
...se vería así:
Consulte Help:Template (Español) para más información y una lista de plantillas disponibles como Template:Tip (Español) o Template:Warning (Español).