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.
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.
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: 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.
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:
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]].
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:
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).
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.
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 ==
Al utilizar cuatro guiones o más, puede hacer una línea horizontal:
Puede incluir imágenes internas y externas con corchetes. Opcionalmente puede especificar su tamaño.
Redimensionado al ancho y alto dados 2):
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).
{{ 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.
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 - 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.
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.
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:
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.
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!
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.
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 ;-)%%.
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>
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
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>
<?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>
.
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.
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 }}
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. |
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: