Table of Contents

Sintaxis de formato

DokuWiki usa una variante sencilla del lenguaje de marcas con el objetivo de facilitar al máximo la lectura de los archivos. Este artículo contiene toda la sintaxis que puedas llegar a necesitar cuando edites páginas. Puedes echarle una ojeada al código fuente de este artículo clicando en el botón Editar en la parte inferior del mismo. Si estás dando tus primeros pasos y deseas probar algo, puedes hacerlo en el playground. El marcado más simple también es accesible mediante toolbar.

Formato básico de texto

DokuWiki permite el uso de negrita, cursiva, subrayado y monoespaciado. Por supuesto, también puedes combinarlos.

DokuWiki permite el uso de **negrita**, //cursiva//, __subrayado__ y ''monoespaciado''. 
Por supuesto, también puedes **__//''combinarlos''//__**. 

Puedes usar subíndice y superíndice.

Puedes usar <sub>subíndice</sub> y <sup>superíndice</sup>. 

Puedes señalar algo como borrado.

Puedes señalar algo como <del>borrado</del>. 

Los párrafos se crean a partir de líneas en blanco. Si deseas forzar una nueva línea sin un párrafo, usa dos barras invertidas seguidas por un espacio en blanco o un carácter 'fin de línea'.

Este es un texto en líneas separadas
Observa cómo
las dos barras invertidas sólo se tienen en cuenta al final de la línea

o seguidas por
un espacio en blanco \\esto es lo que ocurre sin el espacio en blanco.

Este es un texto en líneas separadas\\ Observa cómo 
las dos barras invertidas sólo se tienen en cuenta al final de la línea\\ 
o seguidas por\\ un espacio en blanco \\esto es lo que ocurre sin el espacio en blanco. 

Sólo deberías forzar nuevas líneas si es imprescindible.

Enlaces

Puedes crear enlaces en DokuWiki de diversas maneras.

Externos

Los enlaces externos son detectados automáticamente: http://dead-code.org o simplemente www.dead-code.org. También puedes especificar el nombre del enlace: Este enlace señala a WME. Las direcciones de correo electrónico como ésta: ilove@wme.org también son detectadas.

Puedes crear enlaces en DokuWiki de diversas maneras. Los enlaces externos 
son detectados automáticamente: http://dead-code.org o simplemente 
www.dead-code.org. También puedes especificar el nombre del enlace: 
[[http://dead-code.org|Este enlace señala a WME]]. Las direcciones 
de correo electrónico como ésta: <ilove@wme.org> también son detectadas. 

Internos

Los enlaces internos se crean mediante el uso de corchetes. Puedes usar un nombre de página o añadirle también un Título de texto. Los nombres de página Wiki pasan automáticamente a minúsculas. No se permite el uso de caracteres especiales.

Los enlaces internos se crean mediante el uso de corchetes. Puedes usar un 
[[doku>wiki:nombre de página]] o añadirle también un 
[[doku>wiki:nombre de página|Título de texto]]. Los nombres de página Wiki pasan 
automáticamente a minúsculas. No se permite el uso de caracteres especiales. 

Para crear un espacio de nombres, escribe dos puntos seguidos del nombre de la página.

Para crear un [[wiki:espacio de nombres]], escribe dos puntos seguidos del nombre de la página. 

Para más detalles sobre los espacios de nombres: espacios de nombres.

También es posible crear un enlace a una sección determinada. Simplemente escribe el nombre de la sección precedido del carácter almohadilla, cómo se conoce en HTML. Esto enlaza a esta Sección.

Esto enlaza a [[syntax#internos|esta Sección]] 

Notas:

Interwiki

DokuWiki permite el uso de enlaces Interwiki. Estos son enlaces rápidos a otros Wikis. Por ejemplo, este es un enlace a una página de Wikipedia sobre Wikis: Wiki.

DokuWiki permite el uso de enlaces [[doku>wiki:interwiki|Interwiki]]. 
Estos son enlaces rápidos a otros Wikis. Por ejemplo, este es un enlace 
a una página de Wikipedia sobre Wikis: [[wp>Wiki]]. 

Recursos compartidos de Windows

Los recursos compartidos de Windows como éste también se detectan automáticamente. Observa que estos sólo tienen sentido en el contexto de un grupo de usuarios homogéneo tal como una Intranet corporativa.

Los recursos compartidos de Windows como [[\\server\share|éste]] también se detectan automáticamente. 

Notas:

Enlaces de imagen

También puedes usar una imagen como enlace a otra página interna o externa, combinando la sintaxis para enlaces y imágenes (ver abajo) de la siguiente manera:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]] 

Ten en cuenta: El formato de imágenes es la única sintaxis aceptada en nombres de enlace.

Se permite el uso tanto de la sintaxis de imágenes como la de enlaces (incluyendo la modificación del tamaño de la imagen, imágenes internas y externas y URLs, y enlaces interwiki).

Notas a pie de página

Puedes añadir notas a pie de página 1) mediante el uso de dobles paréntesis.

Puedes añadir notas a pie de página ((Esta es una nota a pie de página)) 
mediante el uso de dobles paréntesis. 

Dividir en secciones

Puedes usar hasta cinco niveles distintos de encabezado para estructurar tu contenido. Si tienes más de tres cabeceras, se generará una tabla de contenidos automáticamente – se puede desactivar esta opción añadiéndole al documento la cadena de carácteres: ~~NOTOC~~

Nivel de cabecera 3

Nivel del cabecera 4

Nivel de cabecera 5
==== Nivel de cabecera 3 ==== 
=== Nivel del cabecera 4 === 
== Nivel de cabecera 5 == 

Al encadenar cuatro guiones o más, crearás una línea horizontal:


De esta manera:

 ---- 

Imágenes y otros archivos

Se pueden incluir imágenes externas o internas mediante el uso de llaves. De forma opcional se puede especificar su tamaño.

Tamaño real:

Modificación de la anchura:

Modificación de la anchura y la altura:

Imagen externa cuyo tamaño ha sido modificado:

Tamaño real:                                    {{wiki:dokuwiki-128.png}} 
Modificación de la anchura:                     {{wiki:dokuwiki-128.png?50}} 
Modificación de la anchura y la altura:         {{wiki:dokuwiki-128.png?200x50}} 
Imagen externa cuyo tamaño ha sido modificado:  {{http://www.dead-code.org/forum/Smileys/default/wave.gif?200x50}} 

Para indicar la alineación, añade espacios en blanco a la izquierda o a la derecha.

{{ wiki:dokuwiki-128.png}} 
{{wiki:dokuwiki-128.png }} 
{{ wiki:dokuwiki-128.png }} 

Por supuesto, también puedes darle un título (que será mostrado como descripción emergente por la mayoría de los navegadores de internet).

Ésta es una descripción emergente

{{ wiki:dokuwiki-128.png |Ésta es una descripción emergente}} 

Si especificas un nombre de archivo (externo o interno) que no sea una imagen (gif, jpeg, png), éste será mostrado como enlace.

Para enlazar una imagen con otra página ver Enlaces de imagen arriba.

Listas

Dokuwiki permite el uso de listas ordenadas y desordenadas. Para crear un artículo de la lista, ponle sangría de dos espacios a tu texto y usa un * para listas desordenadas o un - para las ordenadas.

  1. La misma lista pero ordenada
  2. Otro artículo
    1. Usa sangría para niveles más profundos
  3. Ya está
 
  * Ésta es una lista 
  * El segundo artículo 
    * Puede tener diferentes niveles 
  * Otro artículo 

  - La misma lista pero ordenada 
  - Otro artículo 
    - Usa sangría para niveles más profundos 
  - Ya está 

Smileys

DokuWiki convierte emoticones comunmente usados a sus equivalentes gráficos. Se pueden añadir más smileys al directorio smiley y configurarlos en el archivo conf/smileys.conf. Aquí tienes una lista de los Smileys incluidos en DokuWiki.

Tipografía

DokuWiki puede convertir caracteres de texto simples a su tipografía correcta. Aquí tienes un ejemplo de caracteres reconocidos:

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640x480 © ™ ®
"Pensó 'No debo girarme, ¿y si hubiera detrás un mono de tres cabezas?'…"

 
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 
"Pensó 'No debo girarme, ¿y si hubiera detrás un mono de tres cabezas?'..." 

Ten en cuenta: La conversión automática se puede desactivar en las opciones de configuración.

Citas

A veces, se puede querer indicar que cierto texto es una respuesta o un comentario. Aquí tienes la sintaxis para ello:

Creo que deberíamos hacerlo 
 
> No, no deberíamos 
 
>> Bueno, pues yo digo que sí 
 
> ¿De verdad? 
 
>> ¡Sí! 
 
>>> Vale, ¡hagámoslo pues! 

Creo que deberíamos hacerlo

No, no deberíamos
Bueno, pues yo digo que sí
¿De verdad?
¡Sí!
Vale, ¡hagámoslo pues!

Tablas

DokuWiki usa una sintaxis simple para crear tablas.

Encabezado 1 Encabezado 2 Encabezado
Fila 1 Col 1 Fila 1 Col 2 Fila 1 Col 3
Fila 2 Col 1 una combinación(mira la barra doble)
Fila 3 Col 1 Fila 2 Col 2 Fila 2 Col 3

Las filas tienen que empezar y terminar con un | para las filas normales o con un ^ para los encabezados.

^ Encabezado 1   ^ Encabezado 2    ^ Encabezado         ^ 
| Fila 1 Col 1   | Fila 1 Col 2    | Fila 1 Col 3       | 
| Fila 2 Col 1   | una combinación(mira la barra doble)|| 
| Fila 3 Col 1   | Fila 2 Col 2    | Fila 2 Col 3       | 

Para conectar celdas horizontalmente, vacía la siguiente celda como se muestra arriba. ¡Asegúrate de tener siempre el mismo número de separadores de celda!

Los encabezados verticales también son posibles.

Encabezado 1 Encabezado 2
Encabezado 3 Fila 1 Col 2 Fila 1 Col 3
Encabezado 4 Sin combinación ahora
Encabezado 5 Fila 2 Columna 2 Fila 2 Columna 3

Como puedes ver, el separador antes de la celda es el que determina el formato:

|              ^ Encabezado 1         ^ Encabezado 2       ^ 
^ Encabezado 3 | Fila 1 Col 2         | Fila 1 Col 3       | 
^ Encabezado 4 | Sin combinación ahora|                    | 
^ Encabezado 5 | Fila 2 Columna 2     | Fila 2 Columna 3   | 

Ten en cuenta: La combinación de celdas vertical no es posible.

También puedes alinear los contenidos de la tabla. Basta con añadir al menos dos espacios en blanco en el lado opuesto de tu texto: Añade dos espacios a la izquierda para alinear a la derecha, dos espacios a la derecha para alinear a la izquierda y dos espacios en cada extremo para obtener texto centrado.

Tabla con alineamiento
derecha centro izquierda
izquierda derecha centro
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Así es como aparece en el código fuente:

^           Tabla con alineamiento         ^^^ 
|       derecha|    centro    |izquierda     | 
|izquierda     |       derecha|    centro    | 
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | 

Bloques no analizados

Puedes incluir en tus documentos bloques sin analizar de varias maneras:

Este texto no analizado se dispuso mediante el uso de dos espacios. 
 
Este texto lleva etiquetas code. Los espacios se preservan: como         <-este 
 
Este texto lleva etiquetas file. Se usan para mostrar un archivo.   

Para que el analizador ignore por completo una zona (es decir, no le aplique ningún formato), encierra el área entre etiquetas nowiki o, incluso más simple, con signos de porcentaje dobles %%.

Este texto contiene direcciones como ésta: http://dead-code.org/ y **formatos**, pero no se analizan.

Échale un vistazo al código fuente de esta página para ver cómo usar estos bloques.

Resaltado de sintaxis

DokuWiki puede resaltar el código fuente, que lo hace más sencillo de leer. Usa GeSHi Generic Syntax Highlighter – por lo que cualquier lenguaje aceptado por GeSHi se resalta. La sintaxis es muy parecida a la del bloque de código de la sección anterior, pero en este contexto el nombre del lenguaje utilizado se inserta dentro de la etiqueta. Por ejemplo <code java>.

/**  
 * The HelloWorldApp class implements an application that 
 * simply displays "Hello World!" to the standard output. 
 */ 
class HelloWorldApp { 
    public static void main(String[] args) { 
        System.out.println("hola mundo"); //Display the string. 
    } 
}

Ésta es la lista de los lenguajes reconocidos actualmente actionscript-french, actionscript, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, bnf, caddcl, cadlisp, cfdg, cfm, c_mac, c, cpp, cpp-qt, csharp, css, delphi, diff, div, dos, d, eiffel, fortran, freebasic, gml, groovy, html, idl, ini, inno, io, java5, java, javascript, latex, lisp, lua, matlab, mirc, mpasm, mysql, nsis, objc, ocaml-brief, ocaml, oobas, oracle8, pascal, perl, php-brief, php, plsql, python, qbasic, rails, reg, robots, ruby, sas, scheme, sdlbasic, smalltalk, smarty, sql, tcl, text, thinbasic, tsql, vbnet, vb, vhdl, visualfoxpro, winbatch, xml, xpp, z80

Para resaltar código del lenguaje WME usa:

<code script>Escribe aquí tus líneas de código WME</code>

Agregar fuentes RSS/ATOM

DokuWiki puede ofrecer información de fuentes XML externas. Para procesar dichas fuentes, se usa SimplePie. Todos los formatos aceptados por SimplePie, también pueden usarse en DocuWiki. Estos parámetros (separados por espacios) te permitirán configurar la entrega de la información:

Parámetro Descripción
cualquier número número de artículos a mostrar como máximo; por omisión, 8
reverse mostrar los últimos artículos al principio
author mostrar los nombres de los autores de los artículos
date mostrar las fechas de los artículos
description mostrar las descripciones de los artículos. Si el HTML está deshabilitado, toda etiqueta se rasurará
n[dhm] periodo de actualización, donde d=días, h=horas, m=minutos. (ej. 12h = 12 horas).

El periodo de actualización por omisión es de 4 horas. Cualquier valor menor a 10 minutos será tratado como 10 minutos. DokuWiki generalmente tratará de entregar una versión en caché de la página; obviamente esto no es apropiado cuando la página incluye contenido dinámico externo. El parámetro le dice a DokuWiki que regenere la página si hace más de periodo de actualización desde que la página se generó por última vez.

Por ejemplo:

{{rss>http://slashdot.org/index.rss 5 author date 1h }} 

Incrustar HTML y PHP

Puedes incrustar código HTML o PHP puro en tus documentos usando las etiquetas html o php de este modo:

 
<html> 
Esto es <font color="red" size="+1">HTML</font> 
</html> 
 
Esto es <font color="red" size="+1">HTML</font> 
 
<php> 
echo 'Un logo generado por PHP:'; 
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; 
</php> 
 
echo 'Un logo generado por PHP:'; 
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; 

Ten en cuenta: La inclusión de HTML y PHP se encuentra deshabilitada por defecto en la configuración. Si se encuentra deshabilitado, el código se muestra en lugar de ejecutarse.

Plugins de Sintaxis

La sintaxis de DokuWiki puede extenderse con Plugins. La descripción del uso de los plugins instalados se halla en sus respectivas páginas. Estos son los plugins de sintaxis disponibles en esta instalación de DokuWiki:


1) Esta es una nota a pie de página