ES:Sintaxis wiki

From OpenStreetMap Wiki
Jump to navigation Jump to search

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
  • Puedes introducir el texto tal cual. Esto dará como resultado un texto continuo que se ajustará según sea necesario.
  • Una nueva línea en el código wiki no separa el texto en párrafos.
  • Para separar el texto en párrafos es necesario incluir una línea vacía entre cada parte.

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
lo introduces y se ajusta
incluso con una
nueva línea incrustada.

Formato del texto
  • Al incluir el texto entre dos apóstrofos ('), se mostrará este texto en cursiva.
  • Al incluir el texto entre tres apóstrofos ('), se mostrará este texto en negrita.
  • Al incluir el texto entre cinco apóstrofos ('), se mostrará este texto en negrita cursiva.
  • El uso de un apóstrofo (') muestra solo este apóstrofo.

Ejemplo:

Resalta 'tu' texto en cursiva, negrita o negrita cursiva

Código wiki:

Resalta 'tu' texto en ''cursiva'', '''negrita''' o '''''negrita cursiva'''''

Formato especial
  • Para evitar que el texto se ajuste, usa un espacio duro   como en N.º 1 de aciertos.
  • Una pareja de '<nowiki>' y '</nowiki>' desactiva la sintaxis wiki en el texto adjunto.
  • Introduce tu texto entre '<!-- ', ' -->' y el texto introducido no se mostrará en la página wiki (un comentario).

Ejemplo:

N.º 1 de aciertos


Use as needed.

Código wiki:

'''N.º 1 de aciertos'''

Usa <!--comentarios--> donde sea necesario.

El primer o los primeros caracteres de una línea determinan de qué tipo de texto se trata.
  • Una línea con un espacio ( ) como primer carácter es una línea sin formato, que no se ajustará.
    Esto es práctico para una lista de elementos cortos y útil cuando se muestra una sección de código fuente.
  • Un asterisco (*), un signo de número (#), un punto y coma (;) o dos puntos (:) como primer carácter indican un elemento de lista.
    El uso de más de uno de estos caracteres permite anidar listas.
  • Una línea que comienza con '{|' o '|-' o '|+' o '|' o '!' o '|}' pertenece a una tabla.
  • Un trazo de «=» al principio y al final de una línea indica una cabecera de sección.
  • Una línea en la que el primer carácter es una letra o un dígito es un texto por defecto y se ajustará según sea necesario.
  • Una línea que empiece con uno o dos corchetes ([), un enlace, o que empiece con dos llaves ({{), una plantilla, se trata como texto por defecto, que se ajustará según sea necesario. Los enlaces y las plantillas están incrustados en el texto y no tienen ningún significado especial si empiezan una línea.
  • Una línea que comience con caracteres no mencionados hasta ahora será tratada probablemente como texto por defecto.

Ejemplo:

Espacio como primer carácter 
  1. Elemento numerado
  • Elemento de lista
    • Lista anidada
Sangría
Término de definición
Texto de definición


ES:Página principal

clave=valor


@ Arroba
§ párrafo

Código wiki:


   Espacio como primer carácter

# Elemento numerado
* Elemento de lista
** Lista anidada
 : Sangría

 ; Término de definición
 : Texto de definición

[[ES:Página principal]]
{{tag|clave|valor|par}}


@ Arroba
§ párrafo

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 2

Encabezado 3

Encabezado 4

Código wiki:

=== Encabezado 2 ===
...
==== Encabezado 3 ====
...
===== Encabezado 4 =====

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:

  • Una lista con
    1. dos niveles
    2. y números
  • primer nivel de nuevo

Código wiki:

* Una lista con
*# dos niveles
*# y números
* primer nivel de nuevo

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:

Término de definición
texto de definición
segundo párrafo

 

Sin término de definición
solo con sangría
dos niveles

Código wiki:

 ; Término de definición
 : texto de definición
 : segundo párrafo


 : Sin término de definición
 :: solo con sangría
 :: dos niveles

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:

  • El elemento de la lista se cerrará

en una nueva línea

Código wiki:

* El elemento de la lista se cerrará
en una nueva línea

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:

Wiki Help
Ayuda del wiki (español)
Ayuda del wiki (alemán)

Código wiki:

[[Wiki Help]]
[[ES:Wiki Help | Ayuda del wiki (español)]]
[[DE:Wiki Help | Ayuda del wiki (alemán)]]

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:

wikipedia:Main Page
wikipedia:es:Wikipedia:Portada

Código wiki:

[[wikipedia:Main Page]]
[[wikipedia:es:Wikipedia:Portada]]

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]

Sitio de ayuda de OSM

Sitio web de OSM


Código wiki:

https://help.openstreetmap.org
Un enlace corto
[https://help.openstreetmap.org]
[https://help.openstreetmap.org Sitio de ayuda de OSM]
[//www.openstreetmap.org Sitio web de OSM]

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:

  • Una línea con los dos primeros caracteres '{|' que indican el principio de una tabla.
  • Una línea opcional con los dos primeros caracteres '|+' para el título de la tabla.
  • Una o más filas de la tabla, cada una de las líneas con los dos primeros caracteres '|-' y normalmente sin ningún otro contenido
  • Después de cada fila de la tabla hay una o más líneas con celdas de la tabla y su texto o contenido. Una celda de la tabla tiene como primer carácter un símbolo de barra vertical (|) y el segundo carácter no es ni más (+) ni menos (-), ya que estos dos están reservados para el título y la fila de la tabla respectivamente.
  • Una línea con los dos primeros caracteres '|}' que indica el final de una tabla.

Es una buena práctica y aumenta la legibilidad usar un espacio como segundo o tercer carácter, evitando así cualquier ambigüedad.

Ejemplo:

Título de la tabla
Esta es una
tabla 2 x 2

Código wiki:

{| align="center"
|+ Título de la tabla
|- align="center"
| Esta
| es una
|- align="center"
| tabla
| 2 x 2
|}


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:

Esta es una tabla
dentro
de otra tabla

Código wiki:

{| border="1"
|- align="center"
| Esta es una tabla
{| align="center"
|- align="center"
| dentro
|} de otra tabla
|}

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.
De todos modos, un principiante debería saber para qué se usan estas extrañas llaves dobles.

Ejemplo:

Plantilla de icono para:

nodo nodos
vía vías
vía cerrada vías cerradas
área áreas
relación relaciones


La plantilla de etiqueta está en

clave=valor

muy usada en el wiki


Crear enlaces para
.Keep Right
(Centro de Colonia)


Código wiki:

Plantilla de icono para:
  {{Icon|node}} nodos
  {{Icon|way}} vías
  {{Icon|closedway}} ...
  {{Icon|area}} áreas
  {{Icon|relation}} ...


La plantilla de etiqueta está en
  {{Tag |clave|valor}}
muy usada en el wiki


Crear enlaces para
{{Keepright | lat=50.94 |
long=6.95 | zoom=16 }}
(Centro de Colonia)

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).