Guía de Sintaxis XWiki

Sintaxis XWiki 2.1 » Editando » Edición

2.1 Images

Funcionalidad	Sintaxis XWiki 2.1	Resultado
Imagen de un adjunto en la página actual	image:img.png
Imagen de un adjunto en otra página	image:PageA.PageB@img.png
Imagen con parámetros	[[image:img.png||width="25" height="25"]]
Imágenes a través de una URL	image:http://alguna/url/img.png
Iconos pre-empaquetados	image:icon:accept

Especificación de la Sintaxis XWiki 2.1 para imágenes

El formato completo para una imagen es image: (referencia) o [[image: (referencia) {||parámetros}]]

• image: Una cadena de texto obligatoria que identifica el recurso como una imagen.
• referencia: La referencia de la imagen que se tiene que mostrar de una de las formas siguientes:
  • URL: Cualquier URL a una imagen con la forma protocolo://ruta/nombreDeImagen. Ejemplo: http://dominio.org/ruta/img.png
  • Referencia a un adjunto con la forma {{{nombreDeWiki:} listaDeNombresDeEspacio.} nombreDePágina@} (nombreDeImagen)
    • nombreDeWiki: Una cadena de texto opcional que contiene el nombre de una wiki virtual. La referencia a la imagen apuntará a una imagen adjuntada a una página dentro de esa wiki virtual. Si no se especifica ninguna wiki, se utilizará la wiki actual. Ejemplo: miwiki
    • listaDeNombresDeEspacio: Una lista opcional de nombres de espacio wiki separada por puntos. Si no se especifica ningún espacio, se utiliza el espacio en curso. Ejemplos: Inicio, A.B, A.B.C
    • nombreDePágina: Una cadena de texto opcional que contiene el nombre la página wiki a la que está adjuntada la imagen referenciada. Ejemplo: Bienvenido
    • nombreDeImagen: Una cadena de texto obligatoria que contiene el nombre e la imagen adjuntada a una página como se almacena en la wiki. Ejemplo: miImagen.png
  • Referencia a un Icono con la forma (icon:) (nombreDeIcono). Ejemplo: icon:accept
    • icon: Una cadena de texto obligatoria que identifica la referencia de imagen como un icono del Conjunto de iconos de XWiki.
    • nombreDeIcono: Una cadena de texto que identifica el icono referenciado. Ejemplo: accept
  • URI Data con la forma (data:) (contenido). Ejemplo: data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
    • data: Una cadena de obligatoria que identifica la imagen con una especificación en línea que emplea el esquema URI Data.
    • contenido: La imagen codificada. Ejemplo: image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg==
• parámetros: Una lista opcional de parámetros separados por espacios que se pasa a la imagen. Ejemplo: width="800" height="600" alt="img.png" title="Mi preciosa imagen"
  • Atributos HTML: Todos los atributos definidos en el estándar HTML se añadirán a la etiqueta HTML <img> renderizada.
    • style: Información de estilo CSS que se debería aplicar a la imagen. Ejemplos: style="float:right;height:50" (imagen en el lado derecho, altura 50 pixeles), style="display:block;margin-left:auto;margin-right:auto;width:80%" (imagen centrada, anchura 80% de la anchura del bloque), style="vertical-align:bottom" (el texto comienza en la parte inferior de la imagen)
    • height: Un parámetro que define la altura de la imagen visualizada. El valor debe estar en pixeles (ejemplo: height="80") o en pixeles relativos a la altura del bloque que contiene la imagen (ejemplo: height="40%").
    • width: Un parámetro que define la anchura de la imagen visualizada. El valor debe estar en pixeles (ejemplo: width="80") o en pixeles relativos a la anchura del bloque que contiene la imagen (ejemplo: width="40%").
    • title: Un parámetro que define el título de la imagen visualizada que será visible al pasar el puntero del ratón sobre la imagen, por ejemplo. Ejemplo: title="Mi preciosa imagen"
    • alt: Un parámetro que define el texto que se debería visualizar si el navegador no puede visualizar la imagen. Como este es un atributo HTML obligatorio XWiki empleará el nombre de fichero en lugar del parámetro alt si no se define. Ejemplo: alt="img.png"
    • Más: Una explicación en mayor profundidad de la etiqueta HTML <img> que incluye más atributos se puede revisar en w3.org.
  • queryString: Permite pasar consultas al servidor al crear el enlace de descarga de la imagen referenciada. Ejemplo: queryString="width=100&height=800&keepAspectRatio=true" (¡keepAspectRatio=true fallará si se especifican los parámetros width y height además de queryString!)