Guía de Sintaxis XWiki

Última modificación por dFa el 2024/09/06 09:03

Sintaxis XWiki 2.1 » Editando

Sintaxis XWiki 2.1: Editando

Párrafos

Failed to execute the [include] macro. Cause: [Cannot find section [H2.0Paragraphs] in document [xwiki:XWiki.XWikiSyntaxParagraphs]]. Click on this message for details.

Encabezados

Failed to execute the [include] macro. Cause: [Cannot find section [H2.0Headings] in document [xwiki:XWiki.XWikiSyntaxHeadings]]. Click on this message for details.

Formateo de texto

2.0 Text Formatting

Novedad en la Sintaxis XWiki 2.1 sobre la Sintaxis XWiki 1.0:

  • Se permiten los espacios justo detrás de símbolos sintácticos (por ejemplo, en la Sintaxis XWiki 1.0, no era posible: * negrita *).
  • Utiliza símbolos dobles donde en la Sintaxis XWiki 1.0 solo había uno para que sea menos probable que el usuario los utilice de forma errónea en el texto.
  • Posibilidad extenderse por varias líneas (no era posible en la Sintaxis 1.0).
FuncionalidadSintaxis XWiki 2.1Resultado
Negrita**negrita**negrita
Subrayado__subrayado__subrayado
Cursiva//cursiva//cursiva
Tachado--tachado--tachado
Monoespaciado##monoespaciado##monoespaciado
Superíndicealgún ^^superíndice^^algún superíndice
Subíndicealgún ,,subíndice,,algún subíndice

Línea horizontal

2.0 Horizontal Line

Tiene que haber 4 o más guiones.

Ten en cuenta que esto es diferente de Creole donde se requiere exactamente 4 guiones.

FuncionalidadSintaxis XWiki 2.1Resultado
Línea horizontal simple----

Línea horizontal parametrizada
(% style="color:blue" %)
----

Listas

2.0 Lists

Alguno de los estilos mencionados no funciona en todos los navegadores. Para una lista exhaustiva visita este enlace.

FuncionalidadSintaxis XWiki 2.1Resultado
Lista con viñetas
* ítem 1
** ítem 2
*** ítem 3
* ítem 4
  • ítem 1
    • ítem 2
      • ítem 3
  • ítem 4
Lista numérica
1. ítem 1
11. ítem 2
111. ítem 3
1. ítem 4
  1. ítem 1
    1. ítem 2
      1. ítem 3
  2. ítem 4
Lista mixta
1. ítem 1
1*. ítem 2
1*. ítem 3
1. ítem 4
  1. ítem 1
    • ítem 2
    • ítem 3
  2. ítem 4
Lista con cuadrados
(% style="list-style-type: square" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista con discos
(% style="list-style-type: disc" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista alfabética en minúsculas
(% style="list-style-type: lower-alpha" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista alfabética en mayúsculas
(% style="list-style-type: upper-alpha" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista con números romanos en minúsculas
(% style="list-style-type: lower-roman" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista con números romanos en mayúsculas
(% style="list-style-type: upper-roman" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista con letras griegas en minúsculas
(% style="list-style-type: lower-greek" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista con letras griegas en mayúsculas
(% style="list-style-type: upper-greek" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista Hiragana
(% style="list-style-type: hiragana" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista Hiragana Iroha
(% style="list-style-type: hiragana-iroha" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista Katakana
(% style="list-style-type: katakana" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista Katakana Iroha
(% style="list-style-type: katakana-iroha" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista armenia
(% style="list-style-type: armenian" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista hebrea
(% style="list-style-type: hebrew" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista georgiana
(% style="list-style-type: georgian" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2
Lista ideográfica CJK
(% style="list-style-type: cjk-ideographic" %)
* ítem 1
* ítem 2
  • ítem 1
  • ítem 2

Definition Lists

2.0 Definition Lists

FuncionalidadSintaxis XWiki 2.1Resultado
Definición estándar
; término
: definición
término
definición
Definiciones anidadas
; término 1
: definición 1
:; término 2
:: definición 2
término 1
definición 1
término 2
definición 2
Definición parametrizada 
(% style="color:blue" %)
; término
: definición
término
definición

New Line/Line Breaks

2.0 New Line Line Breaks

Una línea nueva es un retorno de carro. Un salto de línea es una línea nueva forzada que puede aparecer en cualquier parte del texto.

En la Sintaxis XWiki 2.1 se respetan las línea nueva lo que no ocurre con la Sintaxis XWiki 1.0 y la Sintaxis Creole.

FuncionalidadSintaxis XWiki 2.1Resultado
Salto de líneaLínea\\New lineLínea
New line
Línea nuevaLínea
New line
Línea
New line

Enlaces

Failed to execute the [include] macro. Cause: [Cannot find section [H2.1Links] in document [xwiki:XWiki.XWikiSyntaxLinks]]. Click on this message for details.

Tablas

2.0 Tables

Permite crear contenido fácilmente en formato tabular. También se soportan parámetros de tabla, fila o celda en la Sintaxis XWiki 2.1.

FuncionalidadSintaxis XWiki 2.1Resultado
Tabla estándar
|=Título 1|=Título 2
|Palabra 1|Palabra 2
o
!=Título 1!=Título 2
!!Palabra 1!!Palabra 2
Título 1Título 2
Palabra 1Palabra 2
Tabla parametrizada
(% style="background-color:red;text-align:center" %)
|=Título 1|=(% style="background-color:yellow" %)Título 2
|Palabra 1|Palabra 2
Título 1Título 2
Palabra 1Palabra 2
Tabla clasificable filtrable
{{velocity}}
$xwiki.ssfx.use("js/xwiki/table/table.css")
$xwiki.jsfx.use("js/xwiki/table/tablefilterNsort.js", true)
{{/velocity}}

(% class="grid sortable filterable doOddEven" id="tableid" %)
(% class="sortHeader" %)|=Título 1|=Título 2
|Celda 11|Celda 12
|Celda 21|Celda 22

Para funcionalidad mejorada véase la macro Livetable.

Título 1Título 2
Celda 11Celda 12
Celda 21Celda 22

Edición

2.1 Images

FuncionalidadSintaxis XWiki 2.1Resultado
Imagen de un adjunto en la página actualimage:img.pngimg.png
Imagen de un adjunto en otra páginaimage:PageA.PageB@img.pngimg.png
Imagen con parámetros[[image:img.png||width="25" height="25"]]img.png
Imágenes a través de una URLimage:http://alguna/url/img.pngimg.png
Iconos pre-empaquetadosimage:icon:acceptaccept

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

La parte entre ( ) es obligatoria, mientras que las partes entre { } son opcionales.

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!)