Herramientas de usuario

Herramientas del sitio


wiki:syntax

Diferencias

Muestra las diferencias entre dos versiones de la página.

Enlace a la vista de comparación

wiki:syntax [13/09/2012 16:15]
Davide
wiki:syntax [26/12/2014 20:36]
Línea 1: Línea 1:
-====== 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 [[playground:​playground|pruebas]]. Las marcas más simples también se encuentran accesibles mediante [[doku>​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>​subíndices</​sub>​ y <​sup>​superíndices</​sup>​. 
- 
-  También puedes usar <​sub>​subíndices</​sub>​ y <​sup>​superíndices</​sup>​. 
- 
-Del mismo modo, también puedes marcar algo como <​del>​borrado</​del>​. 
- 
-  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: [[http://​www.google.com|Este enlace apunta a google]]. Las direcciones de correo electrónico como ésta: <​[email protected]>​ 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: <​[email protected]> ​ 
-  también son reconocidas. 
- 
- 
-==== Internos ==== 
- 
-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. 
- 
-  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 [[doku>​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 [[syntax#​internos|Esta sección]]. 
- 
-  Esto enlaza a [[syntax#​internos|Esta sección]]. 
- 
-Notas: 
- 
-  * Los enlaces a [[syntax|páginas existentes]] se muestran de forma diferente a los [[no existentes]]. 
-  * DokuWiki no utiliza [[wp>​CamelCase]] para crear enlaces automáticamente por defecto, pero este comportamiento puede ser habilitado en el fichero [[doku>​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 [[doku>​interwiki]]. Estos son enlaces rápidos a otros Wikis. Por ejemplo, esto es un enlace a la página de la Wikipedia sobre Wikis: [[wp>​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 [[\\server\share|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 [[wp>​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 [[http://​www.mozilla.org/​quality/​networking/​docs/​netprefs.html#​file|security.checkloaduri]] pero no es recomendado. 
-  * Ver [[bug>​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}}]] 
- 
-[[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 [[#​imagenes_y_otros_ficheros|imagen]] y [[#​enlaces|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 ((Esto es una nota al pie)) usando paréntesis dobles. 
- 
-  Puedes añadir notas al pie ((Esto es una nota al pie)) usando paréntesis dobles. 
- 
-===== 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 ''<​nowiki>​~~NOTOC~~</​nowiki>''​ en el documento. 
- 
-==== Titular Nivel 3 ==== 
-=== Titular Nivel 4 === 
-== Titular Nivel 5 == 
- 
-  ==== Titular Nivel 3 ==== 
-  === Titular Nivel 4 === 
-  == Titular Nivel 5 == 
- 
-Usando cuatro o más guiones, puedes hacer una línea horizontal: 
- 
----- 
- 
-===== Imágenes y otros ficheros ===== 
- 
-Puedes incluir [[doku>​images|imágenes]] externas e internas usando llaves. De manera opcional, puede especificar sus tamaños. 
- 
-Tamaño real:                        {{wiki:​dokuwiki-128.png}} 
- 
-Redimensionando el ancho: ​          ​{{wiki:​dokuwiki-128.png?​50}} 
- 
-Redimensionando altura y ancho: ​    ​{{wiki:​dokuwiki-128.png?​200x50}} 
- 
-Imagen externa redimensionada: ​     {{http://​de3.php.net/​images/​php.gif?​200x50}} 
- 
-  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 }} 
- 
-  {{ 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). 
- 
-{{ wiki:​dokuwiki-128.png |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 
- 
-  - La misma lista pero ordenada 
-  - Otro elemento 
-    - Basta con usar sangría para obtener niveles más anidados 
-  - Eso es 
- 
-<​code>​ 
-  * 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 
-</​code>​ 
- 
- 
- 
-===== Smileys ===== 
- 
-DokuWiki convierte los [[wp>​emoticon|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. 
- 
--> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 
-"El pensó '​It'​s a man's world'​..."​ 
- 
-<​code>​ 
--> <- <-> => <= <=> >> << -- --- 640x480 (c) (tm) (r) 
-"El pensó '​It'​s a man's world'​..."​ 
-</​code>​ 
- 
-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   | 
- 
-<​code>​ 
-^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   | 
-</​code>​ 
- 
- 
-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''​. 
- 
-<​code>​ 
-Esto es código preformateado,​ todos los espacios se preservan: como              <-este 
-</​code>​ 
- 
-<​file>​ 
-Esto es muy parecido, pero podrías usarlo para indicar que estás mostrando un fichero.  ​ 
-</​file>​ 
- 
-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 ''<​nowiki>​%%</​nowiki>''​. 
- 
-<​nowiki>​ 
-Esto es un texto que contiene direcciones como ésta: http://​www.splitbrain.org y **formatos**,​ pero no se hace nada con ellos. 
-</​nowiki>​ 
- 
-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 [[http://​qbnz.com/​highlighter/​|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. ''<​nowiki><​code java></​nowiki>''​. 
- 
-<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. 
-    } 
-} 
-</​code>​ 
- 
-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 [[http://​simplepie.org/​|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 }} 
- 
-{{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: 
-<​code>​ 
-<​html>​ 
-Esto es <font color="​red"​ size="​+1">​HTML</​font>​ 
-</​html>​ 
-</​code>​ 
- 
-<​html>​ 
-Esto es <font color="​red"​ size="​+1">​HTML</​font>​ 
-</​html>​ 
- 
-<​code>​ 
-<php> 
-echo 'Un logo generado por PHP:'; 
-echo '<​img src="'​ . $_SERVER['​PHP_SELF'​] . '?​='​ . php_logo_guid() . '"​ alt="​PHP Logo !" />';​ 
-</​php>​ 
-</​code>​ 
- 
-<php> 
-echo 'Un logo generado por PHP:'; 
-echo '<​img src="'​ . $_SERVER['​PHP_SELF'​] . '?​='​ . php_logo_guid() . '"​ alt="​PHP Logo !" />';​ 
-</​php>​ 
- 
-**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 esta 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 [[doku>​plugins|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: 
- 
-~~INFO:​syntaxplugins~~ 
wiki/syntax.txt · Última modificación: 26/12/2014 20:36 (editor externo)