====== Sintaxis para la edición ====== [[wiki:DokuWiki]] te permite dar formato a tu artículo para hacerlo lo más atractivo y fácil de leer posible. En esta página vas a encontrar la sintaxis para todas las opciones de edición disponibles. Podés echarle un vistazo a la fuente de la página presionado el botón //Ver fuente// Si querés probar algo, hacelo en el [[playground:playground|playground]]. La edición de texto también puede hacerse a través de los [[doku>wiki:quickbuttons|quickbuttons]]. ===== Formato de texto básico ===== Con Dokuwiki podés usar **negritas**, //cursivas//, __subrayado__ y texto ''monoespaciado''. Por supuesto, también podés **__//''combinar''//__** todas estas cosas. Con Dokuwiki podés usar **negritas**, //cursivas//, __subrayado__ y texto ''monoespaciado''. Por supuesto, también podés **__//''combinar''//__**todas estas cosas. Podés usar subíndices y superíndices. Podés usar subíndices y superíndices. Además, podés marcar ítems como eliminados. Además, podés marcar ítems como eliminados. Las líneas en blanco generan **párrafos**. Si querés **forzar una nueva línea de texto** sin que esto de lugar a párrafo, podés hacerlo utilizando dos barras invertidas seguidas de un espacio en blanco al final de la línea. En este texto se han forzado saltos de línea.\\ Notá que las barras invertidas sólo son reconocidas si están al final de una línea \\ o seguidas\\ de un espacio en blanco.\\Esto es lo que sucede //sin// el espacio en blanco. En este texto se han forzado saltos de línea.\\ Notá que las barras invertidas sólo son reconocidas si están al final de una línea \\ o seguidas\\ de un espacio en blanco.\\Esto es lo que sucede //sin// el espacio en blanco. Deberías forzar estos saltos de línea sólo cuando sea realmente necesario. ===== Links ===== Existen muchas maneras de crear links en Dokuwiki. ==== Links externos ==== Los links externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com - También podés establecer una palabra o frase como link: [[http://www.google.com|Este es un link a google]]. Las direcciones de mail escritas de esta manera: , también se reconocen automáticamente. Los links externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com - También podés establecer una palabra o frase como link: [http://www.google.com|Este es un link a google]]. Las direcciones de mail escritas de esta manera: , también se reconocen automáticamente. ==== Links internos ==== Los links internos se crean mediante corchetes. Como en el caso anterior, tenés dos opciones. Podés simplemente usar el nombre de la página como link: [[doku>wiki:pagename]], o podés utilizar una palabra o frase: [[doku>wiki:pagename|Título apropiado]]. Los nombres de páginas en Wiki son automáticamente convertidos en minúsculas y no están permitidos caracteres especiales. Los links internos se crean mediante corchetes. Como en el caso anterior, tenés dos opciones. Podés simplemente usar el nombre de la página como link: [[doku>wiki:pagename]], o podés utilizar una palabra o frase: [[doku>wiki:pagename|Título apropiado]]. Los nombres de páginas en Wiki son automáticamente convertidos en minúsculas y no están permitidos caracteres especiales. Podés utilizar [[wiki:namespaces]] colocando dos puntos antes del nombre de la página. Podés utilizar [[wiki:namespaces]] colocando dos puntos antes del nombre de la página. Para más detalles acerca de namespaces, podés consultar [[doku>wiki:namespaces]]. También podés establecer un link a una sección específica. Simplemente, colocá numeral (#) antes del nombre de la sección. Este link es a [[syntax_english#internal|esta sección]]. Este link es a [[syntax_english#internal|esta sección]]. Notas: * Links dirigidos a [[syntax_english|páginas existentes]] se muestran en un estilo diferente a los dirigidos a [[wiki:páginas no existentes]]. * DokuWiki no utiliza por default [[wp>CamelCase]] para crear links, pero esta característica puede ser habilitada desde el archivo [[doku>config]]. Un indicio: Si DokuWiki aparece como link, está activada. * Cuando se cambia el título de una sección, también cambia el marcador correspondiente, por lo que no deberías confiar demasiado en los links a secciones. ==== Interwiki ==== DokuWiki te permite establecer links [[doku>wiki:interwiki|Interwiki]], que son enlaces rápidos a otros Wikis. Por ejemplo, este es un link a una página sobre Wikis de Wikipedia: [[wp>Wiki]]. DokuWiki te permite establecer links [[doku>wiki:interwiki|Interwiki]], que son enlaces rápidos a otros Wikis. Por ejemplo, este es un link a una página sobre Wikis de Wikipedia: [[wp>Wiki]]. ==== Documentos compartidos ==== Dokuwiki reconoce los documentos compartidos como [[\\server\share|este]]. Tené en cuenta que esto sólo tandrá sentido dentro de un grupo de usuarios homogéneo, como en la [[wp>Intranet]] de una empresa. Dokuwiki reconoce los documentos compartidos como [[\\server\share|este]] Notas: * Por razones de seguridad, la navegación directa de documentos compartidos es, por default, únicamente posible con Microsoft Internet Explorer (y sólo en la "zona local"). * Puede cambiarse la configuración para que sea posible utilizar Mozilla y Firefox desde [[http://www.mozilla.org/quality/networking/docs/netprefs.html#file|security.checkloaduri]], pero esto se desrecomienda. * Consultá el bug [[bug>151]] para más información. ==== Imágenes como links ==== Es posible usar una imagen como link a una página interna o externa, combinando la sintaxis para links e [[#images_and_other_files|imágenes]] así: [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] [[http://www.php.net|{{wiki:dokuwiki-128.png}}]] Importante: Al establecer un link, sólo es admisible la sintaxis para formato //de imágenes//. Todas las combinaciones de sintaxis para [[#images_and_other_files|imágenes]] y [[#links|links]] son posibles (es decir, redimensionamiento de la imagen, imágenes internas y externas, y links URL e interwiki). ===== Notas al pie ===== Podés insertar una nota al pie ((Esto es una nota al pie)) colocando doble paréntesis. Podés insertar una nota al pie ((Esto es una nota al pie)) colocando doble paréntesis. ===== Secciones ===== Para estructurar tu artículo, disponés de cinco niveles de títulos. Si usás más de tres títulos, se genera automáticamente una tabla de contenidos, la cual podés desactivar incluyendo en el documento el string ''~~NOTOC~~''. ==== Título Nivel 3 ==== === Título Nivel 4 === == Título Nivel 5 == ==== Título Nivel 3 ==== === Título Nivel 4 === == Título Nivel 5 == Podés hacer una línea horizontal colocando dos o más guiones seguidos: ---- ===== Imágenes y otros archivos ===== Podés incluir [[doku>images|imágenes]] internas o externas usando llaves ((Las llaves son estas: {})). Tenés además la opción de especificar el tamaño de las imágenes que incluyas. Tamaño real: {{wiki:dokuwiki-128.png}} Imagen ajustada a lo ancho: {{wiki:dokuwiki-128.png?50}} Imagen ajustada a lo ancho y a lo alto: {{wiki:dokuwiki-128.png?200x50}} Imagen externa con su tamaño ajustado: {{http://de3.php.net/images/php.gif?200x50}} Tamaño real: {{wiki:dokuwiki-128.png}} Ajustada a lo ancho: {{wiki:dokuwiki-128.png?50}} Ajustada a lo ancho y a lo alto: {{wiki:dokuwiki-128.png?200x50}} Imagen externa con su tamaño ajustado: {{http://de3.php.net/images/php.gif?200x50}} Colocando espacios en blanco a la izquierda o la derecha, ajustás la alineación. {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png}} {{wiki:dokuwiki-128.png }} {{ wiki:dokuwiki-128.png }} Desde luego, también podés agregarle un título a la imagen. La mayoría de los navegadores lo van a mostrar como un pequeño pop-up al posicionar el mouse sobre ella. {{ wiki:dokuwiki-128.png |This is the caption}} {{ wiki:dokuwiki-128.png |This is the caption}} Si colocás entre llaves el nombre de un archivo (externo o interno) que de imagen (''.gif,.jpeg,.png''), será mostrado como un link. Para ver cómo usar una imagen como link, consultá la sección [[syntax_english#image links|Imágenes como links]] más arriba. ===== Listas ===== Dokuwiki permite crear listas, que pueden ser ordenadas (numeradas) o no. Para generar una lista de ítems, identá el texto dos espacios y colocá un asterisco, si querés una lista no ordenada, o un guión alto, si querés una lista ordenada. * Esto es una lista. * Segundo ítem. * La lista puede tener distintos niveles. * Otro ítem. - La misma lista pero ordenada. - Otro ítem - Identá otros dos espacios para conseguir más niveles. - Eso es todo. * Esto es una lista. * Segundo ítem. * La lista puede tener distintos niveles. * Otro ítem. - La misma lista pero ordenada. - Otro ítem - Identá otros dos espacios para conseguir más niveles. - Eso es todo. ===== Smileys ===== DokuWiki transforma los [[wp>emoticon]]es usados habitualmente en su equivalente gráfico. Se pueden colocar más emoticones en el directory ''smiley'' y configurarlos en el archivo ''conf/smileys.conf''. Los smileys incluídos en DokuWiki son estos: * 8-) %% 8-) %% * 8-O %% 8-O %% * :-( %% :-( %% * :-) %% :-) %% * =) %% =) %% * :-/ %% :-/ %% * :-\ %% :-\ %% * :-? %% :-? %% * :-D %% :-D %% * :-P %% :-P %% * :-O %% :-O %% * :-X %% :-X %% * :-| %% :-| %% * ;-) %% ;-) %% * ^_^ %% ^_^ %% * :?: %% :?: %% * :!: %% :!: %% * LOL %% LOL %% * FIXME %% FIXME %% * DELETEME %% DELETEME %% ===== Tipografía ===== [[DokuWiki]] transforma caracteres de texto comunes en la entidad tipográficamente correcta que corresponda. Por ejemplo: -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." -> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) "He thought 'It's a man's world'..." Esta característica puede desactivarse mediante una [[doku>wiki:config#typography|config option]] y un [[doku>wiki:entities|pattern file]]. ===== Citas ===== Tal vez quieras enfatizar que un texto es un comentario o una respuesta a otro comentario. Para hacerlo, usá la siguiente sintaxis: Creo que deberíamos hacerlo. > Yo creo que no. >> Bueno, yo digo que sí. > ¿En serio? >> ¡Sí! >>> ¡Entonces hagámoslo! Creo que deberíamos hacerlo. > No me parece. >> Bueno, a mí sí. > ¿Sí? >> ¡Sí! >>> ¡Entonces hagámoslo! ===== Tablas ===== DokuWiki posee una sintaxis muy simple para generar tablas. ^ Encabezado 1 ^ Encabezado 2 ^ Encabezado 3 ^ | Fila 1 Col 1 | Fila 1 Col 2 | Fila 1 Col 3 | | Fila 2 Col 1 | salteo una columna (atención que ahora van dos pipes) || | Fila 3 Col 1 | Fila 2 Col 2 | Fila 2 Col 3 | Las filas de una tabla deben comenzar y terminar con ''|'' en caso de ser filas comunes, y con ''^'' si son encabezados. ^ Encabezado 1 ^ Encabezado 2 ^ Encabezado 3 ^ | Fila 1 Col 1 | Fila 1 Col 2 | Fila 1 Col 3 | | Fila 2 Col 1 | salteo una columna (atención que ahora van dos pipes) || | Fila 3 Col 1 | Fila 2 Col 2 | Fila 2 Col 3 | Para concatenar dos celdas horizontalmente, simplemente se deja una vacía como muestra el ejemplo (podés anexar varias, no sólo dos). Tené en cuenta que hay que poner siempre la misma cantidad de separadores. También son posibles los encabezados verticales. | ^ Encabezado 1 ^ Encabezado 2 ^ ^ Encabezado 3 | Fila 1 Col 2 | Fila 1 Col 3 | ^ Encabezado 4 | ahora no salteo columna | | ^ Encabezado 5 | Fila 2 Col 2 | Fila 2 Col 3 | Como podés ver en este ejemplo, el formato de la celda está determinado por el separador que la precede: | ^ Encabezado 1 ^ Encabezado 2 ^ ^ Encabezado 3 | Fila 1 Col 2 | Fila 1 Col 3 | ^ Encabezado 4 | ahora no salteo columna | | ^ Encabezado 5 | Fila 2 Col 2 | Fila 2 Col 3 | Atención: No se pueden anexar celdas verticalmente. Para alinear el contenido de la celda, colocá dos o más espacios en blanco en el extremo opuesto del texto; por ejemplo, dos espacios en blanco a la derecha, lo alinean a la izquierda. Para que quede centrado, colocá al menos dos espacios en blanco en cada extremo del texto. ^ Tabla con alineación ^^^ | derecha| centrada |izquierda | |izquierda | derecha| centrada | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | Así quedaría el código: ^ Tabla con alineación ^^^ | derecha| centrada |izquierda | |izquierda | derecha| centrada | | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx | ===== Bloques no procesados ===== Podés incluir en tus documentos bloques con texto no procesado; simplemente, identalo al menos dos espacios (como en los ejemplos previos) o colocá los tags ''code'' o ''file''. Esto es código preformateado, se conservan todos los espacios: <-así. Esto es más o menos lo mismo pero podrías usarlo para denotar que estás citando un archivo. Para que el procesador ignore un área completa (ie. no le de formato), encerrá el área con tags ''nowiki'' o más sencillamente, con doble signo percentil ''%%''. Acá pongo la dirección de una página web: http://www.splitbrain.org y **símbolos para negritas**, pero no son reconocidos. Mirá el código de esta página para ver cómo se usan estos bloqueos. ===== Resaltador de sintaxis de código fuente ===== [[DokuWiki]] puede resaltar la sintaxis de un código fuente, haciéndolo más fácil de leer. Usa [[http://qbnz.com/highlighter/|GeSHi]] Generic Syntax Highlighter -- por lo que reconoce cualquier lenguaje reconocido por GeSHi. La sintaxis es la misma que en los bloques de texto no procesados de la sección anterior pero insertando en los tags el nombre del lenguaje que corresponda. Ej. ''''. /** * 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. } } Actualmente, reconoce los siguientes lenguajes: //actionscript, actionscript-french, ada, apache, applescript, asm, asp, autoit, bash, blitzbasic, caddcl, cadlisp, c, c_mac, cfm, cpp, csharp, css, delphi, diff, d, div, dos, eiffel, freebasic, gml, html4strict, ini, inno, java, java5, javascript, lisp, lua, matlab, mpasm, mysql, nsis, objc, ocaml, ocaml-brief, oobas, oracle8, pascal, perl, php-brief, php, python, qbasic, scheme, sdlbasic, smarty, sql, tsql, robots, ruby, vb, vbnet, vhdl, visualfoxpro, xml// ===== Embeber HTML y PHP ===== Podés embeber código HTML o PHP en bruto en tus documentos, colocando los tags ''html'' o ''php'' así: Esto es HTML Esto es HTML echo 'Logo generado por PHP:'; echo 'PHP Logo !'; echo 'Logo generado por PHP:'; echo 'PHP Logo !'; **Atención**: el embebido de HTML y PHP viene desactivado por default en la configuración. Estando desactivada esta característica, el código se muestra en lugar de ejecutarse. ===== Plugins ===== La sintaxis de DokuWiki puede extenderse mediante [[doku>wiki:plugins|Plugins]] apropiados. La información sobre cómo se usan los plugins instalados, se encuentra en las páginas correspondientes. Los plugins disponibles en esta versión de DokuWiki en particular son: ~~INFO:syntaxplugins~~