TAR MÉXICO

Sistema de administración de documentos (Wiki)

User Tools

Site Tools


wiki:syntaxplus

This is an old revision of the document!


Sintaxis de Formato Extendido

DokuWiki soporta un lenguaje de marcas simple, que intenta hacer los ficheros de datos tan legibles como sea posible. Esta página contiene opciones EXTENDIDAS 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.

Listas

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

  • 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. Listo
Esto es una lista simple
Se trata básicamente de sangrías
Puede utilizarse para algunos elementos
Todos indentandos o con sangría
  * 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
  - Listo

  : Esto es una lista simple
  : Se trata básicamente de sangrías
    : Puede utilizarse para algunos elementos
  : Todos indentandos o con sangría

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 |

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 ejemplo <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("hola mundo"); //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

Agregar fuentes RSS/ATOM

DokuWiki puede integrar información de fuentes XML externas. Para procesar las fuentes XML, se ocupa SimplePie. Todos los formatos entendidos por SimplePie, pueden usarse también en DocuWiki. Se puede afectar el despliegue por medio de varios parámetros separados por espacios:

Parámetro Descripción
cualquier número número de artículos a mostrar como máximo; por omisión, 8
reverse mostrar los últimos artículos al principio
author mostrar los nombres de los autores de los artículos
date mostrar las fechas de los artículos
description mostrar las descripciones de los artículos. Si el HTML está deshabilitado, toda etiqueta se rasurará
n[dhm] periodo de actualización, donde d=días, h=horas, m=minutos. (ej. 12h = 12 horas).

El periodo de actualización por omisión es de 4 horas. Cualquier valor menor a 10 minutos será tratado como 10 minutos. DokuWiki generalmente tratará de entregar una versión en caché de la página; obviamente esto no es apropiado cuando la página incluye contenido dinámico externo. El parámetro le dice a DokuWiki que regenere la página si hace más de periodo de actualización desde que la página se generó por última vez.

Ejemplo:

{{rss>http://barrapunto.com/index.rss 10 author date 2h }}

Incrustar HTML y PHP

Puedes incrustar código HTML o PHP puro en tus documentos usando las etiquetas html o php de este modo:

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

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

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

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

Por favor observa: La inclusión de HTML y PHP se encuentra deshabilitada predeterminadamente en la configuración. Si se encuentra deshabilitado, el código se muestra en lugar de ejecutarse.

Macros de Control

Algunas expresiones afectan la manera en que DokuWiki despliega una página, sin producir una salida per se. Se cuenta con las siguientes macros de control:

Macro Descripción
~~NOTOC~~ Si ésta macro se encuentra en la página, no se generará una tabla de contenidos
~~NOCACHE~~ DokuWiki, por omisión, hace un caché de todo lo que despliega. A veces esto no es deseable (por ejemplo, cuando se usa la sintaxis <php> descrita arriba); añadir esta macro forzará a DokuWiki a regenerar la página cada vez que sea solicitada

Plugins de Sintaxis

La sintaxis de DokuWiki puede extenderse con Plugins. Como se usan los plugin instalados se describe en sus correspondientes páginas descriptivas. Los siguientes plugins de sintaxis están disponibles en esta particular instalación de DokuWiki:

wiki/syntaxplus.1481840545.txt.gz · Last modified: 17/11/2021 10:26 (external edit)