Guía de Sintaxis XWiki

Última modificación por Administrator el 2024/06/06 11:45

Sintaxis XWiki 2.1

Sintaxis XWiki 2.1: Todo

General

Introducción

2.1 Introduction

La Sintaxis XWiki 2.0 ha demostrado ser bastante útil y robusta en general; sin embargo, desde su introducción se han encontrado algunas deficiencias. Las mejoras correspondientes se han consolidado en la Sintaxis XWiki 2.1. Algunas características nuevas de esta sintaxis son:

  • Homogenización de la sintaxis de enlaces e imágenes para una mayor claridad, consistencia y extensibilidad.
  • Se ha añadido la capacidad de mostrar iconos, incrustar imágenes a través del esquema URI Data, vincular archivos usando la notación UNC y vincular a URLs relativas.

Como la Sintaxis XWiki 2.1 se basa en la Sintaxis XWiki 2.0, toda la Sintaxis XWiki 2.0 es válida a menos que las especificaciones de la 2.1 indiquen lo contrario.

Además de las sintaxis específicas de XWiki también hemos cambiado el motor de renderizado interno en XWiki Enterprise versión 1.7 (anteriormente era Radeox) por nuestro motor propio que es un superconjunto que envuelve a Wikimodel y Doxia (y otros posiblemente en el futuro). Esto nos ha permitido proporcionar otras sintaxis en la wiki: MediaWiki, Confluence, JSPWiki, Creole, TWiki y más.

Comentarios generales

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

Otras sintaxis

1.0 Other Syntaxes

También hay disponibles otras sintaxis (incluidas o vía extensiones):

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

Avanzado

Literal

2.0 Verbatim

Permite añadir contenido que no será formateado (en otras palabras, en el que no se tendrá en cuenta la Sintaxis XWiki).

FuncionalidadSintaxis XWiki 2.1Resultado
Literal en líneaAlgún contenido literal {{{**[[no renderizado]]**}}}Algún contenido literal **[[no renderizado]]**
Bloque literal
{{{
multilínea
**literal**
contenido
}}}

multilínea
**literal**
contenido

Citas

2.0 Quotations

Permite citar algún texto.

FuncionalidadSintaxis XWiki 2.1Resultado
Cita sencilla
> juan dijo esto
Dije que bien

 juan dijo esto

Dije que bien

Citas anidadas
> juan dijo esto
>> maría respondió eso
Dije que bien

 juan dijo esto

 maría respondió eso

Dije que bien

Grupos

2.0 Groups

Los grupos se pueden usar para insertar otro documento directamente en línea en el documento actual. Esto permite, por ejemplo, insertar elementos o estilos complejos dentro de un elemento de una lista, en una celda de una tabla o en un párrafo. Los grupos están delimitados por los siguientes elementos sintácticos: (((...))). Un grupo puede contener otro grupo y no hay límite en el número de niveles de anidamiento.

Sintaxis XWiki 2.1Resultado
|=Encabezado 1|=Encabezado 2|=Encabezado 3
|Celda uno|(((
= Documento incrustado =

Algún párrafo incrustado.

* Lista ítem uno
* Lista ítem dos
  ** subítem 1
  ** subítem 2
))) | Celda tres

Párrafo siguiente en el documento de nivel superior
Encabezado 1Encabezado 2Encabezado 3
Celda uno

Documento incrustado

Algún párrafo incrustado.

  • Lista ítem uno
  • Lista ítem dos
    • subítem 1
    • subítem 2
 Celda tres

Párrafo siguiente en el documento de nivel superior

(% class="miClase" style="color:blue" %)(((párrafos azules

 en miClase)))
 

párrafos azules

 en mi grupo

Escapes

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

Parámetros

2.0 Parameters

Con la Sintaxis XWiki 2.1 es posible pasar parámetros a los diferentes elementos sintácticos y también a bloques de texto. Se utiliza, por ejemplo, para estilizarlos. Puedes definir cualquier par clave/valor que desees como parámetro. El renderizador XHTML pasará estos parámetros como atributos XHTML a la representación XHTML subyacente de los diferentes elementos sintácticos.

Sintaxis XWiki 2.1XHTML generado
(% class="miClase" style="miEstilo" id="miId" %)
= encabezado =

<h1 class="miClase" style="miEstilo" id="myId">encabezado</h1>

Programación

Macros

2.0 Macros

Solo hay una clase de macros en la Sintaxis XWiki 2.1, se invocan con la sintaxis: {{nombredemacro parám1="valor1" ... parámN="valorN"}}...{{/nombredemacro}}. Hay una notación abreviada para macros in contenido: {{nombredemacro parám1="valor1" ... parámN="valorN"/}}

FuncionalidadSintaxis XWiki 2.1Resultado
Renderizando una macro con contenido
{{code language="java"}}
System.out.println("¡Hola mundo!");
{{/code}}
System.out.println("¡Hola mundo!");
Renderizando una macro sin contenido

{{include reference="Espacio.Página"/}}

Se incluye la página referenciada en la página en curso

La macros Radeox no se pueden utilizar en la Sintaxis XWiki 2.1. Así tiene que reescribirse como macros de renderizado.

La lista completa de macros disponibles está en la wiki de Extensiones.

Macros en esta wiki

IdNombreCategoriesDescripciónVisibilidad
activityActividadNotificationsLa macro de actividad provee información acerca de las actividades recientes realizadas por los usuarios dentro de la instancia de XWiki. Lista los eventos de creación, edición y borrado de las páginas, así como los de los comentarios, adjuntos y anotaciones.Wiki actual
asyncMacro asíncronaContenidoEjecutar asincrónicamente y/o cachear el contenido de la macro.Global
attachmentGalleryPickerAttachment PickerDesarrolloGrid based attachment picker.Global
attachmentSelectorSelector de adjuntosDesarrolloUn control que se utilizará para las propiedades de objeto de la página actual que se supone que contienen el nombre de un archivo adjunto de la página actual (o de destino). Permite cargar nuevos archivos adjuntos y eliminarlos de la página de destino.  Si no se especifica ninguna página de destino, se utilizará la página actual. Las propiedades de los objetos sólo se guardan en la página actual.Wiki actual
boxCajaFormatoDibujar una caja alrededor del contenido provisto.Global
cacheCachéDesarrolloContenido cacheado.Global
chartGráficaContenidoMuestra una gráfica generados desde fuentes de datos variadasGlobal
childrenChildrenNavegaciónDisplays a tree of children pages of the current pageWiki actual
codeCódigoFormatoResalta los trozos de código de varios lenguajes de programaciónGlobal
commentComentarioDesarrolloPermite poner comentarios en el contenido fuente. Esta macro no produce nada.Global
containerContenedorMaquetaciónUna macro para rodear múltiples grupos y añadirles decoración, tal como distribución.Global
contentContenidoContenidoPermite escribir contenido en cualquier formato wikiGlobal
contextContextoDesarrolloEjecuta el contenido en el contexto del documento pasadoGlobal
dashboardPanel de controlMaquetaciónMacro para definir un panel de control que rellenar con gadgets.Global
displayMostrarContenidoMuestra otras páginas en la página actual.Global
displayIconIconContenidoDisplay an icon.Global
documentsDocumentosContenidoMuestra una lista de páginas en una 'Livetable'Wiki actual
documentTreeJerarquía de páginasNavegaciónMuestra la jerarquía de páginas de XWiki.Wiki actual
errorMensaje de errorFormatoMuestra una nota de error.Global
exampleExampleFormatoShows an example and its source code.Wiki actual
footnoteNota al pieContenidoGenera una nota al pie que muestra al final de la página.Global
galleryGaleríaMaquetaciónMostrar las imágenes encontradas en el contenido que se provea usando una vista de presentación de diapositivas.Global
groovyGroovyDesarrolloEjecuta un script groovy.Global
htmlHTMLDesarrolloInserta código HTML o XHTML en la página.Global
iconPickerSelector de iconosDesarrolloSelecciona un icono dentro del conjunto de iconos de XWiki.Wiki actual
idIdNavegaciónPermite incluir una referencia/ubicación en una página. En HTML esto se llama Anchor. Permite apuntar a esa ubicación, por ejemplo en un enlace.Global
includeIncluirContenidoIncluye otras páginas en la página actual.Global
infoMensaje InformativoFormatoMuestra una nota informativa.Global
liveDataLive DataContenidoDisplay dynamic lists of data.Global
mentionMención de usuarioNotificationsAñade una mención de usuario.Wiki actual
menuMenúNavegaciónMuestra un menú creado utilizando una sintaxis wiki simple (listas anidadas y enlaces).Global
messageSenderRemitente del mensajeSocialUn control que permite a los usuarios introducir mensajes que son gestionados por el módulo MessageStream.Wiki actual
notificationsNotificacionesNotificationsMuestra notificaciones sobre eventos ocurridos en el wiki.Wiki actual
notificationsApplicationsPreferencesConfiguración de notificaciones de aplicacionesNotificationsMuestra las preferencias del usuario actual sobre las notificaciones de las aplicaciones.Wiki actual
notificationsAutoWatchPreferencesPreferencias de notificaciones de autovigilanciaNotificationsMostrar las preferencias del usuario en curso sobre las páginas vistas automáticamente.Wiki actual
notificationsCustomFiltersPreferencesNotifications Custom Filters PreferencesNotificationsDisplay the preferences of the given user about custom notification filters.Wiki actual
notificationsEmailPreferencesNotifications Email PreferencesNotificationsDisplay the preferences of the current user about notification emails.Wiki actual
notificationsFiltersPreferencesNotifications Filters Preferences (deprecated)NotificationsDisplay the preferences of the current user about notification filters.
This macro is now deprecated in favor of Custom Notifications Filters Preferences or System Notifications Filters Preferences.		Wiki actual
notificationsSystemFiltersPreferencesNotifications System Filters PreferencesNotificationsDisplay the preferences of the given user about system notification filters.Wiki actual
officeOffice Document ViewerContenidoMostrar el contenido de los adjuntos (doc, ppt, xls, odt, odp, ods etc.) dentro de las páginas sin necesidad de descargarlos o importarlos.Global
pdftocPDF Table of ContentsInternoGenerates the table of contents for the PDF export.Global
putFootnotesPoner nota al pieContenidoMuestra las notas al pie si las hay. Si no está, todas las notas al pie se muestran al final de la página.Global
pythonPythonDesarrolloEjecuta un script en python.Global
scriptScriptDesarrolloEjecutar un script en el lenguaje de script provisto.Global
spaceindexÍndice del espacioObsoletoLista los documentos en un espacio.Wiki actual
spacesEspaciosObsoletoMuestra todos los espacios en este wiki.Wiki actual
successMensaje de éxitoFormatoMuestra una nota de mensaje de éxito.Global
tagcloudNube de etiquetasContenidoMuestra la nube de etiquetas de este wiki o del espacio especificado, si las hay.Wiki actual
templatePlantillaDesarrolloAñadir una plantilla.Global
tocTabla de contenidosNavegaciónGenera una tabla de contenidos.Global
translationTraducciónContenidoMostrar un mensaje de traducción.Global
treeÁrbolNavegaciónMuestra una jerarquía de árbol definida por el contenido de la macro o el parámetro fuente.Wiki actual
uiextensionUI ExtensionDesarrolloInsert a UI extension.Global
uiextensionsUI ExtensionsDesarrolloInsert UI extensions.Global
useravatarAvatarContenidoPermite mostrar el avatar de un usuario concreto.Global
velocityVelocityDesarrolloEjecuta un script en Velocity.Global
warningMensaje de advertenciaFormatoMuestra una nota de advertencia.Global
watchlistWatch ListShow the content of your current watchlist.Wiki actual
wikimacrocontentWikiMacro ContentDesarrolloDisplay editable content of a wikimacro.Global
wikimacroparameterWikiMacro ParameterDesarrolloDisplay editable parameter of a wikimacro.Global
wikisWikisNavegaciónMostrar todas las wikisWiki actual
workspacesEspacios de trabajo ("Legacy", en desuso)ObsoletoMacro obsoleta que no debería utilizarse aquí por razones de compatibilidad. Por favor, utiliza la macro "wikis" en su lugar.Wiki actual

HTML

2.0 HTML

En la Sintaxis XWiki 2.1, se debe utilizar la macro HTML para añadir HTML o XHTML.

Sintaxis XWiki 2.1Resultado
{{html}}<b>bold</b>{{/html}} bold

En la Sintaxis XWiki 2.1, por defecto, la macro HTML no interpreta la Sintaxis XWiki (otras macros incluidas puesto que también es Sintaxis XWiki). Para activarla, utiliza {{html wiki="true"}} .

Scripts

2.0 Scripts

En la Sintaxis XWiki 1.0 era posible añadir scripts Velocity directamente en cualquier lugar de la página, lo que podía provocar problemas, por ejemplo, cuando el usuario introducía contenido Velocity de forma involuntaria. También desperdiciaba mucho rendimiento en páginas que no necesitan contenido Velocity. Hay también otras limitaciones técnicas. Así que en la Sintaxis XWiki 2.1 los scripts Velocity se deben añadir con la macro velocity. Lo mismo aplica al añadir scripts Groovy.

FuncionalidadSintaxis XWiki 2.1
Script Velocity
{{velocity}}
#set ($var = "lo que sea")
{{/velocity}}
Script Groovy
{{groovy}}
def var = "lo que sea"
{{/groovy}}