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 [11/08/2008 21:03]
Davide
wiki:syntax [26/12/2014 20:36]
Línea 1: Línea 1:
-====== Sintaxis de Formato ====== 
  
-[[wiki:​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>​quickbuttons]]. 
- 
-===== 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ágicamente:​ 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. 
- 
-  Docuwiki soporta múltiples formas de crear enlaces. Los enlaces externos se reconocen ​ 
-  automágicamente:​ 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 crear mediante corchetes. Puedes tanto simplemente usar [[doku>​wiki:​pagename]] como usar el extendido[[doku>​wiki:​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>​wiki:​pagename]] ​ 
-  como usar el extendido[[doku>​wiki:​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 [[wiki:​namespaces]] mediante dos puntos en el nombre de la página. 
- 
-  Puedes usar [[wiki:​namespaces]] mediante dos puntos en el nombre de la página. 
- 
-Para más detalles sobre espacios de nombres mira [[doku>​wiki:​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 [[wiki:​syntax|páginas existentes]] se muestran de forma diferente a los [[wiki: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>​wiki:​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>​wiki:​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]]. 
- 
-==== Recursos compartidas 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 and 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, advierte: el formato de imagen es la única sintaxis de formato aceptada en los nombres de enlace. 
- 
-La sintaxis completa de [[#​imagenes_y_otros_ficheros|imagen]] y [[#​enlaces|enlace]] es soportada (incluyendo @todo, imágenes internas y externas, URLs y enlaces interwiki) 
- 
-@The whole [[#​images_and_other_files|image]] and [[#​links|link]] syntax is supported (including image resizing, internal and external images and URLs and interwiki links). 
- 
-===== 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 indentación 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 %% 
- 
-===== Typografí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. 
- 
-===== Comentarios ===== 
- 
-A veces desea marcar algún texto para indicar 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   | 
- 
-Nota: No son posibles las combinaciones verticales (de filas). 
- 
-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 bloques sin analizar en tus documentos tanto indentando 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 tanto con 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// 
- 
-===== Embedding HTML and 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. 
- 
-===== Plugins de Sintaxis ===== 
- 
-La sintaxis de DokuWiki puede extenderse con [[doku>​wiki:​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)