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

Ambos lados, revisión anterior Revisión previa
Próxima revisión
Revisión previa
wiki:syntax [11/08/2008 21:03]
Davide
wiki:syntax [13/09/2012 16:16]
Davide [Plugins de Sintaxis]
Línea 1: Línea 1:
 ====== Sintaxis de Formato ====== ====== 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]].+[[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 ===== ===== Formato básico de texto =====
Línea 29: Línea 29:
  
 Solamente deberías forzar saltos de línea cuando realmente lo necesites. Solamente deberías forzar saltos de línea cuando realmente lo necesites.
 +
  
 ===== Enlaces ===== ===== Enlaces =====
  
 DokuWiki soporta múltiples formas de crear enlaces. DokuWiki soporta múltiples formas de crear enlaces.
- 
- 
 ==== Externos ==== ==== 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.+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.
  
-  ​Docuwiki ​soporta múltiples formas de crear enlaces. Los enlaces externos se reconocen  +  ​Dokuwiki ​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+  ​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]]. ​   establecer enlaces con nombre: [[http://​www.google.com|Este enlace apunta a google]]. ​
   Las direcciones de correo electrónico como ésta: <​[email protected]> ​   Las direcciones de correo electrónico como ésta: <​[email protected]> ​
   también son reconocidas.   también son reconocidas.
 +
  
 ==== Internos ==== ==== 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>​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>wiki:pagename]]  +  Los enlaces internos se crean mediante corchetes. Puedes tanto simplemente usar [[doku>​pagename]]  
-  como usar el extendido[[doku>​wiki:pagename|Texto de título]]. Los nombres de páginas wiki son convertidos+  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.   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 [[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.+  Puedes usar [[namespaces]] mediante dos puntos en el nombre de la página.
  
-Para más detalles sobre espacios de nombres mira [[doku>wiki:namespaces]].+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]]. 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]].
Línea 65: Línea 65:
 Notas: Notas:
  
-  * Los enlaces a [[wiki:syntax|páginas existentes]] se muestran de forma diferente a los [[wiki:no existentes]].+  * 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.   * 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.   * Cuando se cambia el encabezamiento de una sección, su bookmark también cambia. Así que no dependas demasiado del enlace de secciones.
Línea 71: Línea 71:
 ==== Interwiki ==== ==== 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>​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.  +  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]].+  Por ejemplo, esto es un enlace a la página ​web de la Wikipedia sobre Wikis: [[wp>​Wiki]].
  
-==== Recursos ​compartidas ​de Windows ====+==== 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. Por favor, date cuenta de que éstos solamente tienen sentido en un grupo de usuarios homogéneo, tales como una [[wp>​Intranet]] corporativa.
Línea 85: Línea 85:
  
   * Por motivos de seguridad, la navegación directa por recursos compartidos solamente funciona en Microsoft Internet Explorer.   * 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.+  * Para Mozilla ​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.   * Ver [[bug>​151]] para más información.
 +
  
  
Línea 97: Línea 98:
 [[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. +Por favor, ​ten en cuenta que 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 resizinginternal and external images and URLs and interwiki ​links).+Está soportada la sintaxis completa de [[#imagenes_y_otros_ficheros|imagen]] [[#enlaces|enlace]] (incluyendo modificar el tamaño de la imagen, e imágenes, URLs y enlaces ​interwiki ​internas y externas).
  
 ===== Notas al pie ===== ===== Notas al pie =====
Línea 163: Línea 162:
  
 Para enlazar una imagen a otra página ver mas arriba en [[#Enlaces imagen]]. Para enlazar una imagen a otra página ver mas arriba en [[#Enlaces imagen]].
 +
 +
 +
  
  
Línea 176: Línea 178:
   - La misma lista pero ordenada   - La misma lista pero ordenada
   - Otro elemento   - Otro elemento
-    - Basta con usar indentación ​para obtener niveles más anidados+    - Basta con usar sangría ​para obtener niveles más anidados
   - Eso es   - Eso es
  
Línea 190: Línea 192:
   - Eso es   - Eso es
 </​code>​ </​code>​
- 
  
  
Línea 219: Línea 220:
   * DELETEME %% DELETEME %%   * DELETEME %% DELETEME %%
  
-===== Typografía ​=====+===== Tipografía ​=====
  
 [[DokuWiki]] puede convertir caracteres de texto simples a su tipografía correcta. Aquí tienes un ejemplo de caracteres reconocidos. [[DokuWiki]] puede convertir caracteres de texto simples a su tipografía correcta. Aquí tienes un ejemplo de caracteres reconocidos.
Línea 233: Línea 234:
 Por favor, advierte: Estas conversiones pueden ser deshabilitadas en las opciones de configuración. Por favor, advierte: Estas conversiones pueden ser deshabilitadas en las opciones de configuración.
  
-===== Comentarios ​=====+===== Citas =====
  
-A veces desea marcar algún texto para indicar una respuesta o comentario. Puede usar la siguiente sintaxis:+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   Pienso que deberíamos hacerlo
Línea 293: Línea 294:
   ^ Encabezado 5 | Fila 2 Columna 2     | Fila 2 Columna 3   |   ^ Encabezado 5 | Fila 2 Columna 2     | Fila 2 Columna 3   |
  
-NotaNo son posibles ​las combinaciones verticales (de filas).+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. 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.
Línea 308: Línea 322:
   |izquierda ​    ​| ​      ​derecha| ​   centro ​   |   |izquierda ​    ​| ​      ​derecha| ​   centro ​   |
   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |   | xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |
 +
  
 ===== Bloques no analizados ===== ===== 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''​.+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>​ <​code>​
Línea 321: Línea 336:
 </​file>​ </​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>''​.+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>​ <​nowiki>​
Línea 328: Línea 343:
  
 Echa un vistazo al fuente de esta página para ver cómo usar estos bloques. Echa un vistazo al fuente de esta página para ver cómo usar estos bloques.
- 
 ===== Resaltado de Sintaxis ===== ===== Resaltado de Sintaxis =====
  
Línea 347: Línea 361:
 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// 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 =====+===== 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: Puedes incrustar código HTML o PHP puro en tus documentos usando las etiquetas ''​html''​ o ''​php''​ de este modo:
Línea 374: Línea 406:
 **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. **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~~+===== 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 | 
wiki/syntax.txt · Última modificación: 26/12/2014 20:36 (editor externo)