Sintaxis rápida de DokuWiki

DokuWiki cuenta con un lenguaje de marcado tipo wiki. Es muy sencillo y fácil de aprender y de leer para un ser humano. En la barra superior del editor se puede pinchar en cada ícono para que escriba la instrucción correspondiente. Además, la barra cuenta con íconos que pertenecen a plugins instalados en esta DokuWiki que añaden nuevas funciones. También es de mucha ayuda revisar cómo se han escrito otras páginas de esta web para familiarizarse con las sintaxis DokuWiki.

Sintaxis básica

Para escribir una página en esta DokuWiki hay que incluir las siguientes instrucciones mediante símbolos que DokuWiki entiende como instrucciones.

Encabezados

Se introducen mediante el símbolo igual: =. Y según su cantidad es de mayor o menor nivel. En DokuWiki va desde 6 guiones hasta 1 guión.

====== Seis guiones: Título de página ======
===== Cinco guiones: Sección =====
==== Cuatro guiones: Subsección ====
=== Tres guiones: Subsubsección ===
== Dos guiones: Parágrafo ==
= Un guión Subparágrafo =

1. 6 guiones es la jerarquía más alta y se reserva para el título de la página. No deben haber dos encabezados de este tipo en una página.
2. 5 guiones para secciones.
3. 4 guiones para subsecciones. En la inmensa mayoría de los casos hasta este nivel es suficiente.
4. 3 guiones para subsubsecciones. Y así hasta 1 guión.
5. Son secciones: Referencias y Véase también. Se usan con 5 guiones.

Por ejemplo:

====== Título de la página ======

Se recomienda escribir un texto introductorio que 
es un resumen del tema de la página. 

===== Sección de la página ====

Texto de la sección. No hay límite en el
número de secciones. Pero si se vuelve muy
extenso, tal vez, sea mejor dividar el tema
en dos páginas. Por ejemplo: Página principal
y anexo.


Y si se necesita dividir la sección en subsecciones 
haga lo siguiente:

==== Subsección ====

Esta es una subsección de la sección previa. Una vez 
terminada la subsección se puede crear otra sección.

===== Referencias =====

Incluya aquí las referencias externas al tema de la página y que
no sean páginas de esta DokuWiki (libros, revistas, etc.). Añádalas
al final del contenido de la página.


===== Véase también =====

Después de las referencias incluya aquí páginas internas 
de la DokuWiki  que estén relacionadas con el tema. 

Formato de texto

DokuWiki permite destacar el texto mediante los siguientes símbolos:

Por ejemplo:

Cursiva: //Texto en cursiva//
Negrita: **Texto en negrita**

Cursiva: Texto en cursiva

Negrita: Texto en negrita

Enlaces

En DokuWiki es posible disponer de varios tipos de enlaces. El color del enlace indicará si existe esa página o no. Si es verde existe la página interna. Si es azul entonces existe la página externa. Si es rojo no existe el enlace. Si es un enlace interno y está en rojo, al pinchar en él, DokuWiki indicará si se quiere crear dicha página. Si es externo el color rojo indicará que el enlace no existe o está roto.

 Enlace a una página de esta DokuWiki: [[sintaxis]]
 
 Enlace a una página externa: [[https://www.codespj.cl/blog]]
 
 Enlace a una página externa con un texto: 
 [[https://www.codespj.cl/blog | Blog del CODES]]
 
 Enlace a una página de WikipediA: [[wpes>Dokuwiki]]. 
 Hay que añadir «es» después de «wp» para que se enlace  a la 
 versión en español. De no hacerlo se mostrará la página en inglés.
 
 Enlace a página de la web de DokuWiki en español: [[doku>es:Syntax]]

1. Enlace a una página de esta DokuWiki: Sintaxis
2. Enlace a una página externa: https://www.codespj.cl/blog
3. Enlace a una página externa con un texto: Blog del CODES
4. Enlace a una página de WikipediA: Dokuwiki. Hay que añadir «es» después de «wp» para que se enlace a la versión en español. De no hacerlo se mostrará la página en inglés.
5. Enlace a la página web de DokuWiki en español: es:Syntax

Notas al pie

Las notas al pie se usan para añadir información que sirve para comprender mejor el tema pero que no es directamente relevante para el texto que está exponiendo el tema. Por ejemplo: Hay varios premios Nobel que dicen que este tema ya está resuelto y no se va investigar más.¹⁾

La sintaxis de las notas al pie es la 
siguiente((Esto es una nota al pie de página.))

Imágenes

Archivos multimedia como son imágenes, audios y vídeos se pueden incorporar de la siguiente manera:

Tamaño real:                      {{wiki:dokuwiki-128.png}}
Redimensionando la anchura:       {{wiki:dokuwiki-128.png?50}}
Redimensionando altura y anchura: {{wiki:dokuwiki-128.png?200x50}}
Imagen externa redimensionada:    {{https://www.php.net/images/php.gif?200x50}}

Tamaño real:

Redimensionando la anchura:

Redimensionando altura y anchura:

Imagen externa redimensionada:

Posición de las imágenes

Para ubicar las imágenes en DokuWiki basta con añadir un espacio al lado izquierdo, derecho o ambos de los paréntesis para que la imagen se ubique a la izquierda, derecha o centro de la página. Por ejemplo:

{{ wiki:dokuwiki-128.png}}   Izquierda.  
{{wiki:dokuwiki-128.png }}   Derecha.
{{ wiki:dokuwiki-128.png }}  Centro.

Listas

Ordenadas y no ordenadas

En DokuWiki hay dos tipos de listas: Las ordenadas (números, letras, etc.) y las no ordenadas. Se introducen añadiendo dos espacios al comienzo de la línea y a continuación un guion: - para las listas ordenadas y un asterisco: * para las ordenadas. Las listas se pueden anidar añadiendo dos espacios más en aquellos ítem que se quiere que estén dentro de otros. Las listas ordenadas, si están anidadas, cambiaran su posición más a la derecha y la enumeración de números a letras. Y las no ordenados cambiarán a una posición más a la derecha.

Por ejemplo:

  - Primer ítem.
  - Segundo ítem.
      - Anidado uno.
      - Anidado dos.
  - Tercer ítem.

  * Primer ítem.
  * Segundo ítem.
      * Anidado uno.
      * Anidado dos.
  * Tercer ítem.

1. Primer ítem.
2. Segundo ítem.
   1. Anidado uno.
   2. Anidado dos.
3. Tercer ítem.

• Primer ítem.
• Segundo ítem.
  • Anidado uno.
  • Anidado dos.
• Tercer ítem.

Definiciones

Las listas de definiciones usan, en esta DokuWiki, la siguiente sintaxis:

  ? Primer término a definir.
  : Definición del término si la definición es de un solo párrafo.

  ? Siguiente término a definir.
  : Definición que contiene más de un párrafo. Definición que 
  contiene más de un párrafo. Definición que contiene más de un 
  párrafo. Definición que contiene más de un párrafo. Definición 
  que contiene más de un párrafo. Definición que contiene más de 
  un párrafo. Definición que contiene más de un párrafo.
  : Este es el segundo párrafo. Este es el segundo párrafo. Este 
  es el segundo párrafo. Este es el segundo párrafo. Este es el 
  segundo párrafo. Este es el segundo párrafo. Este es el segundo 
  párrafo. 
  : Y este es el último párrafo de esta definición.

  ? Tercer y último término.
  : Definición del tercer y último término.

Las definiciones se verán de este modo²⁾:

Primer término a definir.

Definición del término si la definición es de un solo párrafo.

Siguiente término a definir.

Definición que contiene más de un párrafo. Definición que contiene más de un párrafo. Definición que contiene más de un párrafo. Definición que contiene más de un párrafo. Definición que contiene más de un párrafo. Definición que contiene más de un párrafo. Definición que contiene más de un párrafo.

Este es el segundo párrafo. Este es el segundo párrafo. Este es el segundo párrafo. Este es el segundo párrafo. Este es el segundo párrafo. Este es el segundo párrafo. Este es el segundo párrafo.

Y este es el último párrafo de esta definición.

Tercer y último término.

Definición del tercer y último término.

Tablas

En DokuWiki es posible crear tablas sencillas. La división de celdas se hacen usando el símbolo |. Los encabezados con el símbolo ^. Se pueden unir celdas dejando contiguas barras verticales: || o ^^. Y unir verticalmente celdas añadiendo en cada celda :::. Los siguientes ejemplos muestran estas opciones.

Tabla con encabezados y celdas

|              ^ Encabezado 1         ^ Encabezado 2       ^
^ Encabezado 3 | Fila 1 Col 2         | Fila 1 Col 3       |
^ Encabezado 4 | Fila 2 Col 2         | Filo 2 Col 3       |
^ Encabezado 5 | Fila 3 Col 2         | Fila 3 Col 3       |

Tabla con celdas unidas horizontalmente

^ Encabezado 1   ^ Encabezado 2    ^ Encabezado   ^
| Fila 1 Col 1   | Fila 1 Col 2    | Fila 1 Col 3  |
| Fila 2 Col 1   | Unir dos celdas horizontales   ||
| Fila 3 Col 1   | Fila 2 Col 2    | Fila 2 Col 3  |

Tabla con celdas unidas verticalmente

^Encabezado 1         ^Encabezado 2                        ^Encabezado 3       ^
|Fila 1 Columna 1     |Esta celda se combina verticalmente |Fila 1 Columna 3   |
|Fila 2 Columna 1     |:::                                 |Fila 2 Columna 3   |
|Fila 3 Columna 1     |:::                                 |Fila 2 Columna 3   |

Tabla con alineación de celdas

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