[[Sintaxis para la edición]]
 
Traza: • Sintaxis para la edición
Estás aquí: Foros-Fiuba Wiki » wiki » Sintaxis para la edición
Tabla de Contenidos

Sintaxis para la edición

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. La edición de texto también puede hacerse a través de los 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>subíndices</sub> y <sup>superíndices</sup>.

Además, podés marcar ítems como eliminados. 

Además, podés marcar ítems como <del>eliminados</del>.

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: Este es un link a google. Las direcciones de mail escritas de esta manera: andi@splitbrain.org, 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: <andi@splitbrain.org>, 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: wiki:pagename, o podés utilizar una palabra o frase: 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 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 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 esta sección. 

Este link es a [[syntax_english#internal|esta sección]].

Notas:

  • Links dirigidos a páginas existentes se muestran en un estilo diferente a los dirigidos a páginas no existentes.
  • DokuWiki no utiliza por default CamelCase para crear links, pero esta característica puede ser habilitada desde el archivo 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 Interwiki, que son enlaces rápidos a otros Wikis. Por ejemplo, este es un link a una página sobre Wikis de Wikipedia: 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 este. Tené en cuenta que esto sólo tandrá sentido dentro de un grupo de usuarios homogéneo, como en la 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 security.checkloaduri, pero esto se desrecomienda.
  • Consultá el 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 imágenes así: 

[[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 imágenes y 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 1) 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 imágenes internas o externas usando llaves 2). Tenés además la opción de especificar el tamaño de las imágenes que incluyas.

Tamaño real:

Imagen ajustada a lo ancho:

Imagen ajustada a lo ancho y a lo alto:

Imagen externa con su tamaño ajustado: 

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 }}

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.

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 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.
  1. La misma lista pero ordenada.
  2. Otro ítem
    1. Identá otros dos espacios para conseguir más niveles.
  3. 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 emoticones 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:

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “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 config option y un 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 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. <code java>. 

/** 
 * 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í: 

<html>
Esto es <font color="red" size="+1">HTML</font>
</html>

Esto es <font color="red" size="+1">HTML</font> 

<php>
echo 'Logo generado por PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
</php>

echo 'Logo generado por PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="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 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:

1) Esto es una nota al pie
2) Las llaves son estas: {}
wiki/syntax.txt · Última modificación: 2011/10/30 18:11 por santisis
 
Excepto donde se indique lo contrario, el contenido de esta wiki se autoriza bajo la siguiente licencia: CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki