Sintaxis de formateado

DokuWiki soporta un lenguaje de marcado simple, que trata de mantener los ficheros de datos lo más legibles posible. Esta página contiene toda la sintaxis posible que puedes utilizar cuando editas páginas. Simplemente echa un vistazo al fuente de esta página pulsando sobre el botón Edita esta página en la parte superior o inferior de la misma. Si quieres probar algo, usa la página de pruebas. La sintaxis más sencilla está también disponible a través de botones rápidos.

Formatos de texto básicos

DokuWiki soporta texto en negrita, itálica, subrayado y monoespaciado. Por supuesto puedes combinar todos los formatos.

DokuWiki soporta texto en **negrita**, //itálica//, __subrayado__ y ''monoespaciado''.
Por supuesto puedes **__//''combinar''//__** todos los formatos.

Puedes usar también subíndices y superíndices.

Puedes usar también <sub>subíndices</sub> y <sup>superíndices</sup>.

Puedes marcar algo como borrado.

Puedes marcar algo como <del>borrado</del>.

Los párrafos se crean a partir de líneas en blanco. Si quieres forzar una nueva línea sin párrafo, puedes usar dos barras invertidas seguidas de un espacio al final de la línea.

Este es un texto con varias rupturas de línea
Observa que las dos barras invertidas sólo son reconocidas al final de la línea
o seguidas de
un espacio \\esto ocurre sin él.

Este es un texto con varias rupturas de línea\\ Observa que
las dos barras invertidas sólo son reconocidas al final de la línea\\
o seguidas de\\ un espacio \\esto ocurre sin él.

Deberías forzar nuevas líneas sólo si realmente es necesario.

Enlaces

DokuWiki soporta múltiples formas de crear enlaces.

Externos

Los enlaces externos son reconocidos automágicamente: http://www.google.com o simplemente www.google.com - Puedes cambiar el texto del enlace: Este enlace apunta a google. Las direcciones de correo electrónico como esta: andi@splitbrain.org también son reconocidas.

Los enlaces externos son reconocidos automágicamente: http://www.google.com o
simplemente www.google.com - Puedes cambiar 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 son reconocidas.

Internos

Los enlaces internos se crean usando corchetes. Puedes simplemente utilizar un wiki:pagename (nombre de página) o usar un Texto para el Título. Los nombres de página son convertidos a minúsculas automáticamente, no permitiéndose caracteres especiales.

Los enlaces internos se crean usando corchetes. Puedes simplemente utilizar
un [[doku>wiki:pagename]] (nombre de página) o usar un [[doku>wiki:pagename|Texto
para el Título]]. Los nombres de página son convertidos a minúsculas
automáticamente, no permitiéndose caracteres especiales.

Puedes usar Espacios de nombres utilizando “dos puntos” en el nombre de página.

Puedes usar [[wiki:namespaces|Espacios de nombres]] utilizando "dos puntos"
en el nombre de página.

Para detalles sobre los espacios de nombres, consulta wiki:namespaces.

También es posible enlazar a secciones específicas. Simplemente añade el nombre de la sección después de un carácter almohadilla tal y como se hace en html. Esto enlaza a esta sección.

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

Notas:

  • Los enlaces a páginas existentes se muestran con un estilo diferente a los no existentes.
  • DokuWiki no usa sintaxis CamelCase (TipoCamello) por defecto para crear automáticamente enlaces, pero este comportamiento es configurable en el fichero de configuración. Pista: Si DokuWiki es un enlace, entonces está habilitado.
  • Cuando cambia el encabezado de una sección, su enlazado cambian también. Por lo tanto, no te bases demasiado en enlazar secciones.

Interwiki

DokuWiki soporta enlaces wiki:interwiki. Estos son enlaces rápidos a otros Wikis. Por ejemplo un enlace a la página de la Wikipedia sobre Wikis: Wiki.

DokuWiki soporta enlaces [[doku>wiki:interwiki]]. Estos son enlaces rápidos a otros
Wikis. Por ejemplo un enlace a la página de la Wikipedia sobre Wikis: [[wp>Wiki]].

Compartidos Windows

Los compartidos Windows como este también se reconocen. Por favor, ten en cuenta que esto sólo tiene sentido en un grupo homogéneo de usuarios como los de una Intranet corporativa.

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

Notas:

  • Por razones de seguridad, la navegación directa de compartidos windows solo funciona en Internet Explorer por defecto (y sólo en la “zona local”).
  • Para Mozilla y Firefox se puede habilitar a través de la opción de configuración security.checkloaduri pero no se recomienda hacerlo.
  • Consulta 151 para más información.

Enlaces de Imagen

También puedes usar una imagen para enlazar a otra página interna o externa combinando la sintaxis para los enlaces y las imágenes (ver más abajo) como esta:

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

Nota: El formato de imágenes es la única sintaxis de formateo aceptada como nombre de enlace.

Notas al pie

Puedes añadir notas al pie1) usando dobles paréntesis.

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

Secciones

Puedes utilizar hasta cinco niveles diferentes de encabezado para estructurar el contenido. Si tienes más de tres encabezados, una tabla de contenidos es generada automáticamente – esta puede ser desactivada incluyendo el texto ~~NOTOC~~ en el documento.

Encabezado Nivel 3

Encabezado Nivel 4

Encabezado Nivel 5
==== Encabezado Nivel 3 ====
=== Encabezado Nivel 4 ===
== Encabezado Nivel 5 ==

Utilizando cuatro o más guiones, puedes hacer una linea horizontal:


Imágenes y otros ficheros

Puedes incluir imágenes externas e internas con llaves. Opcionalmente puedes especificar el tamaño de las mismas.

Tamaño original:

Redimensionado a un ancho dado:

Redimensionado a un ancho y auna altura dadas:

Redimensionado de una imagen externa:

Tamaño original:                               {{wiki:dokuwiki-128.png}}
Redimensionado a un ancho dado:                 {{wiki:dokuwiki-128.png?50}}
Redimensionado a un ancho y auna altura dadas: {{wiki:dokuwiki-128.png?200x50}}
Redimensionado de una imagen externa:          {{http://de3.php.net/images/php.gif?200x50}}

Usando espacios en blanco a la izquierda o la derecha puedes elegir el alineamiento

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

Por supuesto, puedes especificar un título (que se muestra como un tooltip por muchos navegadores.)

Esto es un caption
{{ wiki:dokuwiki-128.png |Esto es un caption}}

Si especificas un nombre de fichero (externo o interno) que no es un formato de imagen (gif,jpeg,png), se mostrará un enlace en su lugar.

Listas

Dokuwiki soporta listas ordenadas y no ordenadas. Para crear un elemento de lista, indenta tu texto con dos espacios y utiliza * para listas no ordenadas o - para listas ordenadas.

  • Esto es una lista
  • El segundo elemento
    • Puedes tener distintos niveles
  • Otro elemento
  1. La misma lista pero ordenada
  2. Otro elemento
    1. Simplemente indenta para niveles más profundos
  3. Eso es
  * Esto es una lista
  * El segundo elemento
    * Puedes tener distintos niveles
  * Otro elemento

  - La misma lista pero ordenada
  - Otro elemento
    - Simplemente indenta para niveles más profundos
  - Eso es

Smileys

DokuWiki convierte emoticons usados comúnmente a sus equivalentes gráficos. Más smileys pueden situarse en el directorio smiley y configurarse en el fichero conf/smileys.conf. Estos son los incluidos en DokuWiki.

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

Tipografía

DokuWiki convierte caracteres sencillos de texto a sus entidades tipográficas correctas. Este es un ejemplo de caracteres reconocidos.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “El pensó ‘Tengo que hacerlo’…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"El pensó 'Tengo que hacerlo'..."

Nota: Estas conversiones puedes desactivarse en el fichero de configuración.

Citando

Algunas veces quieres marcar un texto para indicar que es una respuesta o un comentario. Puedes usar la siguientes sintaxis:

Creo que deberíamos hacerlo

> No deberíamos

>> Bien, he dicho que deberíamos

> ¿De verdad?

>> Sí

>>> Entonces hagámoslo

Creo que deberíamos hacerlo

No deberíamos

Bien, he dicho que deberíamos

¿De verdad?

Entonces hagámoslo

Tablas

DokuWiki soporta una sintaxis sencilla 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 un colspan (notar el doble pipe)
Fila 3 Col 1 Fila 2 Col 2 Fila 2 Col 3

Las filas de las tablas deben comenzar con un | para una fila normal o un ^ para una fila de cabecera.

^ Cabecera 1      ^ Cabecera 2       ^ Cabecera 3          ^
| Fila 1 Col 1    | Fila 1 Col 2     | Fila 1 Col 3        |
| Fila 2 Col 1    | un colspan (notar el doble pipe)      ||
| Fila 3 Col 1    | Fila 2 Col 2     | Fila 2 Col 3        |

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

También es posible crear encabezados verticales.

Cabecera 1 Cabecera 2
Cabecera 3 Fila 1 Col 2 Fila 1 Col 3
Cabecera 4 sin colspan esta vez
Cabecera 5 Fila 2 Col 2 Fila 2 Col 3

Como puedes ver, es el separador antes de cada celda lo que decide el formato:

|               ^ Cabecera 1            ^ Cabecera 2          ^
^ Cabecera 3    | Fila 1 Col 2          | Fila 1 Col 3        |
^ Cabecera 4    | sin colspan esta vez  |                     |
^ Cabecera 5    | Fila 2 Col 2          | Fila 2 Col 3        |

Nota: Los spans verticales (rowspan) no son posibles.

Puedes alinear los contenidos de la tabla también. Simplemente añade 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 a cada lado para centrar el texto.

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

Así es como se ve en el fuente:

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

Bloques no interpretados

Puedes incluir bloques no interpretados en tus documentos identándolos con al menos dos espacios (como se ha usado en los ejemplo previos) o usando las etiquetas code o file.

Esto es código preformateado con todos los espacios preservados: como         <-estos
Esto es más o menos lo mismo, pero lo puedes utilizar para indicar que pertenece a un fichero.

Para que el analizador ignore completamente un área (es decir, que no haga ningún formateo en ella), inclúyela entre las etiquetas nowiki o más sencillamente, con dobles signos de porcentaje %%.

Este es un texto que contiene direcciones como http://www.splitbrain.org y **formateos**, pero no se hace nada con ellos.

Mira el fuente de esta página para ver cómo se usan estos bloques.

Resaltado de Sintaxis

DokuWiki puede resaltar el código fuente, lo que lo hace más fácil de leer. Utiliza el Resaltado Genérico de Sintaxis GeSHi – por lo tanto cualquier lenguaje soportado por GeSHi es soportado. La sintaxis es la misma que la del bloque de código en la sección previa, pero en este caso se inserta el nombre del lenguaje dentro de la etiqueta. 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("Hello World!"); //Display the string.
    }
}

Los siguiente lenguajes son reconocidos: actionscript, ada, apache, asm, asp, bash, caddcl, cadlisp, c, c_mac, cpp, csharp, css, delphi, html4strict, java, javascript, lisp, lua, mpasm, nsis, objc, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, smarty, sql, vb, vbnet, visualfoxpro, xml

Embebiendo HTML y PHP

Puedes embeber código HTML y PHP en tus documentos usando las etiquetas html o php así:

<html>
Esto es algo de <font color="red" size="+1">HTML</font>
</html>
Esto es algo de <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 !" />';

Nota: El embebido HTML y PHP está deshabilitado por defecto en esta instalación. Cuando está desactivado, el código es mostrado en lugar de ejecutado.

1) Esto es una nota al pie
 
  wiki_crue/sintaxis.txt · Última modificación: 17/05/2005 00:03 by 80.58.39.170 (juanjova)