Sintaxis del formato

DokuWiki admite un lenguaje de marcado simple, que intenta hacer los archivos de datos tan legibles como sea posible. Esta página contiene la totalidad de la sintaxis que puede utilizar al editar páginas. Simplemente observe el código de esta página presionando el botón Editar esta página que se encuentra en el extremo superior o inferior de la página. Si desea experimentar, utilice la página de pruebas. También puede acceder fácilmente al marcado simple a través de la barra de herramientas.

Formato básico del texto

DokuWiki admite texto en negrita, italica, subrayado y monoespaciado. Naturalmente, puede combinarlos todos.

DokuWiki admite texto en **negrita**, //itálica//, __subrayado__ y ''monoespaciado''.
Naturalmente, puede **__//''combinarlos''//__** todos.

También puede utilizar subíndice y superíndice.

También puede utilizar <sub>subíndice</sub> y <sup>superíndice</sup>.

También puede marcar algo como tachado.

También puede marcar algo como <del>tachado</del>.

Los párrafos se crean con líneas en blanco. Si desea forzar un salto de línea sin un párrafo, puede utilizar dos barras invertidas seguidas por un espacio o el fin de la línea.

Este es un texto con algunos saltos de líneas
Note que las dos barras invertidas se reconocen sólo al final de la línea
o seguidas por
un espacio, de lo contrario \\esto es lo que ocurre.

Este es un texto con algunos saltos de líneas\\ Note que
las dos barras invertidas se reconocen sólo al final de la línea\\
o seguidas por\\ un espacio, de lo contrario \\esto es lo que ocurre.

Sólo debería forzar saltos de línea si realmente son necesarios.

Enlaces

DokuWiki admite múltiples maneras de crear enlaces.

Externos

Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com - También puede establecer el texto del enlace: Este enlace apunta a google. Las direcciones de correo electrónico como esta: andi@splitbrain.org también se reconocen.

DokuWiki admite múltiples maneras de crear enlaces. Los enlaces externos se reconocen
automáticamente: http://www.google.com o simplemente www.google.com - También puede establecer
el texto del enlace: [[http://www.google.com|Este enlace apunta a google]]. Las direcciones
de correo electrónico como esta: <andi@splitbrain.org> también se reconocen.

Internos

Los enlaces internos se crean con corchetes. Puede o bien dar solo un nombre o utilizar un texto de enlace adicional.

Los enlaces internos se crean con corchetes. Puede o bien dar solo un [[nombre]]
o utilizar un [[nombre|texto de enlace]] adicional.

Los nombres de páginas Wiki se convierten a minúsculas automáticamente, no se permiten caracteres especiales.

Puede utilizar nombres colocando el signo de dos puntos en el nombre de la página.

Puede utilizar [[algunos:nombres]] colocando el signo de dos puntos en el nombre de la página.

Para mas detalles sobre los espacios de nombres, vea namespaces.

Enlazar a una sección específica también es posible. Sólo añada el nombre de la sección detrás de un símbolo de número, como se utiliza en HTML. Esto enlaza a esta sección.

Esto enlaza a [[dokuwiki#internos|esta sección]].

Notas:

  • Los enlaces a páginas existentes se muestran en un estilo diferente a las inexistentes.
  • DokuWiki no utiliza altas y bajas para crear enlaces automáticamente por defecto, aunque este comportamiento puede habilitarse en el archivo de configuración. Pista: Si DokuWiki es un enlace, entonces está habilitado.
  • Cuando el encabezado de una sección cambia, su marcador cambia también. De manera que no dependa demasiado del enlace a secciones.

Interwiki

DokuWiki admite enlaces Interwiki. Estos son enlaces rápidos a otras Wikis. Por ejemplo, este es un enlace a la página de Wikipedia sobre las Wikis: Wiki.

DokuWiki admite enlaces [[doku>Interwiki]]. Estos son enlaces rápidos a otras Wikis. 
Por ejemplo, este es un enlace a la página de Wikipedia sobre las Wikis: [[wp>Wiki]].

Carpetas compartidas

Las carpetas compartidas de Windows como esta también se reconocen. Por favor, note que esto sólo tiene sentido en un grupo de usuarios homogéneo, como una Intranet corporativa.

Las carpetas compartidas por smb como [[\\servidor\compartido|esta]] también se reconocen.

Notas:

  • Por razones de seguridad, la navegación directa a las carpetas compartidas de Windows solo funciona por defecto en Internet Explorer (y sólo en la “zona local”).
  • Para Mozilla y Firefox puede habilitarse a través de varios trucos mencionados en la Base de conocimientos de Mozilla.

Enlaces con imágenes

También puede utilizar una imagen para enlazar otra página interna o externa, combinando la sintaxis de los enlaces e imágenes así:

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

Por favor, tome nota: el formato de la imagen es la única sintaxis de formato que se acepta en los nombres de enlaces.

Se admite la sintaxis completa de imagen y enlace (incluyendo el redimensionado de la imagen, las imágenes internas y externas, URLs y enlaces interwiki).

Notas al pie

Puede agregar notas al pie 1) utilizando paréntesis dobles.

Puede agregar notas al pie ((Esto es una nota al pie)) utilizando paréntesis dobles.

Seccionado

Puede utilizar hasta cinco niveles de encabezado para estructurar su contenido. Si tiene más de tres titulares, automáticamente se genera una tabla de contenidos – esto puede deshabilitarse incluyendo la cadena ~~NOTOC~~ en el documento.

Encabezado de nivel 3

Encabezado de nivel 4

Encabezado de nivel 5
==== Encabezado de nivel 3 ====
=== Encabezado de nivel 4 ===
== Encabezado de nivel 5 ==

Al utilizar cuatro guiones o más, puede hacer una línea horizontal:


Imágenes y otros archivos

Puede incluir imágenes internas y externas con corchetes. Opcionalmente puede especificar su tamaño.

Tamaño real:

Redimensionado al ancho dado:

Redimensionado al ancho y alto dados 2):

Imagen externa escalada:

Tamaño real:                     {{dokuwiki-128.png}}
Redimensionar al ancho dado:     {{dokuwiki-128.png?50}}
Redimensionar:                   {{dokuwiki-128.png?200x50}}
Imagen externa redimensionada:   {{http://de3.php.net/images/php.gif?200x50}}

Al utilizar espacios a la izquierda o la derecha, puede escoger la alineación.

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

Naturalmente, también puede añadir un título (mostrado como una pista por la mayoría de los navegadores).

Este es el título

{{ wiki:dokuwiki-128.png |Este es el título}}

Si especifica un nombre de archivo (externo o interno) que no sea una imagen (gif, jpeg, png), entonces se mostrará como un enlace.

Para enlazar una imagen a otra página vea enlaces con imágenes arriba.

Listas

Dokuwiki admite listas numeradas y viñetas. Para crear un elemento de lista, deje una sangría de dos espacios antes de su texto y utilice * para viñetas o - para listas numeradas.

  • Esto es una lista
  • El segundo elemento
    • Puede tener diferentes niveles
  • Otro elemento
  1. La misma lista, pero numerada
  2. Otro elemento
    1. Sólo use la sangría para niveles más profundos
  3. Eso es todo
  * Esto es una lista
  * El segundo elemento
    * Puede tener diferentes niveles
  * Otro elemento

  - La misma lista, pero numerada
  - Otro elemento
    - Sólo use la sangría para niveles más profundos
  - Eso es todo

También mire la FAQ sobre elementos de listas.

Conversiones de texto

DokuWiki puede convertir ciertos caracteres o cadenas predefinidas en imágenes, otro texto o HTML.

La conversión de texto a imagen se utiliza principalmente para caritas. Y la conversión de texto a HTML se utiliza para sustituciones tipográficas, pero puede configurarse también para utilizar otro HTML.

Conversiones de texto a imagen

DokuWiki convierte los emoticonos más comunes a sus equivalentes gráficos. Esas caritas y otras imágenes pueden configurarse y extenderse. He aquí una vista general de las caritas incluidas en DokuWiki:

  • 8-) 8-)
  • 8-O 8-O
  • :-( :-(
  • :-) :-)
  • =) =)
  • :-/ :-/
  • :-\ :-\
  • :-? :-?
  • :-D :-D
  • :-P :-P
  • :-O :-O
  • :-X :-X
  • :-| :-|
  • ;-) ;-)
  • ^_^ ^_^
  • :?: :?:
  • :!: :!:
  • LOL LOL
  • FIXME FIXME
  • DELETEME DELETEME

Conversiones de texto a HTML

Typografía: dokuwiki puede convertir caracteres de texto simple a sus entidades tipográficamente correctas. He aquí un ejemplo de caracteres reconocidos.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “He thought 'It's a man's world'…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"He thought 'It's a man's world'..."

Lo mismo puede hacerse para producir cualquier clase de HTML, solo necesita añadirse al archivo de patrones.

Hay tres excepciones que no provienen del archivo de patrones: la entidad de multiplicación (640×480), las comillas 'simples' y “dobles”. Pueden apagarse mediante la opción de configuración.

Citas

En ocasiones se desea marcar algún texto para indicar que es una respuesta o comentario. Puede utilizar la siguiente sintaxis:

Creo que deberíamos hacerlo

> No, no debemos

>> Bien, yo digo que deberíamos

> ¿De veras?

>> ¡Sí!

>>> ¡Entonces hagámoslo!

Creo que deberíamos hacerlo

No, no debemos
Bien, yo digo que deberíamos
¿De veras?
¡Sí!
¡Entonces hagámoslo!

Tablas

DokuWiki admite una sintaxis simple para crear tablas.

Cabecera 1 Cabecera 2 Cabecera 3
Fila 1 Col 1 Fila 1 Col 2 Fila 1 Col 3
Fila 2 Col 1 extensión entre columnas (note la barra doble)
Fila 3 Col 1 Fila 3 Col 2 Fila 3 Col 3

Las filas de una tabla deben comenzar con | para las filas normales y ^ para las cabeceras.

^ Cabecera 1      ^ Cabecera 2                  ^ Cabecera 3          ^
| Fila 1 Col 1    | Fila 1 Col 2                | Fila 1 Col 3        |
| Fila 2 Col 1    | extensión entre columnas (note la barra doble)   ||
| Fila 3 Col 1    | Fila 3 Col 2                | Fila 3 Col 3        |

Para conectar celdas horizontalmente, solo haga la próxima celda completamente vacía como se ha mostrado arriba. ¡Asegúrese de tener siempre la misma cantidad de separadores de celdas!

Las cabeceras verticales también son posibles.

Cabecera 1 Cabecera 2
Cabecera 3 Fila 1 Col 2 Fila 1 Col 3
Cabecera 4 no hay extensión entre columnas esta vez
Cabecera 5 Fila 2 Col 2 Fila 2 Col 3

Como puede ver, es el separador anterior a una celda el que decide su formato:

|               ^ Cabecera 1                               ^ Cabecera 2          ^
^ Cabecera 3    | Fila 1 Col 2                             | Fila 1 Col 3        |
^ Cabecera 4    | no hay extensión entre columnas esta vez |                     |
^ Cabecera 5    | Fila 2 Col 2                             | Fila 2 Col 3        |

Puede tener extensión entre filas (celdas conectadas verticalmente) añadiendo ::: en las celdas debajo de aquella a la cual deben conectarse.

Cabecera 1 Cabecera 2 Cabecera 3
Fila 1 Col 1 esta celda se extiende verticalmente Fila 1 Col 3
Fila 2 Col 1 Fila 2 Col 3
Fila 3 Col 1 Fila 2 Col 3

Aparte de la sintaxis de extensión entre filas, esas celdas no deberían contener nada más.

^ Cabecera 1      ^ Cabecera 2                           ^ Cabecera 3          ^
| Fila 1 Col 1    | esta celda se extiende verticalmente | Fila 1 Col 3        |
| Fila 2 Col 1    | :::                                  | Fila 2 Col 3        |
| Fila 3 Col 1    | :::                                  | Fila 2 Col 3        |

También puede alinear el contenido de la tabla. Solo añada al menos dos espacios en los extremos de su texto: dos espacios a la izquierda para alinearlo a la derecha, dos espacios a la derecha para alinearlo a la izquierda, y dos espacios a cada extremo para centrar el texto.

Tabla con alineación
derecha centro izquierda
izquierda derecha centro
xxxxxxxxxxxxxx xxxxxxxxxxxxxx xxxxxxxxxxxxx

Así es como luce en código:

^              Tabla con alineación             ^^^
|         derecha|     centro     |izquierda      |
|izquierda       |         derecha|    centro     |
| xxxxxxxxxxxxxx | xxxxxxxxxxxxxx | xxxxxxxxxxxxx |

Nota: no se admite la alineación vertical.

Sin formato

Si necesita mostrar texto exactamente como se teclea (sin ningún formato), encierre el área o bien con etiquetas <nowiki> o incluso más simple, con signos de porcentaje dobles %%.

Esto es un texto que contiene direcciones como esta: http://www.splitbrain.org y **formateo**, pero nada se hace con ello. Lo mismo sucede con //__este__ texto// con una carita ;-).

<nowiki>
Esto es un texto que contiene direcciones como esta: http://www.splitbrain.org y **formateo**, pero nada se hace con ello.
</nowiki>
Lo mismo sucede con %%//__este__ texto// con una carita ;-)%%.

Bloques de código

Puede incluir bloques de código en sus documentos o bien colocándoles una sangría de dos espacios (como se ha utilizado para los ejemplos previos) o utilizando las etiquetas <code> o <file>.

Esto es un texto con una sagría de dos espacios.
Esto es un código preformateado, se preservan todos los espacios: de        <-esta manera
Esto es prácticamente lo mismo, pero podría utilizarlo para mostrar que ha citado un archivo.

Esos bloques fueron creados con este código:

  Esto es un texto con una sagría de dos espacios.
<code>
Esto es un código preformateado, se preservan todos los espacios: de        <-esta manera
</code>
<file>
Esto es prácticamente lo mismo, pero podría utilizarlo para mostrar que ha citado un aarchivo.
</file>

Resaltado de sintaxis

dokuwiki puede resaltar código fuente, que lo hace más fácil de leer. Se utiliza GeSHi (Generic Syntax Highlighter) – de modo que se admite cualquier lenguaje que admita GeSHi. La sintaxis es similar a los bloques de citas de la sección anterior, pero en esta ocasión, en la etiqueta se inserta el nombre del lenguaje. Ejemplo: <code java> o <file java>.

/**
 * La clase AppHolaMundo implementa una aplicación que
 * simplemente muestra "¡Hola, mundo!" por la salida estándar.
 */
class AppHolaMundo {
    public static void main(String[] args) {
        System.out.println("¡Hola mundo!"); //Muestra la cadena.
    }
}

Actualmente se reconocen las siguientes cadenas de lenguajes: 4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript-french, actionscript, actionscript3, ada, algol68, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, epc, ecmascript, eiffel, email, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, go, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, html5, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic

Bloques de código descargables

Cuando utiliza la sintaxis <code> o <file> como aparece arriba, podría también desear que el código pudiese descargarse. Puede hacerlo especificando un nombre de archivo después del código, así:

<file php miejemplo.php>
<?php echo "¡Hola mundo!"; ?>
</file>
miejemplo.php
<?php echo "¡Hola mundo!"; ?>

Si no desea el resaltado, sino el archivo descargable, especifique un guión (-) como código del lenguage: <code - miarchivo.foo>.

Incrustando HTML y PHP

Puede incrustar código puro HTML o PHP en sus documentos utilizando las etiquetas <html> o <php>. (Utilice etiquetas en mayúsculas si necesita encerrar elementos de nivel de bloque.)

Ejemplo HTML:

<html>
Esto es un <span style="color:red;font-size:150%;">HTML alineado</span>
</html>
<HTML>
<p style="border:2px dashed red;">Y esto es un bloque HTML</p>
</HTML>

Esto es un <span style="color:red;font-size:150%;">HTML alineado</span>

<p style="border:2px dashed red;">Y esto es un bloque HTML</p>

Ejemplo PHP:

<php>
echo 'Un logo generado por PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="¡Logo PHP!" />';
echo '(HTML alineado generado)';
</php>
<PHP>
echo '<table class="inline"><tr><td>Lo mismo, pero dentro de un elemento de nivel de bloque:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="¡Logo PHP!" /></td>';
echo '</tr></table>';
</PHP>

echo 'Un logo generado por PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="¡Logo PHP!" />'; echo '(inline HTML)';

echo '<table class="inline"><tr><td>Lo mismo, pero dentro de un elemento de nivel de bloque:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="¡Logo PHP!" /></td>';
echo '</tr></table>';

Por favor, note: La incrustación HTML y PHP está deshabilitada por defecto en la configuración. De mostrarse, aparece el código en lugar de ejecutarse.

Agregación de fuentes RSS/ATOM

dokuwiki puede integrar datos de fuentes XML externas. Para analizar las fuentes XML, se utiliza SimplePie. Cualquier formato comprendido por SimplePie puede utilizarse en DokuWiki también. Puede influenciar la interpretación usando múltiples parámetros adicionales separados por espacios:

Parámetro Descripción
un número se utilizará como número máximo de elementos a mostrar, 8 por defecto
reverse muestra primero los últimos elementos de la fuente
author muestra los nombre de los autores del elemento
date muestra la fecha del elemento
description muestra la descripción del elemento. Si se deshabilita HTML, todas las etiquetas serán eliminadas
n[dhm] periodo de actualización, donde d = días, h = horas, m = minutos. (Ej. 12h = 12 horas).

Por defecto, el periodo de actualización es de 4 horas. Cualquier valor inferior a 10 minutos se tomará como 10 minutos. dokuwiki generalmente intentará proporcionar una versión precargada de una página, y evidentemente esto no es apropiado cuando la página contiene contenido externo dinámico. El parámetro le dice a dokuwiki que reinterprete la página si ha pasado más de periodo de actualización desde que la página se interpretó por última vez..

Ejemplo:

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

Macros de control

Hay sintaxis que influye en cómo DokuWiki reproduce una página, sin crear ninguna salida en sí.Están disponibles las siguientes macros de control:

Macro Descripción
~~NOTOC~~ Si en la página se encuentra esta macro, no se genera una tabla de contenidos
~~NOCACHE~~ DokuWiki cachea por defecto todo el contenido. A veces esto puede ser indeseable (ej. cuando se utilice la sintaxis <php> de más arriba), añadir esta macro forzará a DokuWiki a generar la página cada vez que se llame.

Complementos de Sintaxis

La sintaxis de DokuWiki puede extenderse con complementos. El uso de los complementos instalados se describe en sus respectivas páginas descriptivas. En esta instalación particular de DokuWiki están disponibles los siguientes complementos de sintaxis:

  • addnewpage 20/12/2006 por iDo
    This add a "new page form" in your page. \ Syntax : {{NEWPAGE[>namespace]}} where [>namespace] is optional.
  • Info Plugin 2013-02-16 por Andreas Gohr
    Displays information about various DokuWiki internals
1) Esto es una nota al pie
2) Cuando la relación de aspecto del ancho y alto dados no coincida con los de la imagen, ésta será recortada a la nueva relación antes de redimensionarse
Conectarse