¡Esta es una revisión vieja del documento!
Edición de páginas
DokuWiki soporta un lenguaje de marcas simple, que trata de hacer los ficheros de datos tan legibles como sea posible. Esta página contiene todas las posibles opciones que puedes utilizar al editar las páginas. Basta con echar un vistazo al código fuente de esta página pulsando el botón Editar esta página en la parte superior o inferior de la página. Si quieres probar algo, sólo tiene que utilizar la Zona de pruebas. Las marcas de formato pueden ser introducidas fácilmente mediante la barra de herramientas.
Formatos de texto
DokuWiki soporta negrita, cursiva, subrayado y monoespaciado
. Por supuesto, puedes combinar
estos formatos.
DokuWiki soporta **negritas**, //cursiva//, __subrayado__ y ''monoespaciado''. Por supuesto, puedes **__//''combinar ''//__** estos formatos.
También puedes utilizar subíndices y superíndices.
También puedes utilizar <sub>subíndices</sub> y <sup>superíndices</sup>.
Puedes marcar algo como eliminado.
Puedes marcar algo como <del>eliminado</del>.
Los párrafos se crean a partir de líneas en blanco. Si deseas insertar un salto de línea, puedes usar dos barras invertidas seguidas de un espacio o el final de la línea.
Este es un texto con algunos saltos de línea.
Observa que las
dos barras invertidas son reconocidas solamente al final de una línea
o seguidas de
un espacio en blanco. \\Esto sucede sin él.
Este es un texto con algunos saltos de línea.\\ Observa que las dos barras invertidas son reconocidas solamente al final de una línea\\ o seguidas de\\ un espacio en blanco. \\Esto sucede sin él.
Sólo necesitas insertar saltos de línea al final de cada párrafo.
Enlaces
DokuWiki soporta múltiples tipos de enlaces.
Externos
Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com. Puedes configurar el texto del enlace, así: Este enlace apunta a google. También se reconocen las direcciones de correo electrónico como la siguiente: andi@splitbrain.org.
DokuWiki soporta múltiples formas de crear enlaces. Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com. Puedes configurar el texto del enlace, así: [[http://www.google.com|Este enlace apunta a google]]. También se reconocen las direcciones de correo electrónico como la siguiente: <andi@splitbrain.org>.
Internos
Los enlaces internos se crean mediante dobles corchetes. Puedes utilizar el nombre de página o establecer un texto de enlace.
Los enlaces internos se crean mediante dobles corchetes. Puedes utilizar el [[nombre de página]] o establecer un [[nombre de página|texto de enlace]].
Los nombres de páginas wiki se convierten a minúsculas automáticamente, los caracteres especiales no están permitidos.
Puedes indicar una carpeta para la página mediante el uso de dos puntos entre el nombre de la carpeta y el de la página.
Puedes indicar una carpeta para la [[carpeta:página]] mediante el uso de dos puntos entre el nombre de la carpeta y el de la página.
Para obtener más información acerca de las carpetas mira namespaces.
También es posible enlazar con una sección específica de la página. Sólo tienes que añadir el nombre de sección detrás de una almohadilla, como se hace en HTML. Aquí se enlaza con esta Sección.
Aquí se enlaza con [[syntax#internos|esta Sección]].
Notas:
- Los enlaces a páginas existentes se muestran en un estilo diferente de los enlaces a páginas inexistentes.
- Cuando se cambia el título de una sección, su marcador también cambia. Así que no confies demasiado en los enlaces a secciones.
Interwiki
DokuWiki soporta enlaces Interwiki. Éstos son enlaces rápidos a otras Wikis. Por ejemplo, éste es un enlace a la página de la Wikipedia sobre Wikis: Wiki.
DokuWiki soporta enlaces [[doku>Interwiki]]. Éstos son enlaces rápidos a otras Wikis. Por ejemplo, éste es un enlace a la página de la Wikipedia sobre Wikis: [[wp>Wiki]].
Enlaces con imagen
También puedes utilizar una imagen como enlace a otra página interna o externa combinando la sintaxis de enlaces e imágenes (ver abajo), así:
[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]
Nota: El formato de imagen es el único formato aceptado en los nombres de enlace.
Se admite la sintaxis completa de imágenes y enlaces (incluyendo redimensionamiento de la imagen, imágenes internas y externas, URLs y enlaces interwiki).
Notas al pie
Puedes agregar notas al pie 1) usando paréntesis dobles.
Puedes agregar notas al pie ((Esto es una nota al pie.)) usando paréntesis dobles.
Secciones
Puedes usar hasta cinco niveles de encabezado distintos para estructurar tus contenidos. Si hay más de tres encabezados, se genera automáticamente una tabla de contenidos - esto se puede desactivar mediante la inclusión de 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 ==
Puedes crear una línea horizontal:
mediante el uso de cuatro o más guiones seguidos.
----
Imágenes y otros archivos
Puedes incluir imágenes externas e internas, entre llaves dobles. Opcionalmente puedes especificar su tamaño.
Anchura y altura redimensionadas 2):
Imagen externa redimensionada:
Tamaño real: {{wiki:dokuwiki-128.png}} Anchura redimensionada: {{wiki:dokuwiki-128.png?50}} Anchura y altura redimensionadas: {{wiki:dokuwiki-128.png?200x50}} Imagen externa redimensionada: {{http://de3.php.net/images/php.gif?200x50}}
Puedes establecer la alineación horizontal mediante el uso de espacios en blanco a la izquierda, a la derecha o en ambos lados:
{{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }}
También puedes agregar un título (se muestra como un indicador emergente en la mayoría de los navegadores).
{{ wiki:dokuwiki-128.png |Este es el título}}
Si especificas un nombre de archivo (externo o interno) que no sea una imagen (gif, jpeg, png
), se mostrará como un enlace.
Para enlazar una imagen a otra página ver Enlaces con imagen más arriba.
Listas
DokuWiki soporta listas ordenadas y desordenadas. Para crear un elemento de lista, indenta tu texto con dos espacios y usa un *
para las listas desordenadas o un -
para las ordenadas.
- Esta es una lista
- Segundo elemento
- Puedes tener diferentes niveles
- Otro elemento
- La misma lista pero ordenada
- Segundo elemento
- Basta con usar indentación para obtener más niveles
- Eso es todo
* Esta es una lista * Segundo elemento * Puedes tener diferentes niveles * Otro elemento - La misma lista pero ordenada - Segundo elemento - Basta con usar indentación para obtener más niveles - Eso es todo
Échale un vistazo a FAQ sobre listas.
Conversiones de texto
DokuWiki puede convertir ciertos caracteres o cadenas pre-definidos en imágenes o en otro texto o HTML.
La conversión de texto a imágenes se realiza principalmente para obtener los emoticonos. Y la conversión de texto a HTML se utiliza para reemplazos en la tipografía, pero puede ser configurado para usar otras marcas HTML.
Conversiones de texto a imagen
DokuWiki convierte los populares emoticonos a sus equivalentes gráficos. Los Smileys y otras imágenes se pueden configurar y extender. Aquí tienes los Smileys incluidos en DokuWiki:
8-)
8-O
:-(
:-)
=)
:-/
:-\
:-?
:-D
:-P
:-O
:-X
:-|
;-)
^_^
:?:
:!:
LOL
FIXME
DELETEME
Conversiones de texto a HTML
Tipografía: DokuWiki puede convertir caracteres de texto simples a su tipografía correcta. He aquí un ejemplo de caracteres reconocidos.
→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “Pensó 'Es un mundo de hombres'…”
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "Pensó 'Es un mundo de hombres'..."
Lo mismo se puede hacer para producir cualquier tipo de código HTML, sólo tienes que añadirlo a la plantilla.
Hay tres símbolos que no se establecen en esa plantilla: multiplicación (640×480), comillas 'simples' y “dobles”. Se puede desactivar a través de una opción de configuración.
Citas
A veces desearás marcar un texto para indicar que es una respuesta o comentario. Puedes utilizar la siguiente sintaxis:
Creo que deberíamos hacerlo. > No, no debemos. >> Bueno, yo digo que debemos. > ¿En serio? >> ¡Sí! >>> ¡Entonces hagámoslo!
Creo que deberíamos hacerlo.
No, no debemos.
Bueno, yo digo que debemos.
¿En serio?
¡Sí!
¡Entonces hagámoslo!
Tablas
DokuWiki tiene una sintaxis simple para crear tablas.
Encabezado 1 | Encabezado 2 | Encabezado 3 |
---|---|---|
Fila 1 Columna 1 | Fila 1 Columna 2 | Fila 1 Columna 3 |
Fila 2 Columna 1 | celdas conectadas (nótese la doble barra) | |
Fila 3 Columna 1 | Fila 3 Columna 2 | Fila 3 Columna 3 |
Las filas tienen que empezar y terminar con una |
para las filas normales o con un ^
para los encabezados.
^ Encabezado 1 ^ Encabezado 2 ^ Encabezado 3 ^ | Fila 1 Columna 1 | Fila 1 Columna 2 | Fila 1 Columna 3 | | Fila 2 Columna 1 | celdas conectadas (nótese la doble barra) || | Fila 3 Columna 1 | Fila 3 Columna 2 | Fila 3 Columna 3 |
Para conectar celdas horizontalmente, deja la celda siguiente completamente vacía como se muestra arriba ¡Asegúrate de tener la misma cantidad de separadores de celda en todas las filas!
Los encabezados verticales también son posibles.
Encabezado 1 | Encabezado 2 | |
---|---|---|
Encabezado 3 | Fila 1 Columna 2 | Fila 1 Columna 3 |
Encabezado 4 | Sin conexión esta vez | |
Encabezado 5 | Fila 3 Columna 2 | Fila 3 Columna 3 |
Como puedes ver, el separador de celda antes de una celda es el que especifica el formato:
| ^ Encabezado 1 ^ Encabezado 2 ^ ^ Encabezado 3 | Fila 1 Columna 2 | Fila 1 Columna 3 | ^ Encabezado 4 | Sin conexión esta vez | | ^ Encabezado 5 | Fila 3 Columna 2 | Fila 3 Columna 3 |
Puedes conectar celdas verticalmente, añadiendo :::
en las celdas por debajo de aquella a la que deben conectarse.
Encabezado 1 | Encabezado 2 | Encabezado 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 del indicador de conexión, esas células no debe contener ninguna otra cosa.
^ Encabezado 1 ^ Encabezado 2 ^ Encabezado 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. Sólo 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 dos espacios en ambos extremos para obtener texto centrado.
Tabla con alineación | ||
---|---|---|
derecha | centro | izquierda |
izquierda | derecha | centro |
xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Así es como se ve en el código fuente:
^ Tabla con alineación ^^^ | derecha| centro |izquierda | |izquierda | derecha| centro | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
Nota: La alineación vertical no está soportada.
Sin formato
Si necesitas mostrar el texto exactamente como se escribe (sin formato) encierra el área entre etiquetas <nowiki>
o, aún más simple, entre signos de porcentaje doble %%
.
Este es un texto que contiene direcciones como ésta: http://www.splitbrain.org y **formatos**, pero no se hace nada con él. Lo mismo es cierto para //__este__ texto// con un emoticono ;-).
<nowiki> Este es un texto que contiene direcciones como ésta: http://www.splitbrain.org y **formatos**, pero no se hace nada con él. </nowiki> Lo mismo es cierto para %%//__este__ texto// con un emoticono ;-)%%.
Bloques de código
Puedes incluir bloques de código en tus documentos, bien indentando por al menos dos espacios (como en los ejemplos anteriores) o usando las etiquetas <code>
o <file>
.
Este texto está indentado por dos espacios.
Esto es código preformateado, todos los espacios se preservan: como <-aquí
Esto es casi lo mismo, pero lo puedes usar para indicar que has citado un archivo.
Los bloques anteriores fueron creados por este código fuente:
Este texto está indentado por dos espacios.
<code> Esto es código preformateado, todos los espacios se preservan: como <-aquí </code>
<file> Esto es casi lo mismo, pero lo puedes usar para indicar que has citado un archivo. </file>
Resaltado de código
DokuWiki puede resaltar el código fuente, lo que hace que sea más fácil de leer. Se utiliza el resaltador de sintaxis genérico GeSHi- por lo que cualquier lenguaje soportado por GeSHi es compatible. La sintaxis es la misma que en los bloques de código y archivo de la sección anterior, pero esta vez el nombre del lenguaje utilizado se inserta dentro de la etiqueta. Ej. <code java>
o <file java>
.
/** * La clase HolaMundo implementa una aplicación que * muestra "¡Hola Mundo!" por la salida estándar. */ class HolaMundo { public static void main(String[] args) { System.out.println("¡Hola Mundo!"); //Mostrar la cadena. } }
Los lenguajes siguientes son reconocidos actualmente: 4cs, abap, actionscript-french, actionscript, actionscript3, ada, apache, applescript, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, ecmascript, eiffel, email, erlang, fo, fortran, freebasic, fsharp, gambas, genero, genie, gdb, glsl, gml, gnuplot, groovy, gettext, gwbasic, haskell, hicest, hq9plus, html, icon, idl, ini, inno, intercal, io, j, java5, java, javascript, jquery, kixtart, klonec, klonecpp, latex, lisp, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, modula2, modula3, mmix, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, ocaml-brief, ocaml, oobas, oracle8, oracle11, oxygene, oz, pascal, pcre, perl, perl6, per, pf, php-brief, php, pike, pic16, pixelbender, plsql, postgresql, povray, powerbuilder, powershell, progress, prolog, properties, providex, purebasic, 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, vala, vbnet, vb, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, winbatch, whois, xbasic, xml, xorg_conf, xpp, z80
Bloques de código descargables
Cuando utilices bloques <code>
o <file>
, como en los ejemplos anteriores, puede que desees que el código que se muestra esté también disponible para su descarga. Puedes hacerlo especificando un nombre de archivo después del código de idioma, como aquí:
<file php miejemplo.php> <?php echo "¡Hola Mundo!"; ?> </file>
- miejemplo.php
<?php echo "¡Hola Mundo!"; ?>
Si no deseas resaltado, pero sí un archivo descargable, especifica un guión (-
) como código de idioma: <code - myfile.foo>
.
Incrustación de HTML y PHP
Puedes incrustar código HTML o PHP en tus documentos utilizando las etiquetas <html>
o <php>
. (Utiliza etiquetas en mayúsculas si necesitas insertar bloques de elementos.)
Ejemplo HTML:
<html> Esto es un <span style="color:red;font-size:150%;">HTML en línea</span> </html> <HTML> <p style="border:2px dashed red;">Y esto es un bloque HTML</p> </HTML>
Esto es un HTML en línea
Y esto es un bloque HTML
Ejemplo PHP:
<php> echo 'Logo generado por PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="¡Logo PHP!" />'; echo '(HTML en línea)'; </php> <PHP> echo '<table class="inline"><tr><td>Lo mismo, pero utilizando un bloque de elementos:</td>'; echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="¡Logo PHP!" /></td>'; echo '</tr></table>'; </PHP>
Logo generado por PHP:(HTML en línea)
Lo mismo, pero utilizando un bloque de elementos: |
Nota : La incrustación de HTML y PHP está desactivada en la configuración por defecto. Si está deshabilitada, el código se muestra en lugar de ejecutarse.
Agregación de fuentes RSS/ATOM
DokuWiki puede integrar datos de fuentes externas XML. Para el análisis de las fuentes XML se utiliza SimplePie. Todos los formatos soportados por SimplePie se pueden utilizar también en DokuWiki. Puedes definir la presentación mediante parámetros adicionales, separados por espacios:
Parámetro | Descripción |
---|---|
cualquier número | número máximo de elementos a mostrar, por defecto 8 |
reverse | mostrar primero los últimos artículos de la fuente |
author | mostrar el nombre de los autores de los artículos |
date | mostrar la fecha de los artículos |
description | mostrar la descripción de los artículos. Si HTML está desactivado se ignorarán todas las etiquetas |
n[dhm] | intervalo de refresco, dónde d=días, h=horas, m=minutos. (e.g. 12h = 12 horas). |
El intervalo de refresco por defecto es de 4 horas. Cualquier valor por debajo de 10 minutos será tratado como 10 minutos. DokuWiki tratará, en general, de proporcionar una versión en caché de las páginas; obviamente esto no es apropiado cuando la página tiene contenido dinámico externo. Este parámetro indica a DokuWiki que actualice la página si se ha excedido el intervalo de refresco desde la última vez que la página fue accedida.
Ejemplo:
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
- Se ha producido un error mientras se leían los datos de este feed: http://slashdot.org/index.rss
Macros de control
Las macros de control siguientes están disponibles:
Macro | Descripción |
---|---|
~~NOTOC~~ | Si esta macro se encuentra en la página, no se creará la tabla de contenidos |
~~NOCACHE~~ | DokuWiki cachea todos los datos por defecto. A veces esto no es lo deseable (por ejemplo, cuando se utiliza la etiqueta <php> anterior), la adición de esta macro fuerza a DokuWiki a volver a procesar la página en cada llamada |
Plugins
La funcionalidad de DokuWiki puede extenderse con Plugins. Cómo utilizar los plugins instalados se detalla en sus correspondientes páginas descriptivas. Los siguientes plugins están disponibles en esta Wiki:
- OpenLayers Map with OpenStreetMap, Google, VirtualEarth or Yahoo 2011-04-03 (1.0-SNAPSHOT) por Mark C. Prins
Add maps to your wiki pages - Wrap Plugin 2011-05-15 por Anika Henke
Universal plugin which combines functionalities of many other plugins. Wrap wiki text inside containers (divs or spans) and give them a class (choose from a variety of preset classes), a width and/or a language with its associated text direction. - Gallery Plugin 2010-04-30 por Andreas Gohr
Creates a gallery of images from a namespace or RSS/ATOM feed