¡Esta es una revisión vieja del documento!


Sintaxis de Formato

DokuWiki soporta un lenguaje de marcas simple, que intenta hacer los ficheros de datos tan legibles como sea posible. Esta página contiene todas las posibles opciones que puedes usar a la hora de editar las páginas. Simplemente, observa el código de esta página pulsando sobre Editar esta página en la parte superior y en la parte inferior de la página. Si quieres intentar algo, usa la página de pruebas. Las marcas más simples también se encuentran accesibles mediante toolbar.

Formato básico de texto

DokuWiki soporta negritas, cursivas, subrayados y texto monoespaciado. Por supuesto, puedes combinarlos todos.

DokuWiki soporta **negritas**, //cursivas//, __subrayados__ y texto ''monoespaciado''. 
Por supuesto, puedes **__//''combinarlos''//__** todos.

También puedes usar subíndices y superíndices.

También puedes usar <sub>subíndices</sub> y <sup>superíndices</sup>.

Del mismo modo, también puedes marcar algo como borrado.

Del mismo modo, también puedes marcar algo como <del>borrado</del>.

Los párrafos se crean a partir de líneas en blanco. Si quieres forzar un salto de línea sin un párrafo, puedes usar dos barras invertidas seguidas por un espacio en blanco o el final de la línea.

Esto es un texto con algunos saltos de línea.
Advierte que las dos barras invertidas son reconocidas solamente al final de una línea
o cuando están seguidas de
un espacio en blanco \\Esto sucede sin él.

Esto es un texto con algunos saltos de línea.\\ Advierte que las 
dos barras invertidas son reconocidas solamente al final de una línea\\
o cuando están seguidas de\\ un espacio en blanco \\Esto sucede sin él.

Solamente deberías forzar saltos de línea cuando realmente lo necesites.

Enlaces

DokuWiki soporta múltiples formas de crear enlaces.

Externos

Los enlaces externos se reconocen automáticamente: http://www.google.com o simplemente www.google.com - También puedes establecer enlaces con un nombre: Este enlace apunta a google. Las direcciones de correo electrónico como ésta: andi@splitbrain.org también son reconocidas.

Dokuwiki soporta múltiples formas de crear enlaces. Los enlaces externos se reconocen 
automáticamente: http://www.google.com o simplemente www.google.com - También puedes
establecer enlaces con nombre: [[http://www.google.com|Este enlace apunta a google]]. 
Las direcciones de correo electrónico como ésta: <andi@splitbrain.org> 
también son reconocidas.

Internos

Los enlaces internos se crean mediante corchetes. Puedes tanto simplemente usar pagename como usar el extendidoTexto de título. Los nombres de páginas wiki son convertidos a minúsculas automáticamente y no se permiten caracteres especiales.

Los enlaces internos se crean mediante corchetes. Puedes tanto simplemente usar [[doku>pagename]] 
como usar el extendido[[doku>pagename|Texto de título]]. Los nombres de páginas wiki son convertidos
a minúsculas automáticamente y no se permiten caracteres especiales.

Puedes usar namespaces mediante dos puntos en el nombre de la página.

Puedes usar [[namespaces]] mediante dos puntos en el nombre de la página.

Para más detalles sobre espacios de nombres mira namespaces.

Es también posible enlazar con una sección específica. Basta con añadir el nombre de sección detrás de una almohadilla, como se hace en HTML. Esto enlaza a Esta sección.

Esto enlaza a [[es:wiki:syntax#internos|Esta sección]].

Notas:

  • Los enlaces a páginas existentes se muestran de forma diferente a los no existentes.
  • DokuWiki no utiliza CamelCase para crear enlaces automáticamente por defecto, pero este comportamiento puede ser habilitado en el fichero config. Truco: Si DokuWiki es un enlace, entonces está habilitado.
  • Cuando se cambia el encabezamiento de una sección, su bookmark también cambia. Así que no dependas demasiado del enlace de secciones.

Interwiki

DokuWiki permite enlaces interwiki. Estos son enlaces rápidos a otros Wikis. Por ejemplo, esto es un enlace a la página de la Wikipedia sobre Wikis: Wiki.

DokuWiki permite enlaces [[doku>interwiki]]. Estos son enlaces rápidos a otros Wikis. 
Por ejemplo, esto es un enlace a la página web de la Wikipedia sobre Wikis: [[wp>Wiki]].

Recursos compartidos de Windows

Los recursos compartidos de Windows como este también son reconocidos. Por favor, date cuenta de que éstos solamente tienen sentido en un grupo de usuarios homogéneo, tales como una Intranet corporativa.

Los recursos compartidos de Windows como [[\\server\share|este]] también son reconocidos.

Nota:

  • Por motivos de seguridad, la navegación directa por recursos compartidos solamente funciona en Microsoft Internet Explorer.
  • Para Mozilla y Firefox puede ser habilitada a través de una opción de configuración security.checkloaduri pero no es recomendado.
  • Ver 151 para más información.

Enlaces imagen

También puedes usar una imagen como enlace a otra página externa o interna combinando la sintaxis de enlaces e imágenes (ver abajo) así:

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

Por favor, ten en cuenta que el formato de imagen es la única sintaxis de formato aceptada en los nombres de enlace.

Está soportada la sintaxis completa de imagen y enlace (incluyendo modificar el tamaño de la imagen, e imágenes, URLs y enlaces interwiki internas y externas).

Notas al pie

Puedes añadir notas al pie 1) usando paréntesis dobles.

Puedes añadir notas al pie ((Esto es una nota al pie)) usando paréntesis dobles.

Sectioning

You can use up to five different levels of headlines to structure your content. If you have more than three headlines, a table of contents is generated automatically – this can be disabled by including the string ~~NOTOC~~ in the document.

Secciones

Puedes usar hasta cinco niveles de encabezado distintos para estructurar tus contenidos. Si tienes más de tres encabezados, un índice se genera automáticamente – se puede deshabilitar incluyendo la cadena ~~NOTOC~~ en el documento.

Imágenes y otros ficheros

Puedes incluir imágenes externas e internas usando llaves. De manera opcional, puede especificar sus tamaños.

Tamaño real:

Redimensionando el ancho:

Redimensionando altura y ancho:

Imagen externa redimensionada:

Tamaño real:                      {{wiki:dokuwiki-128.png}}
Redimensionando la anchura:       {{wiki:dokuwiki-128.png?50}}
Redimensionando altura y anchura: {{wiki:dokuwiki-128.png?200x50}}
Imagen externa redimensionada:    {{http://de3.php.net/images/php.gif?200x50}}

Usando espacios en blanco a derecha o izquierda puedes escoger el alineamiento:

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

Naturalmente, también puedes añadir un título (se muestra como tooltip en la mayoría de los navegadores).

Este es el título

{{ wiki:dokuwiki-128.png |Este es el título}}

Si especificas un nombre de fichero (externo o interno) que no es una imagen (gif,jpeg,png), entonces será mostrado como un enlace.

Para enlazar una imagen a otra página ver mas arriba en Enlaces imagen.

Listas

Dokuwiki soporta listas ordenadas y desordenadas. Para crear un elemento de lista, indenta tu texto con dos espacios y usa un * para listas desordenadas o un - para las listas ordenadas.

  • Esto es una lista
  • El segundo elemento
    • Puedes tener diferentes niveles
  • Otro elemento
  1. La misma lista pero ordenada
  2. Otro elemento
    1. Basta con usar sangría para obtener niveles más anidados
  3. Eso es
  * Esto es una lista
  * El segundo elemento
    * Puedes tener diferentes niveles
  * Otro elemento

  - La misma lista pero ordenada
  - Otro elemento
    - Basta con usar indentación para obtener niveles más anidados
  - Eso es

Smileys

DokuWiki convierte los emoticonos usados habitualmente a sus equivalentes gráficos. Se pueden poner más smileys en el directorio smiley y configurarlos en el fichero conf/smileys.conf. Aquí tienes los Smileys incluidos en DokuWiki.

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

Tipografía

DokuWiki puede convertir caracteres de texto simples a su tipografía correcta. Aquí tienes un ejemplo de caracteres reconocidos.

→ ← ↔ ⇒ ⇐ ⇔ » « – — 640×480 © ™ ® “El pensó 'It's a man's world'…”

-> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r)
"El pensó 'It's a man's world'..."

Por favor, advierte: Estas conversiones pueden ser deshabilitadas en las opciones de configuración.

Citas

A veces desea marcar algún texto para indicar que es una respuesta o comentario. Puede usar la siguiente sintaxis:

Pienso que deberíamos hacerlo

> No deberíamos

>> Bueno, yo digo que deberíamos

> En serio?

>> Si!

>>> Entonces hagámoslo!

Pienso que deberíamos hacerlo

No deberíamos
Bueno, yo digo que deberíamos
En serio?
Si!
Entonces hagámoslo!

Tablas

DokuWiki soporta una sintaxis simple para crear tablas.

Encabezado 1 Encabezado 2 Encabezado
Fila 1 Col 1 Fila 1 Col 2 Fila 1 Col 3
Fila 2 Col 1 una combinación(mira la barra doble)
Fila 3 Col 1 Fila 2 Col 2 Fila 2 Col 3

Las filas tienen que empezar y terminar con un | para las filas normales o con un ^ para los encabezados.

^ Encabezado 1   ^ Encabezado 2    ^ Encabezado         ^
| Fila 1 Col 1   | Fila 1 Col 2    | Fila 1 Col 3       |
| Fila 2 Col 1   | una combinación(mira la barra doble)||
| Fila 3 Col 1   | Fila 2 Col 2    | Fila 2 Col 3       |

Para conectar celdas horizontalmente, haz la celda siguiente completamente vacía como se muestra arriba. ¡Asegúrate de tener siempre el mismo número de separadores de celda!

Los encabezados verticales también son posibles.

Encabezado 1 Encabezado 2
Encabezado 3 Fila 1 Col 2 Fila 1 Col 3
Encabezado 4 Sin combinación ahora
Encabezado 5 Fila 2 Columna 2 Fila 2 Columna 3

Como puedes ver, el separador de celda antes de una celda es quien decide cómo es el formato:

|              ^ Encabezado 1         ^ Encabezado 2       ^
^ Encabezado 3 | Fila 1 Col 2         | Fila 1 Col 3       |
^ Encabezado 4 | Sin combinación ahora|                    |
^ Encabezado 5 | Fila 2 Columna 2     | Fila 2 Columna 3   |

Puedes combinar celdas verticalmente (rowspans) añadiendo ::: en las celdas debajo de la que deseas combinar.

Encabezado 1 Encabezado 2 Encabezado 3
Fila 1 Columna 1 Esta celda se combina verticalmente Fila 1 Columna 3
Fila 2 Columna 1 Fila 2 Columna 3
Fila 3 Columna 1 Fila 2 Columna 3
^Encabezado 1         ^Encabezado 2                        ^Encabezado 3       ^
|Fila 1 Columna 1     |Esta celda se combina 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 los contenidos de la tabla. Basta con añadir al menos dos espacios en blanco en el lado opuesto de tu 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 cada extremo para obtener texto centrado.

Tabla con alineamiento
derecha centro izquierda
izquierda derecha centro
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx

Así es como aparece en el fuente:

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

No Formatting

If you need to display text exactly like it is typed (without any formatting), enclose the area either with <nowiki> tags or even simpler, with double percent signs %%.

This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it. The same is true for //__this__ text// with a smiley ;-).

<nowiki>
This is some text which contains addresses like this: http://www.splitbrain.org and **formatting**, but nothing is done with it.
</nowiki>
The same is true for %%//__this__ text// with a smiley ;-)%%.

Bloques no analizados

Puedes incluir en tus documentos bloques sin analizar tanto intentando con al menos dos espacios (como se ha usado en los ejemplos anteriores) o usando las etiquetas code or file.

Esto es código preformateado, todos los espacios se preservan: como              <-este
Esto es muy parecido, pero podrías usarlo para indicar que estás mostrando un fichero.  

Para que el analizador ignore por completo una zona (es decir, no le aplique ningún formato), encierra el área entre etiquetas nowiki o, incluso más simple, con signos de porcentaje duplicados %%.

Esto es un texto que contiene direcciones como ésta: http://www.splitbrain.org y **formatos**, pero no se hace nada con ellos.

Echa un vistazo al fuente de esta página para ver cómo usar estos bloques.

Resaltado de Sintaxis

DokuWiki puede resaltar el código fuente, que lo hace más sencillo de leer. Usa GeSHi Generic Syntax Highlighter – por lo que cualquier lenguaje soportado por GeSHi es soportado. La sintaxis es muy parecida a la del bloque de código de la sección anterior, pero esta vez el nombre del lenguaje utilizado se inserta dentro de la etiqueta. Por 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.
    }
}

Los lenguajes siguientes son reconocidos actualmente: 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, groovy, 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, smalltalk, smarty, sql, tcl, text, tsql, reg, robots, ruby, vb, vbnet, vhdl, visualfoxpro, winbatch, xml

Downloadable Code Blocks

When you use the <code> or <file> syntax as above, you might want to make the shown code available for download as well. You can to this by specifying a file name after language code like this:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

If you don't want any highlighting but want a downloadable file, specify a dash (-) as the language code: <code - myfile.foo>.

Embedding HTML and PHP

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 'A logo generated by PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />';
echo '(generated inline HTML)';
</php>
<PHP>
echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></td>';
echo '</tr></table>';
</PHP>

echo 'A logo generated by PHP:'; echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" />'; echo '(inline HTML)';

echo '<table class="inline"><tr><td>The same, but inside a block level element:</td>';
echo '<td><img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="PHP Logo !" /></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.

RSS/ATOM Feed Aggregation

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:

Parameter Description
any number will be used as maximum number items to show, defaults to 8
reverse display the last items in the feed first
author show item authors names
date show item dates
description show the item description. If HTML is disabled all tags will be stripped
n[dhm] refresh period, where d=days, h=hours, m=minutes. (e.g. 12h = 12 hours).

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.

Example:

{{rss>http://slashdot.org/index.rss 5 author date 1h }}

Control Macros

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

Macro Description
~~NOTOC~~ If this macro is found on the page, no table of contents will be created
~~NOCACHE~~ DokuWiki caches all output by default. Sometimes this might not be wanted (eg. when the <php> syntax above is used), adding this macro will force DokuWiki to rerender a page on every call

Syntax Plugins

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:

1) Esto es una nota al pie
 
Ir hasta arriba
wiki/syntax.1369080197.txt.gz · Última modificación: 2013/05/20 20:03 por albertparera
 
 
github twitter newsletter Donar Piwigo.org © 2002-2024 · Contacto