ES:Sintaxis wiki
Editar una página wiki es, en la mayoría de los casos, sencillo: basta con introducir el texto. Sin embargo, hay que tener en cuenta algunas convenciones y saber cómo formatear el texto. En este artículo se explican los fundamentos de estas convenciones y algunos de los formatos más utilizados (marcado wiki).
- Importante
- Usa el botón «Mostrar previsualización» para ver el aspecto de tu texto y el formato.
- Usa este botón tantas veces como sea necesario antes de «Guardar cambios» en la página.
- Haz pequeñas ediciones, unas pocas líneas o párrafos, una lista, una tabla o una nueva sección a la vez.
- En caso de que algo salga mal y guardes los cambios, puedes revertir esos cambios en el historial de versiones de la página. Úsalo raramente pero siempre que sea necesario.
- Puedes usar el taller del wiki de OSM para experimentar con el marcado con el que aún no estés familiarizado.
Recursos más completos
- Para un breve resumen de la sintaxis de edición más frecuente del wiki (marcado wiki), véase Ayuda:Cómo se edita una página en Wikipedia.
- En los ejemplos de texto wiki de meta.wikimedia.org se puede encontrar otra visión general de la sintaxis wiki más utilizada (marcado wiki)
- Para obtener una lista más completa del marcado wiki, consulta Ayuda:Wikitexto (en) en Wikipedia
- Para una lista completa de los temas de ayuda del wiki, incluyendo ediciones del wiki, consulta Ayuda:Contenidos en MediaWiki y sus páginas de referencia.
Convenciones de edición
Texto continuo
|
Ejemplo: El texto se muestra a medida que lo introduces y se ajusta incluso con una nueva línea incrustada. |
Código wiki:
El texto se muestra a medida que |
Formato del texto
|
Ejemplo: Resalta 'tu' texto en cursiva, negrita o negrita cursiva |
Código wiki: Resalta 'tu' texto en ''cursiva'', '''negrita''' o '''''negrita cursiva''''' |
Formato especial
|
Ejemplo: N.º 1 de aciertos
|
Código wiki:
'''N.º 1 de aciertos''' |
El primer o los primeros caracteres de una línea determinan de qué tipo de texto se trata.
|
Ejemplo: Espacio como primer carácter
|
Código wiki:
|
Encabezamientos
| Una sección comienza con un encabezado consistente en una línea que empieza y termina con dos o más signos iguales (=) consecutivos. El número de signos iguales indica el nivel de anidamiento de las secciones.
Cuando se usan varias secciones se crea un índice o tabla de contenidos justo antes del primer encabezado. Este artículo, como ejemplo, tiene más de cinco secciones y, en consecuencia, un índice. Si deseas que el índice aparezca en un lugar diferente, puedes usar __TOC__ para definir el lugar donde se mostrará la tabla de contenidos. Puedes usar __NOTOC__ en cualquier parte del documento si quieres que el índice no se muestre en absoluto. |
Ejemplo: Encabezado 2Encabezado 3Encabezado 4 |
Código wiki:
=== Encabezado 2 === |
Listas
| Crear una lista es muy sencillo, simplemente escribe un asterisco (*) como primer carácter en una o más líneas consecutivas. Estas se mostrarán como una lista de viñetas.
Si usas el numeral o la almohadilla (#) en lugar del asterisco (*), crearás una lista ordenada, es decir, numerada. Esta se mostrará como una lista con números en lugar de viñetas. Puedes crear listas anidadas aumentando el número de asteriscos o almohadillas. Las listas anidadas se muestran como listas con diferentes niveles de sangría. Al anidar listas, puedes mezclar listas con viñetas y listas numeradas en cada nivel. |
Ejemplo:
|
Código wiki:
* Una lista con |
| Puedes crear una lista de definición usando un signo de punto y coma (;) como primer carácter de la línea, escribiendo tu término de definición, escribiendo dos puntos (:) y finalmente tu texto de definición. Esto se mostrará como dos líneas, primero el término de definición en negrita, segundo el texto de definición con sangría.
Puedes separar el término de definición y el texto de definición en dos líneas para una mejor legibilidad en el código wiki. Si quieres hacerlo, usa dos puntos (:) como primer carácter de la segunda línea con el texto de definición. Aunque no está previsto, puedes usar dos puntos (:) solos sin una línea para un término de definición, que se mostrará como una sangría. Usando varias líneas con dos puntos como primer carácter, se puede crear una lista sin ninguna marca. Esto se permite para soportar múltiples párrafos para un texto de definición. Al igual que con otros tipos de listas, puedes usar varios signos de dos puntos para aumentar el nivel de sangría. |
Ejemplos:
|
Código wiki:
; Término de definición |
| Nota: Cada línea marcada con uno de los caracteres anteriores (*, #, ; o :) como primer carácter es un elemento de la lista. Una nueva línea en el código wiki concluirá un elemento de la lista. Si necesitas que se muestre una nueva línea dentro de un elemento de la lista, puedes usar <br /> en el código wiki de la misma línea que constituye el elemento de la lista. |
Ejemplo:
en una nueva línea |
Código wiki:
* El elemento de la lista se cerrará |
Enlaces
| Los enlaces dentro del mismo wiki son muy sencillos. Basta con rodear el nombre del artículo con corchetes dobles [[enlace-wiki]]. Puedes añadir un texto diferente para el enlace añadiendo una barra vertical (|) y el texto que debe aparecer como texto del enlace: [[enlace-wiki | texto-del-enlace]]. Si deseas enlazar a una versión en un idioma particular de un artículo wiki, añade al nombre del artículo el código de dos letras del idioma seguido de dos puntos (:). El resultado es un enlace como [[ES:enlace-wiki]] para una versión en español de un artículo wiki. |
Ejemplo: |
Código wiki:
[[Wiki Help]] |
| Si quieres enlazar a un artículo en Wikipedia, introduce el nombre del artículo con el prefijo «wikipedia:». Esto dará como resultado un enlace [[wikipedia:nombre-del-artículo]]. El enlace dirige de forma predeterminada a la Wikipedia en inglés. Si necesitas enlazar a la Wikipedia en otro idioma, introduce el prefijo junto con el código del idioma inmediatamente después de «wikipedia:» seguido de dos puntos (:) antes del nombre del artículo. Un enlace a la Wikipedia en español sería [[wikipedia:es:nombre-del-artículo]. |
Ejemplo: |
Código wiki:
[[wikipedia:Main Page]] |
| Los enlaces externos también son bastante fáciles. Simplemente introduce una URL tal como ''https://help.openstreetmap.org'' y se mostrará como un enlace con la URL como texto del enlace. Si quieres un enlace muy corto, rodea la URL con corchetes simples [enlace-externo] que se mostrará como un enlace numerado tal como [7]. Esto es realmente corto, pero en la mayoría de los casos no es muy significativo. Es mejor práctica dar una pista de a qué apunta ese enlace. Para ello, rodea la URL, un espacio en blanco (« ») y el texto del enlace con corchetes simples [enlace-externo texto-del-enlace] que se mostrará como el texto del enlace.
Por favor, ten en cuenta que (a diferencia de los enlaces wiki) el carácter de espacio en blanco (« ») separa el enlace del texto del enlace. Todos los enlaces externos están caracterizados con un símbolo que se genera a través de la hoja de estilos utilizada. Si la página web de destino es accesible a través de HTTP y HTTPS (seguro), puedes omitir el protocolo y el signo de dos puntos en el enlace (solo si se usa la sintaxis de enlace explícito con «[]»). En la página wiki resultante, el enlace heredará el protocolo de la página wiki actual. Esto se denomina enlace dependiente del protocolo (en) y ayuda a los lectores a mantener su protocolo preferido durante la navegación. |
Ejemplo: https://help.openstreetmap.org Un enlace corto [1]
|
Código wiki:
https://help.openstreetmap.org |
Tablas
| Una tabla es una cuadrícula bidimensional formada por filas y columnas que permite ordenar la información según dos criterios, uno en las filas y otro en las columnas.
Una tabla básica está compuesta por las siguientes partes:
Es una buena práctica y aumenta la legibilidad usar un espacio como segundo o tercer carácter, evitando así cualquier ambigüedad. |
Ejemplo:
|
Código wiki:
{| align="center"
| ||||
| Las tablas tienen una importante diferencia con las listas. Las listas están restringidas a una línea en el código wiki. Las celdas de las tablas pueden tener casi todo lo que se puede expresar con el marcado wiki. Esto incluye párrafos, listas, imágenes u otros medios, e incluso es posible incluir tablas en una celda de tabla, aunque no se recomienda.
Hay muchas cosas complicadas que se pueden hacer con las tablas. Si quieres más información, consulta la ayuda de Wikipedia sobre tablas. |
Ejemplo:
|
Código wiki:
{| border="1" |
Plantillas
| Las plantillas son macros textuales. Son artículos en un espacio de nombres especial (Template:). Se usan para tener un texto o una estructura de texto idénticos dentro de varios artículos. Las plantillas se expanden y se incluyen sobre la marcha al abrir un artículo. Se invocan rodeando el nombre de la plantilla con llaves dobles {{nombre-de-plantilla}}.
Las plantillas pueden tener parámetros. Los parámetros se separan por símbolos de barras verticales {{nombre-de-plantilla | parámetro}}. Los parámetros pueden ser posicionales como en {{nombre-de-plantilla | parámetro-1 | | parámetro-3 }}, cuando necesitas un parámetro vacío si quieres omitir un parámetro posicional. Los parámetros pueden tener nombre, en cuyo caso se denotan los parámetros con nombre como pares clave-valor {{nombre-de-plantilla | parámetro-X = valor-X | parámetro-F = valor-F}}. Puedes usar espacios para facilitar la lectura si lo deseas. Los parámetros pueden tener un valor predeterminado definido dentro de la plantilla. Este valor se usa si no se especifica un valor para un parámetro. El uso de las plantillas es muy variado. Las plantillas pueden ser una simple inclusión de texto que permite repetir un texto y formato idénticos en varias páginas. Las plantillas pueden crear fichas y similares con parámetros y formatos sofisticados. Puedes dirigirte a la lista de plantillas más enlazadas en el wiki de OSM para averiguar que plantillas son las más ampliamente utilizadas. Las plantillas usadas dentro de tu edición aparecen en la parte inferior de la página de edición. Puedes usar los enlaces para ver de qué tratan. Advertencia: La creación de nuevas plantillas o la modificación de plantillas existentes no es para principiantes. |
Ejemplo: Plantilla de icono para:
muy usada en el wiki
|
Código wiki:
Plantilla de icono para: |
Véase también
- Para obtener información general sobre el uso de este wiki, consulta la página de OSM en ayuda del wiki (no hay ayuda especial sobre edición/marcado).
- Para una visión general sobre el uso del editor wiki, consulta la página de ayuda de Wikipedia (no hay ayuda especial sobre marcado).
Traducción revisada por colaboradores del Wikiproyecto Traducción en español. Revisión: 2021-10-04.