Sintaxis de Wiki

DokuWiki soporta lenguaje markup simple, que intenta hacer que el código fuenete DokuWiki sea tan legible como sea posible. Esta página contiene todas las sintaxis posibles que puedes utilizar para editar las páginas de la Wiki de Texto-plano. Simplemente hecha un vistazo al código fuente de la página presionando “Edit this page”. Si deseas probar algo, usa la página playground. Los atributos de marcado son fácilmente accesibles con los quickbuttons.

DokuWiki soporta textos en negrita, cursiva, subrayado y monoespacio. Por supuesto podrás combinar todos ellos.

DokuWiki soporta textos en **negrita**, //cursiva//, subrayado y ''monoespacio''.
Por supuesto podrás  **__//''combinar''//__** todos ellos.

Podrás utilizar _subscriptos and ^{superscriptos}, sin problmeas.

Podrás utilizar <sub>subscriptos</sub> and <sup>superscriptos</sup>, sin problmeas.

Puedes marcar algo como borrado en caso de necesitarlo.

Puedes marcar algo como <del>borrado</del> en caso de necesitarlo.

Los Párrafos se crean a partir de líneas en blanco. Si deseas forzar una línea nueva sin crear un párrafo, puedes usar dos barras invertidas seguidas por un espacio en blanco para dar por finalizada una línea.

Este es un texto con algunas líneas de corte
Ten presente que las dos barras invertidas sólo son reconocidas al final de la línea
o si están seguidas por un espacio en blanco\\. \\esto sucede si no lo hay.

Puedes marcar algo como <del>borrado</del> en caso de necesitarlo.
las dos barras invertidas sólo son reconocidas al final de la línea\\
o si están seguidas por un espacio en blanco\\. \\esto sucede si no lo hay.

Sólo deberías usar nuevas líneas forzadas si realmente las necesitas.

DokuWiki soporta múltiples formaas de crear enlaces hipertextuales.

Los enlaces externos son reconocidos automáticamente: https://texto-plano.xyz o simplemente texto-plano.xyz - Podrás también utilizar un enlace textual también: Esto dirige a texto-plano.xyz. Las direcciones de correo electrónico se indican así: fulana@texto-plano.xyz.

o si están seguidas por un espacio en blanco\\. \\esto sucede si no lo hay.
https://texto-plano.xyz o simplemente texto-plano.xyz - Podrás también utilizar un enlace textual
también: [[https://texto-plano.xyz|Esto dirige a texto-plano.xyz]]. 
Las direcciones de correo electrónico se indican así: <fulana@texto-plano.xyz>.

Los enlaces internos se crean usando doble corchete. Puedes usar un nombre o usar un texto de enlace adicional.

Los enlaces internos se crean usando doble corchete.
Puedes usar un [[nombre]] o usar un  [[nombre|texto de enlace]] adicional.

Los nombres Wiki son automáticamente convertidos a minúscula, y no se permiten caracteres especiales.

Puedes usar namespaces usando un : en el pagename.

Puedes usar [[some:namespaces]] usando un : en el pagename.

Para mayores detalles sobre los nombres de página de Wiki consulta namespaces.

Te será posible enlazar a una sección específica. Simplemente agrega la sección deseada detrás de un caracter numeral, tal como se usa en HTML.

Esto enlaza a esta Sección.

Esto enlaza a [[sintaxis_de_wiki#interno|esta sección]].

Notas:

• Los enlaces a páginas existentes se mostrarán de un estilo diferente a los enlaces no existentes.
• DokuWiki no usa CamelCase para crear enlaces automáticamente por defecto, pero puede activarse este comportamiento en el fichero config. Ayuda: Si DokuWiki es un enlace, entonces está activado.
• Cuando cambias el titulado de sección, lo enlaces de los marcadores lo harán también. No dependas demasiado del enlaces de sección.

DokuWiki soporta enlaces Interwiki. Estos son enlaces rápidos a otras Wikis. Por ejemplo, este es un enlace a la página de Wikipedia's sobre las Wikis: Wiki.

DokuWiki soporta enlaces [[doku>Interwiki]]. Estos son enlaces rápidos a otras Wikis.
Por ejemplo, este es un enlace a la página de Wikipedia's sobre las Wikis: [[wp>Wiki]].

Windows shares like this are recognized, too. Please note that these only make sense in a homogeneous user group like a corporate Intranet.

Windows Shares like [[\\server\share|this]] are recognized, too.

Notes:

• For security reasons direct browsing of windows shares only works in Microsoft Internet Explorer per default (and only in the “local zone”).
• For Mozilla and Firefox it can be enabled through different workaround mentioned in the Mozilla Knowledge Base. However, there will still be a JavaScript warning about trying to open a Windows Share. To remove this warning (for all users), put the following line in conf/lang/en/lang.php (more details at localization):

  conf/lang/en/lang.php

  <?php
  /**
   * Customization of the english language file
   * Copy only the strings that needs to be modified
   */
  $lang['js']['nosmblinks'] = '';

Podrás también usar una imagen para enlazar a otra página interna o externa combinando la sintaxis para los enlaces y imagenes (ver a continuación) de la siguiente manera:

[[http://php.net|{{wiki:dokuwiki-128.png}}]]

Por favor ten en cuenta: Sólo se acepta el formato de la imagen como única sintaxis de formato aceptada en los nombres de los enlaces.

Esta sintaxis de imagen y enlace está soportada (incluyendo redimensionado de imágen, imagenes internas y externas y URLs y enlaces interwiki).

Puedes agregar notas al pie ¹⁾ usando doble paréntesis.

Puedes agregar notas al pie ((Esta es una nota al pie)) usando doble paréntesis.

Puedes usar hasta cinco niveles de títulos diferentes para encabezados y estructurar tu contenido en secciones. Si dispones más de tres encabezados, automáticamente se generará una tabla de contenidos – podrás desactivar esta creación automática si incluyes la cadena ~~NOTOC~~ en cualquier parte del documento..

==== Título de Nivel 3 ====
=== Título de Nivel 4 ===
== Título de Nivel 5 ==

Usando cuatro o más “-” podráz trazar una línea horizontal:

Podrás incluir ficheros de imágenes, videos y audio tanto internos como externos utilizando llaves. Opcionalmente podrás especificar su tamaño.

Tamaño reañ:

Redimensionado a un ancho determinado:

Redimensiona para presentar un ancho y alto ²⁾:

Imagen externa redimiensionada:

Tamaño real:                        {{wiki:dokuwiki-128.png}}
Redimensionar a un ancho dado:            {{wiki:dokuwiki-128.png?50}}
Redimensionar a un alto dado: {{wiki:dokuwiki-128.png?200x50}}
Imagen externa redimensionada:           {{https://secure.php.net/images/php.gif?200x50}}

Utilizando un espacio en blanco a izquierda o derecha podrás escoger su alineación.

{{ wiki:dokuwiki-128.png}}
{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png }}

Por supuesto, también podrás agregar un título (presentado como una notifficación de herramienta en la mayoría de los navegadores).

{{ wiki:dokuwiki-128.png |Esta es la descripción}}

Para enlazar una imagen a otra página consulte Enlaces de imagenes arriba.

DokuWiki puede recibir incrustaciones de los siguientes ficheros de medios.

Si el nombre de fichero especificado no es un archivo de medios en uso, en su lugar aparecerá su enlace.

Al agregar ?linkonly podrás proveer un enlace simple al archivo de medios sin mostrarlo directamente en línea

{{wiki:dokuwiki-128.png?linkonly}}

dokuwiki-128.png Esto es sólo un enlace a la imagen.

Lamentablemente no todos los navegadores web entienden todos los formatos de audio o video. Para mitigar este problema, podrás cargar tu fichero en un formato diferente para maximizar la compatibilidad del navegador.

Por ejemplo considera este video incrustado mp4:

{{video.mp4|Un video divertido}}

Cuando cargues un video.webm y video.ogv a continuación del video.mp4 referenciado, DokuWiki los agregará automáticamente como versiones alternativas de modo que si uno de los tres ficheros es entendido por tu navegador, pueda presentarse en su lugar.

Adicionalmente, DokuWiki dará uso a una imagen “poster” la cual se mostrará antes de que el video inicie. Esta imagen necesita tener el mismo nombre de fichero que el video y ser un fichero jpg o png. En el ejemplo anterior, funcionaría con un fichero video.jpg.

Dokuwiki soporta lístas ordenadas y no ordenadas. Para crear un ítem de lista, sangra tu texto con dos espacios y emplea un * para las líneas no ordenadas o un - para las listas ordenadas.

• Esto es una lista
• Este es el segundo ítem
  • Puedes usar diferentes niveles
• Otro ítem

1. Esta es la misma lista pero ordenada
2. Otro ítem
   1. Simplemente sangra con dos espacios mas para agregar otro nivel.
3. ¡Es simple!

  * Esto es una lista
  * Este es el segundo ítem
    * Puedes usar diferentes niveles
  * Otro ítem

  - Esta es la misma lista pero ordenada
  - Otro ítem
    - Simplemente sangra con dos espacios mas para agregar otro nivel.
  - ¡Es simple!

Hecha un vistazo también a las Preguntas Frecuentes de las listas de ítems.

DokuWiki puede convertir ciertos caracteres predefinidos o cadenas en imagenes y otro texto u HTML.

Las conversiones de imagen a texto son realizadas fundamentalmente para los smileys. Y la conversión de texto a HTML se usa para reemplazar su tipografía, pero también puede configurarse para usar otro HTML también.

DokuWiki convierte emoticones comunes a su equivalencia gráfica. Tales Smileys y otras imágenes pueden ser configuradas y extendidas. He aquí una lista de los Smileys incluidos en DokuWiki:

• 8-)
• 8-O
• :-(
• :-)
• =)
• :-/
• :-\
• :-?
• :-D
• :-P
• :-O
• :-X
• :-|
• ;-)
• ^_^
• m(
• :?:
• :!:
• LOL
• FIXME
• DELETEME

Tipografía: DokuWiki puede conveertir caracteres de texto simple a sus entidades tipográficamente correctas. He aquí un ejemplo de caracteres reconocidos.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “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 tipo de código HTML, sólo necesita agregarse al fichero patrón.

Existen tres excepciones que no provienen de dicho fichero patrón: la entidad de multiplicación (640×480), comillas 'simples' y “sobles”. Estas pueden desactivarse a ttravés de una opción de configuración.

Algunas veces querrás marcar algun texto como una cita o una contestación a otro comentario. Puedes usar la siguiente sintaxis:

Creo que deberías compartir tu software

> No, no deberíamos

>> Bueno, le haré ingeniería inversa.

> ¿En serio?

>> ¡Si!

>>> ¡Entonces liberemos el código!

Creo que deberías compartir tu software

No, no deberíamos

Bueno, le haré ingeniería inversa.

¿En serio?

¡Si!

¡Entonces liberemos el código!

DokuWiki soporta una sintaxis simple para creación de tablas.

Las filas de la Tabla deben comenzar y finalizar con un | en las filas normales o un ^ para los encabezados de tabla.

^ Encabezado 1    ^ Encabezado 2     ^ Encabezado 3           ^
| Fila 1 Col 1    | Fila 1 Col 2     | Fila 1 Col 3           |
| Fila 2 Col 1    | Algún espacio libre (note el doble caño) ||
| Fila 3 Col 1    | Fila 3 Col 2     | Fila 3 Col 3           |

Para conectar las celdas horizontalmente, simplementee haga que la siguiente celda esté completamente vacía como se muestra arriba. ¡Asegúrate de contar siempre con la misma cantidad de separadores de celdas!

Es posible usar encabezados de tabla vertical también.

Como puedes ver, el hecho de que el separador de celda esté antes de una celda lo que decide su formato:

|                 ^ Encabezado 1         ^ Encabezado 2       ^
^ Encabezado 3    | Fila 1 Col 2         | Fila 1 Col 3       |
^ Encabezado 4    | sin columna esta ves |                    |
^ Encabezado 5    | Fila 2 Col 2         | Fila 2 Col 3       |

Podrás tener celdas unidas (celdas conectadas verticalmente) agregando la cadena ::: a la celda por debajo de la que quieres conectar.

Aparte de la sintaxis de unión de celdas, estas no pueden contener nada mas.

^ Encabezado 1   ^ Encabezado 2                    ^ Encabezado 3    ^
| Fila 1 Col 1   | esta celda se une verticalmente | Fila 1 Col 3    |
| Fila 2 Col 1   | :::                             | Fila 2 Col 3    |
| Fila 3 Col 1   | :::                             | Fila 2 Col 3    |

Podrás alinear los contenidos de la tabla también. Simplemente agrega al menos dos espacios en blanco en el final opuesto de tu texto: agrega dos espacios a la izquierda para alinear a la derecha, o agrega dos espacios a la derecha para alinear a la izquierda. Agregar al menos dos espacios a izquierda y derecha producirá un texto de alineado centralizado.

Este es el aspecto que tiene su código fuente de la tabla:

^           Tabla con alineado             ^^^
|       derecha|    centro    |izquierda     |
|izquierda     |       derecha|    centro    |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Nota: La alineación vertical no está soportada.

Si necesitas presentar un texto exactamente como está tipeado (sin que se interprete o produzca ningún formato), cierra el área tanto con una etiqueta <nowiki> o más fácil, con signos de porcentaje doble %%.

Este es un texto que contiene direcciones como esta: https://texto-plano.xyz y **formato**, pero no será interpretado como tal. Lo mismo es válido para //__este__ texto// con un smiley ;-).

<nowiki>
Este es un texto que contiene direcciones como esta: https://texto-plano.xyz y **formato**, pero no será interpretado como tal.
</nowiki>
Lo mismo es válido para %%//__este__ texto// con un smiley ;-)%%.

Podrás incluir bloques de código fuente a tus documentos tanto sangrándolos con al menos dos espacios en blanco (como en los ejemplos previos) o utilizando las equiquetas <code> o <file>.

Este texto está sangrado dos espacios.

En este código preformateado se mantienen todos los espacioes como:              <-esto

Esto es similar, pero podrás ver que has denotado un fichero.

Estos bloques de código han sido generados con este código:

  Este texto está sangrado dos espacios.

<code>
En este código preformateado se mantienen todos los espacioes como:              <-esto
</code>

<file>
Esto es similar, pero podrás ver que has denotado un fichero.
</file>

DokuWiki puede resaltar código fuente de programación, lo que lo hace más fácil de leer. Utiliza el GeSHi Resaltador de Sintaxis Genérico – de manera que cualquier lenguaje de programación registrado en GeSHi puede ser interpretado. La sintaxis utiliza el mismo código y bloques de fichero descriptos en la sección previa, pero esta vez el nombre del lenguaje de programación a resaltar debe incluirse en la equiqueta, por ejemplo: <code java> o <file java>.

/**
 * La clase HolaTextoPlanoApp implementa una aplicación que
 * simplemente presenta "Hola Texto-Plano.xyz" en la salida estándar.
 */
class HolaTextoPlanoApp {
    public static void main(String[] args) {
        System.out.println("Hola Texto-Plano.xyz!"); //Presenta la cadena.
    }
}

Actualmente se reconocen las siguientes cadenas de lenguajes: 4cs 6502acme 6502kickass 6502tasm 68000devpac abap actionscript3 actionscript ada aimms algol68 apache applescript apt_sources arm asm asp asymptote autoconf autohotkey autoit avisynth awk bascomavr bash basic4gl batch bf biblatex bibtex blitzbasic bnf boo caddcl cadlisp ceylon cfdg cfm chaiscript chapel cil c_loadrunner clojure c_mac cmake cobol coffeescript c cpp cpp-qt cpp-winapi csharp css cuesheet c_winapi dart dcl dcpu16 dcs delphi diff div dos dot d ecmascript eiffel email epc e erlang euphoria ezt f1 falcon fo fortran freebasic freeswitch fsharp gambas gdb genero genie gettext glsl gml gnuplot go groovy gwbasic haskell haxe hicest hq9plus html html4strict html5 icon idl ini inno intercal io ispfpanel java5 java javascript jcl j jquery julia kixtart klonec klonecpp kotlin latex lb ldif lisp llvm locobasic logtalk lolcode lotusformulas lotusscript lscript lsl2 lua m68k magiksf make mapbasic mathematica matlab mercury metapost mirc mk-61 mmix modula2 modula3 mpasm mxml mysql nagios netrexx newlisp nginx nimrod nsis oberon2 objc objeck ocaml-brief ocaml octave oobas oorexx oracle11 oracle8 oxygene oz parasail parigp pascal pcre perl6 perl per pf phix php-brief php pic16 pike pixelbender pli plsql postgresql postscript povray powerbuilder powershell proftpd progress prolog properties providex purebasic pycon pys60 python qbasic qml q racket rails rbs rebol reg rexx robots roff rpmspec rsplus ruby rust sas sass scala scheme scilab scl sdlbasic smalltalk smarty spark sparql sql sshconfig standardml stonescript swift systemverilog tclegg tcl teraterm texgraph text thinbasic tsql twig typoscript unicon upc urbi uscript vala vbnet vb vbscript vedit verilog vhdl vim visualfoxpro visualprolog whitespace whois winbatch wolfram xbasic xml xojo xorg_conf xpp yaml z80 zxbasic

Existen opciones avanzadas adicionales disponibles para el resaltado de syntaxis, tales como resaltado de líneas o agregar números de línea.

Cuando uses la sintaxis <code> o <file> como se indicó anteriormente, podrías querer que también sea presentado con un indicativo que lo deje disponible para descargarlo. Podrás hacerlo si le especificas un nombre de fichero de la siguiente manera:

<file php miejemplo.php>
<?php echo "hola texto-plano!"; ?>
</file>

miejemplo.php

<?php echo "hola texto-plano!"; ?>

Si no deseas ningún resaltado de sintaxis pero deseas establecer que el fichero quede disponible para su descarga, debes indicarlo con un guión medio (-) como variable de la etiqueta code, de la siguiente forma: <code - micódigo.foo>.

You can embed raw HTML or PHP code into your documents by using the <html> or <php> tags. (Use uppercase tags if you need to enclose block level elements.)

HTML example:

<html>
This is some <span style="color:red;font-size:150%;">inline HTML</span>
</html>
<HTML>
<p style="border:2px dashed red;">And this is some block HTML</p>
</HTML>

This is some <span style="color:red;font-size:150%;">inline HTML</span>

<p style="border:2px dashed red;">And this is some block HTML</p>

PHP example:

<php>
echo 'The PHP version: ';
echo phpversion();
echo ' (generated inline HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td>'.phpversion().'</td>';
echo '</tr></table>';
</PHP>

echo 'The PHP version: '; echo phpversion(); echo ' (inline HTML)';

echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td>'.phpversion().'</td>';
echo '</tr></table>';

Please Note: HTML and PHP embedding is disabled by default in the configuration. If disabled, the code is displayed instead of executed.

DokuWiki can integrate data from external XML feeds. For parsing the XML feeds, SimplePie is used. All formats understood by SimplePie can be used in DokuWiki as well. You can influence the rendering by multiple additional space separated parameters:

The refresh period defaults to 4 hours. Any value below 10 minutes will be treated as 10 minutes. DokuWiki will generally try to supply a cached version of a page, obviously this is inappropriate when the page contains dynamic external content. The parameter tells DokuWiki to re-render the page if it is more than refresh period since the page was last rendered.

By default the feed will be sorted by date, newest items first. You can sort it by oldest first using the reverse parameter, or display the feed as is with nosort.

Example:

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

Some syntax influences how DokuWiki renders a page without creating any output it self. The following control macros are availble:

DokuWiki's syntax can be extended by Plugins. How the installed plugins are used is described on their appropriate description pages. The following syntax plugins are available in this particular DokuWiki installation:

• Info Plugin 2020-06-04 por Andreas Gohr
  Displays information about various DokuWiki internals