====== 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 = - 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. - 5 guiones para secciones. - 4 guiones para subsecciones. En la inmensa mayoría de los casos hasta este nivel es suficiente. - 3 guiones para subsubsecciones. Y así hasta 1 guión. - 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]] - 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 la página web de DokuWiki en español: [[doku>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.((Sin embargo, hay publicaciones recientes que sostienen que no todavía no está resuelto todo.)) 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: {{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}} ==== 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. {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} ===== 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. - Primer ítem. - Segundo ítem. - Anidado uno. - Anidado dos. - 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((Hay que tener sumo cuidado con los espacios al comienzo de las líneas porque DokuWiki interpreta dos espacios al comienzo de una línea como si de código sin procesar se tratara. Si no se ve de modo correcto una definición solo revise los dos espacios que deben haber al comienza de cada definición y en las líneas en blanco **no deben haber** espacios. Ni antes de la definición, ni en medio de ellas y, es recomendable, tampoco después de las definiciones.)): ? 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 | | ^ 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 | ^ 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 | ^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 | ^ Tabla con alineamiento ^^^ | derecha| centro |izquierda | |izquierda | derecha| centro | | xxxxxx | xxxxxx | xxxxxx | {{tag>S Sintaxis}}