* 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 [[doku>faq:lists|FAQ sobre elementos de listas]].
===== Conversiones de texto =====
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.
==== Conversiones de texto a imagen ====
DokuWiki convierte los [[wp>emoticon|emoticonos]] más comunes a sus equivalentes gráficos. Esas [[doku>Smileys|caritas]] y otras imágenes pueden configurarse y extenderse. He aquí una vista general de las caritas incluidas en DokuWiki:
* 8-) %% 8-) %%
* 8-O %% 8-O %%
* :-( %% :-( %%
* :-) %% :-) %%
* =) %% =) %%
* :-/ %% :-/ %%
* :-\ %% :-\ %%
* :-? %% :-? %%
* :-D %% :-D %%
* :-P %% :-P %%
* :-O %% :-O %%
* :-X %% :-X %%
* :-| %% :-| %%
* ;-) %% ;-) %%
* ^_^ %% ^_^ %%
* :?: %% :?: %%
* :!: %% :!: %%
* LOL %% LOL %%
* FIXME %% FIXME %%
* DELETEME %% DELETEME %%
==== Conversiones de texto a HTML ====
Typografía: [[dokuwiki]] puede convertir caracteres de texto simple a sus entidades tipográficamente correctas. He aquí un ejemplo de caracteres reconocidos.
-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"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 [[doku>entities|archivo de patrones]].
Hay tres excepciones que no provienen del archivo de patrones: la entidad de multiplicación (640x480), las comillas 'simples' y "dobles". Pueden apagarse mediante la opción de [[doku>config:typography|configuración]].
===== Citas =====
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!
===== Tablas =====
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.
===== Sin formato =====
Si necesita mostrar texto exactamente como se teclea (sin ningún formato), encierre el área o bien con etiquetas ''%%%%'' o ''%%%%''.
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.
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 aarchivo.
==== Resaltado de sintaxis ====
[[dokuwiki]] puede resaltar código fuente, que lo hace más fácil de leer. Se utiliza [[http://qbnz.com/highlighter/|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: ''
/**
* 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//
==== Bloques de código descargables ====
Cuando utiliza la sintaxis ''%%%%'' o ''%%%%'' 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í:
Si no desea el resaltado, sino el archivo descargable, especifique un guión (''-'') como código del lenguage: ''%%%%''.
===== Incrustando HTML y PHP =====
Puede incrustar código puro HTML o PHP en sus documentos utilizando las etiquetas ''%%%%'' o ''%%%%''. (Utilice etiquetas en mayúsculas si necesita encerrar elementos de nivel de bloque.)
Ejemplo HTML:
Esto es un HTML alineado
Y esto es un bloque HTML
Esto es un HTML alineado
Y esto es un bloque HTML
Ejemplo PHP:
echo 'Un logo generado por PHP:';
echo ' . ')
';
echo '(HTML alineado generado)';
echo 'Lo mismo, pero dentro de un elemento de nivel de bloque: ';
echo '
';
echo 'Un logo generado por PHP:';
echo '';
echo '(inline HTML)';
echo 'Lo mismo, pero dentro de un elemento de nivel de bloque: ';
echo '
';
**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.
===== Agregación de fuentes RSS/ATOM =====
[[dokuwiki]] puede integrar datos de fuentes XML externas. Para analizar las fuentes XML, se utiliza [[http://simplepie.org/|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 [[doku>config:htmlok|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 }}
{{rss>http://slashdot.org/index.rss 5 author date 1h }}
===== Macros de control =====
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 %%%% de más arriba), añadir esta macro forzará a DokuWiki a generar la página cada vez que se llame. |
===== Complementos de Sintaxis =====
La sintaxis de DokuWiki puede extenderse con [[doku>plugins|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:
~~INFO:syntaxplugins~~