Inhaltsverzeichnis

Sintaxis de formato

DokuWiki admite un lenguaje de marcado sencillo, cuyo objetivo es que los archivos de datos sean lo más legibles posible. Esta página contiene toda la sintaxis que puedes utilizar al editar las páginas. Solo tienes que echar un vistazo al código fuente de esta página pulsando «Editar esta página». Si quieres probar algo, utiliza la página de pruebas. También puedes acceder fácilmente al marcado más sencillo a través de los botones rápidos.

Formato básico de texto

DokuWiki admite negrita, cursiva, subrayado y monospaciados . Por supuesto, puedes combinar todos ellos. 

DokuWiki admite **negrita**, //cursiva//, __subrayado__ y ''de espaciado fijo'' .
Por supuesto, puedes **__//''combinar''//__** todos ellos.

Ten en cuenta que los marcadores de formato deben rodear directamente el texto, por lo que ** negrita ** con espacios dentro de los marcadores no se aplicará el formato.

Puedes utilizar subíndice y superíndice. 

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

Puedes marcar algo como eliminado también. 

También puedes marcar algo como <del>eliminado</del> también.

Los párrafos se crean a partir de líneas en blanco. Si quieres forzar un salto de línea sin crear un párrafo, puedes utilizar dos barras invertidas seguidas de un espacio en blanco o del final de la línea.

Este es un texto con algunos saltos de línea
Ten en cuenta que las dos barras invertidas solo se reconocen al final de una línea
o cuando van seguidas de
un espacio en blanco \\sin ellas, esto es lo que ocurre. 

Este es un texto con algunos saltos de línea\\ Ten en cuenta que las
dos barras invertidas solo se reconocen al final de una línea\\
o cuando van seguidas de\\ un espacio en blanco \\esto ocurre sin ellas.

Solo debes utilizar saltos de línea forzados si es realmente necesario.

Enlaces

DokuWiki admite varias formas de crear enlaces.

Externos

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

DokuWiki admite varias formas de crear enlaces. Los enlaces externos se reconocen
automáticamente: http://www.google.com o simplemente www.google.com. También puedes establecer
el texto del enlace: [[http://www.google.com|This El enlace apunta a google]]. Las
direcciones de correo electrónico como esta: <[email protected]> también se reconocen.

Enlaces internos

Los enlaces internos se crean utilizando corchetes. Puedes indicar simplemente un pagename o utilizar un texto de enlace. 

Los enlaces internos se crean utilizando corchetes. Puedes indicar simplemente
una [[de:wiki:pagename]] o utilizar un [[de:wiki:pagename|texto de enlace adicional]].

Los nombres de las páginas de la wiki se convierten automáticamente a minúsculas; no se permiten caracteres especiales.

Puedes utilizar namespaces incluyendo dos puntos en el nombre de la página. 

Puedes utilizar [[some:namespaces]] utilizando dos puntos en el nombre de la página.

Para obtener más información sobre los espacios de nombres, consulta namespaces .

También es posible enlazar a una sección específica. Solo tienes que añadir el nombre de la sección tras el símbolo de almohadilla, tal y como se hace en HTML. Esto enlaza a esta sección. 

Esto enlaza a [[de:wiki:syntax#internal|esta sección]].

Notas:

Interwiki

DokuWiki admite enlaces Interwiki . Se trata de enlaces rápidos a otras wikis. Por ejemplo, este es un enlace a la página de Wikipedia sobre wikis: Wiki . 

DokuWiki admite enlaces [[doku>Interwiki]] . Se trata de enlaces rápidos a otros wikis.
Por ejemplo, este es un enlace a la página de Wikipedia sobre wikis: [[wp>Wiki]] .

Recursos compartidos de Windows

También se reconocen los recursos compartidos de Windows como esta también se reconocen. Ten en cuenta que solo tienen sentido en un grupo de usuarios homogéneo, como una empresa Intranet . 

Los recursos compartidos de Windows como [[\\server\share|esta]] también se reconocen.

Notas:

Enlaces de imagen

También puedes utilizar una imagen para enlazar a otra página interna o externa combinando la sintaxis de los enlaces y imágenes (véase más abajo) de la siguiente manera: 

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

Nota: El formato de imagen es la única sintaxis de formato aceptada en los nombres de los enlaces.

Toda la images_and_other_files de imagen y links de enlace (incluido el redimensionamiento de imágenes, imágenes internas y externas, URL y enlaces interwiki).

Notas al pie

Puedes añadir notas al pie 1) utilizando paréntesis dobles. 

Puedes añadir notas al pie ((Esto es una nota al pie)) utilizando paréntesis dobles.

Estructuración en secciones

Puedes utilizar hasta cinco niveles diferentes de encabezados para estructurar tu contenido. Si tienes más de tres encabezados, se genera automáticamente una tabla de contenidos; esto se puede desactivar incluyendo la cadena ~~NOTOC~~ en el documento.

Título de nivel 3

Título de nivel 4

Título de nivel 5

Título de nivel 3

Título de nivel 4

Título de nivel 5

Utilizando cuatro o más guiones, puedes trazar una línea horizontal:

Archivos multimedia

Puedes incluir archivos externos e internos images con llaves. Opcionalmente, puedes especificar su tamaño.

Tamaño real:

Redimensionar a un ancho determinado:

Redimensionar a un ancho y una altura determinados (cuando la relación de aspecto del ancho y la altura especificados no coincida con la de la imagen, esta se recortará a la nueva relación antes de redimensionarla):

Imagen externa redimensionada:           

Tamaño real:                       {{wiki:dokuwiki-128.png }} 
Cambiar el tamaño a un ancho determinado:           {{wiki:dokuwiki-128.png?50 }} 
Cambiar el tamaño a un ancho y una altura determinados: {{wiki:dokuwiki-128.png?200x50}} 
Imagen externa redimensionada:           {{https://www.php.net/images/php.gif?200x50}}

Utilizando espacios en blanco a la izquierda o a la derecha, puedes elegir la alineación.

También puedes establecer la alineación de forma explícita con un ?left, ?right o ?center . Este parámetro tiene prioridad sobre la alineación por espacios en blanco mencionada anteriormente y se puede combinar con un tamaño.

Por supuesto, también puedes añadir un título (que la mayoría de los navegadores muestran como información sobre herramientas).

Este es el pie de foto 

{{ wiki:dokuwiki-128.png |Este es el pie de foto}}

Para vincular una imagen a otra página, consulta Image Links más arriba.

Formatos multimedia compatibles

DokuWiki puede incrustar directamente los siguientes formatos multimedia.

Imagen gif, jpg, png
Vídeo webm, ogv, mp4
Audio ogg, mp3, wav
Flash swf

Si especificas un nombre de archivo que no corresponde a un formato multimedia compatible, se mostrará como un enlace.

Al añadir ?linkonly se proporciona un enlace al archivo multimedia sin mostrarlo en la página

dokuwiki-128.png

dokuwiki-128.png Esto es solo un enlace a la imagen.

Formatos alternativos

Lamentablemente, no todos los navegadores admiten todos los formatos de vídeo y audio. Para mitigar este problema, puedes subir tu archivo en diferentes formatos para garantizar la máxima compatibilidad con los navegadores.

Por ejemplo, fíjate en este vídeo mp4 incrustado: 

{{de:wiki:video.mp4|Un vídeo divertido}}

Cuando subas un video.webm y video.ogv junto al archivo video.mp4, DokuWiki los añadirá automáticamente como alternativas para que el navegador pueda reproducir uno de los tres archivos.

Además, DokuWiki admite una imagen de «cartel» que se mostrará antes de que comience el vídeo. Esa imagen debe tener el mismo nombre de archivo que el vídeo y ser un archivo jpg o png. En el ejemplo anterior, un video.jpg funcionaría.

Listas

Dokuwiki admite listas ordenadas y desordenadas. Para crear un elemento de la lista, sangra el texto dos espacios y utiliza una etiqueta * para las listas no ordenadas o un - para las ordenadas.

  1. La misma lista, pero ordenada
  2. Otro elemento
    1. Solo tienes que usar sangría para los niveles más profundos
  3. Eso es todo
  * This is a list
  * The second item
    * You may have different levels
  * Another item

  - The same list but ordered
  - Another item
    - Just use indention for deeper levels
  - That's it

Echa también un vistazo a las preguntas frecuentes sobre elementos de lista.

Conversiones de texto

DokuWiki puede convertir determinados caracteres o cadenas predefinidos en imágenes, otro texto o código HTML.

La conversión de texto a imagen se realiza principalmente para los emoticonos. Y la conversión de texto a HTML se utiliza para sustituciones tipográficas, aunque también se puede configurar para utilizar otro código HTML.

Conversiones de texto a imagen

DokuWiki convierte los caracteres emoticon más utilizados en sus equivalentes gráficos. Esos Smileys y otras imágenes se pueden configurar y ampliar. A continuación se ofrece una descripción general de los emoticonos incluidos en DokuWiki:

Conversiones de texto a HTML

Tipografía: dokuwiki puede convertir caracteres de texto simples en sus entidades tipográficamente correctas. Aquí hay 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 se puede hacer para generar cualquier tipo de HTML; solo hay que añadirlo al archivo de patrones.

Hay tres excepciones que no proceden de ese archivo de patrones: la entidad de multiplicación (640×480), las «comillas simples» y las «comillas dobles». Se pueden desactivar mediante una opción de configuración.

Citas

A veces querrás marcar un texto para indicar que se trata de una respuesta o un comentario. Puedes utilizar la siguiente sintaxis: 

I think we should do it

> No we shouldn't

>> Well, I say we should

> Really?

>> Yes!

>>> Then lets do it!

Creo que deberíamos hacerlo

No, no deberíamos
Bueno, yo digo que sí
¿En serio?
¡Sí!
¡Pues hagámoslo!

Tablas

DokuWiki admite una sintaxis sencilla para crear tablas.

Título 1 Título 2 Título 3
Fila 1 Columna 1 Fila 1 Columna 2 Fila 1 Columna 3
Fila 2, columna 1 algún colspan (fíjate en la doble barra vertical)
Fila 3 Columna 1 Fila 3 Columna 2 Fila 3 Columna 3

Las filas de la tabla deben comenzar y terminar con un | para las filas normales o un ^ para los encabezados. 

^ Encabezado 1      ^ Encabezado 2       ^ Título 3          ^
| Fila 1 Columna 1    | Fila 1, columna 2     | Fila 1, columna 3        |
| Fila 2 Columna 1    | algún colspan (fíjate en la doble barra vertical) || 
| Fila 3 Columna 1    | Fila 3, columna 2     | Fila 3, columna 3        |

Para conectar celdas horizontalmente, basta con dejar la siguiente celda completamente vacía, tal y como se muestra arriba. ¡Asegúrate de que siempre haya el mismo número de separadores de celdas!

También es posible utilizar encabezados verticales en la tabla.

Encabezado 1 Encabezado 2
Encabezado 3 Fila 1 Columna 2 Fila 1, columna 3
Título 4 esta vez sin colspan
Título 5 Fila 2, columna 2 Fila 2, columna 3

Como puedes ver, es el separador de celdas que precede a una celda el que determina el formato: 

|              ^ Encabezado 1            ^ Encabezado 2          ^
^ Encabezado 3    | Fila 1 Columna 2          | Fila 1, columna 3        |
^ Título 4    | Esta vez no hay colspan |                    |
^ Título 5    | Fila 2, columna 2          | Fila 2, columna 3        |

Puedes crear «rowspans» (celdas conectadas verticalmente) añadiendo ::: en las celdas situadas debajo de aquella a la que deben conectarse.

Encabezado 1 Título 2 Título 3
Fila 1 Columna 1 esta celda se extiende verticalmente Fila 1 Columna 3
Fila 2, columna 1 Fila 2, columna 3
Fila 3, columna 1 Fila 2, columna 3

Aparte de la sintaxis «rowspan», esas celdas no deben contener nada más. 

^ Encabezado 1      ^ Título 2                  ^ Título 3          ^
| Fila 1 Columna 1    | esta celda se extiende verticalmente | Fila 1 Columna 3        |
| Fila 2, columna 1    | :::                        | Fila 2, columna 3        |
| Fila 3, columna 1    | :::                        | Fila 2, columna 3        |

También puedes alinear el contenido de la tabla. Solo tienes que añadir al menos dos espacios en blanco en el extremo opuesto del texto: añade dos espacios a la izquierda para alinear a la derecha, dos espacios a la derecha para alinear a la izquierda y al menos dos espacios en ambos extremos para centrar el texto.

Tabla con alineación
derecha centrado izquierda
izquierda derecha centro
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Así es como se ve en el código fuente: 

^           Tabla con alineación           ^^^
|         derecha|    centrado    |izquierda          |
|izquierda          |         derecha|    centro    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Nota: No se admite la alineación vertical.

Sin formato

Si necesitas mostrar el texto tal y como se ha escrito (sin ningún formato), enmarca el área con <nowiki> o, aún más sencillo, con dos signos de porcentaje %%.

Este es un texto que contiene direcciones como esta: http://www.splitbrain.org y **formato**, pero no se aplica nada. Lo mismo ocurre con //__este__ texto// con un emoticono ;-). 

<nowiki>
Este es un texto que contiene direcciones como esta: http://www.splitbrain.org y **formato**, pero no se aplica nada.
</nowiki>
Lo mismo ocurre con %%//__este__ texto// con un emoticono ;-)%%.

Bloques de código

Puedes incluir bloques de código en tus documentos, ya sea sangrándolos al menos dos espacios (como en los ejemplos anteriores) o utilizando las etiquetas <code> or <file>. 

This is text is indented by two spaces.
This is preformatted code all spaces are preserved: like              <-this
This is pretty much the same, but you could use it to show that you quoted a file.

Esos bloques se han creado a partir de esta fuente: 

  Este texto está sangrado dos espacios.
<code>
This is preformatted code all spaces are preserved: like              <-this
</code>
<file>
This is pretty much the same, but you could use it to show that you quoted a file.
</file>

Resaltado de sintaxis

dokuwiki puede resaltar el código fuente, lo que facilita su lectura. Utiliza el GeSHi Generic Syntax Highlighter, por lo que es compatible con cualquier lenguaje que admita GeSHi. La sintaxis utiliza el mismo código y los mismos bloques de archivo descritos en la sección anterior, pero en esta ocasión el nombre del lenguaje cuya sintaxis se va a resaltar se incluye dentro de la etiqueta, p. ej.: <code java> or <file 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("Hello World!"); //Display the string.
    }
}

The following language strings are currently recognized: 4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic

There are additional advanced options available for syntax highlighting, such as highlighting lines or adding line numbers.

Downloadable Code Blocks

When you use the <code> or <file> syntax as above, you might want to make the shown code available for download as well. You can do this by specifying a file name after language code like this: 

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

Si no quieres que se resalte nada, pero sí quieres un archivo descargable, especifica un guion (-) como código de lenguaje: <code - myfile.foo>.

Agregación de fuentes RSS/ATOM

dokuwiki puede integrar datos de fuentes XML externas. Para analizar las fuentes XML, SimplePie se utiliza. Todos los formatos que admite SimplePie también se pueden utilizar en DokuWiki. Puedes modificar la visualización mediante varios parámetros adicionales separados por espacios:

Parámetro Descripción
cualquier número se utilizará como número máximo de elementos que se mostrarán; el valor por defecto es 8
invertir Mostrar primero los últimos elementos del feed
author Mostrar los nombres de los autores de los elementos
date mostrar las fechas de los elementos
description mostrar la descripción del elemento. Se eliminarán todas las etiquetas HTML
nosort no ordenar los artículos del feed
n[dhm] periodo de actualización, donde d=días, h=horas, m=minutos. (p. ej., 12h = 12 horas).

El periodo de actualización predeterminado es de 4 horas. Cualquier valor inferior a 10 minutos se considerará como 10 minutos. dokuwiki intentará, por lo general, proporcionar una versión en caché de una página; obviamente, esto no es adecuado cuando la página contiene contenido externo dinámico. El parámetro indica a dokuwiki que vuelva a generar la página si ha transcurrido más de período de actualización desde la última vez que se renderizó la página.

Por defecto, el feed se ordenará por fecha, con los elementos más recientes primero. Puedes ordenarlo de forma que los más antiguos aparezcan primero utilizando el reverse , o mostrar el feed tal cual con nosort.

Ejemplo: 

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

Macros de control

Hay algunos elementos sintácticos que influyen en cómo DokuWiki representa una página sin generar ningún resultado por sí mismos. Están disponibles las siguientes macros de control:

Macro «^ » ^ Descripción |

~~NOTOC~~ Si se encuentra esta macro en la página, no se creará ninguna tabla de contenidos
~~NOTOC~~ DokuWiki almacena en caché toda la salida de forma predeterminada. En ocasiones, esto puede no ser deseable (por ejemplo, cuando se utiliza la sintaxis <php> anterior), añadir esta macro obligará a DokuWiki a volver a generar la página en cada llamada

Complementos de sintaxis

La sintaxis de DokuWiki se puede ampliar mediante complementos. El uso de los complementos instalados se describe en sus respectivas páginas de descripción. En esta instalación concreta de DokuWiki están disponibles los siguientes complementos de sintaxis:

1) Esto es una nota al pie