Estable 2.1.2 / 2-10-2010;Próxima versión 2.2RC2 / 2-10-2010; Desarrollado en JavaMulti-plataformaLicencia GNU Lesser GPLSitio Web http://www.xwiki.org

http://www.xwiki.com

Datos de WikipediaXWiki es un software tipo wiki a nivel empresarial con varias funcionalidades para este entorno.

Permite también la creación de pequeñas aplicaciones, incluyendo datos estructurados y modo script, dentro de la propia interfaz. Para esto admite los lenguajes Velocity y Grovy que se comentarán más abajo.

Escrita en Java y apoyada enteramente en un SGBD, generalmente MySQL o HSQLDB entre otros SGBDs.

HistoriaXWiki fue originalmente escrita por Ludovic Dubost y su primera versión data de Enero de

2003, desde Abril bajo licencia GNU. En 2006 se acoge a GNU Lesser General Public License, que es una versión reducida de la licencia.

Características• Contenido estructurado y scripting en linea, lo cual permite la construcción de wiki-soft.• Gestión de permisos usuarios y grupos por wiki, espacio, página.• Su sintaxis es procesada por XWiki Rendering Engine.• Exportación a PDF, e importación desde ficheros tipo office a la sintaxis xWiki através de Open Office y Lucene.• Búsquedas a texto completo y apoyada en tags.• Control de versiones.• Varios protocolos para accederla WebDAV, REST, XmlRpc, GWT...• Exportación/Importación del contenido y/o el sitio• Plugins, API para programación...

Así como la creación de objetos y clases para la propia xWiki. Los formularios pueden ser creados rápidamente y reutilizados por plantillas. Los usuarios pueden encontrarse con páginas donde solo deberán rellenar los campos estrictamente necesarios.

Proyectos Open-Source en cuales se apoya

Groovy

Para scripting avanzado en xWiki. Multiparadigma orientado a objetos, aparece en 2003, diseñado por JCP. Su última versión 1.7 data de 22-12-2009. Se caracteriza por fuerte tipado de datos y ser dinámico, además de su influencia desde Perl, Smalltalk, Ruby, Python.Groovy es un lenguaje de programación orientado a objetos implementado sobre la plataforma Java. La especificación JSR 241 se encarga de su estandarización para una futura inclusión como componente oficial de la plataforma Java como lenguaje para scripting.Usa una sintaxis muy parecida a Java, comparte el mismo modelo de objetos, de hilos y de seguridad. Desde Groovy se puede acceder directamente a todas las API existentes en Java. El bytecode generado en el proceso de compilación es totalmente compatible con el generado por el lenguaje Java para la Java Virtual Machine (JVM), por tanto puede usarse directamente en cualquier aplicación Java, además se produce dinámicamente durante la

ejecución. Todo lo anterior unido a que la mayor parte de código escrito en Java es totalmente válido en Groovy hacen que este lenguaje sea de muy fácil adopción para programadores Java en comparación con otros lenguajes que generan bytecode para la JVM, tales como Jython o JRuby. Groovy puede usarse también de manera dinámica como un lenguaje de scripting.

Caracteristicas• Aunque lo parezca no es una capa superior que amplifique a Java. Se podría ejecutar un

fichero *.java con *.groovy pero no al contrario, realmente ahorra en codificación siendo más compacto.

• Soporta tipado estático y dinámico, sobrecarga de operadores lógicos, iteraciones en polimorfismo, matrices asociativas y expresiones regulares de forma nativa, además del operador '?' para navegación segura para chequeo de variables previo a errores.

Java 5+ Groovyfor (String it : new String[] {"Rod", "Carlos", "Chris"}) if (it.length() <= 4) System.out.println(it);

["Rod", "Carlos", "Chris"]. .findAll{it.size() <= 4}.each{println it}

• También soporte nativo a diversos lenguajes de etiquetas con respeto a la sintaxis DOM,

de gran utilidad para manipulación de datos heterogéneos.• No necesita precompilación, como cualquier otro lenguaje de scripts.

GroovyBeans, una versión paralela a los JavaBeans. Genera implícitamente métodos accededores y mutadores. En el siguiente código setColor(String color) y getColor() son implícitamente generados; las últimas dos lineas que parecen acceder al color directamente realmente llaman al método implícito.

Simple y consistente para el manejo de listas y asociaciones clave, valor.

class AGroovyBean { String color } def myGroovyBean = new AgroovyBean() myGroovyBean.setColor('baby blue') assert myGroovyBean.getColor() == 'baby blue' myGroovyBean.color = 'pewter' assert myGroovyBean.color == 'pewter'

Historia

James Strachan el primero en comentar sobre su desarrollo en Agosto de 2003. En 2007 estandarizado por JCP. Finalmente liberado como Groovy 1.5.

def movieList = ['Dersu Uzala', 'Ran'] // una lista assert movieList[2] == 'Seven Samurai' movieList[3] = 'Casablanca' //añade a la lista assert movieList.size() == 4 def monthMap = [ 'January':31,'March':31 ] //declara un 'map' assert monthMap['March'] == 31 //accede a una entrada monthMap['April'] = 30 //añade una entrada assert monthMap.size() == 4

Hibernate

XWiki lo usa para almacenamiento en la base relacional en que se base.Hibernate es una herramienta de Mapeo objeto-relacional para la plataforma Java (y disponible también para .Net con el nombre de NHibernate) que facilita el mapeo de atributos entre una base de datos relacional tradicional y el modelo de objetos de una aplicación, mediante archivos declarativos (XML) que permiten establecer estas relaciones.Hibernate es software libre, distribuido bajo los términos de la licencia GNU LGPL.

Características

Como todas las herramientas de su tipo, Hibernate busca solucionar el problema de la diferencia entre los dos modelos de datos coexistentes en una aplicación: el usado en la memoria de la computadora (orientación a objetos) y el usado en las bases de datos (modelo relacional). Para esto permite al desarrollador detallar cómo es su modelo de datos, qué relaciones existen y qué forma tienen. Con esta información Hibernate le permite a la aplicación manipular los datos de la base operando sobre objetos, con todas las características de la POO. Hibernate convertirá los datos entre los tipos utilizados por Java y los definidos por SQL. Hibernate genera las sentencias SQL y libera al desarrollador del manejo manual de los datos que resultan de la ejecución de dichas sentencias, manteniendo la portabilidad entre todos los motores de bases de datos con un ligero incremento en el tiempo de ejecución.Diseñado para ser flexible en cuanto al esquema de tablas utilizado, para poder adaptarse a su uso sobre una base de datos ya existente. También tiene la funcionalidad de crear la base de datos a partir de la información disponible.Ofrece también un lenguaje de consulta de datos llamado HQL (Hibernate Query Language), al mismo tiempo que una API para construir las consultas, referente a lo conocido como criteria.Hibernate para Java puede ser utilizado en aplicaciones Java independientes o en aplicaciones Java EE, mediante el componente Hibernate Annotations que implementa el estándar JPA, que es parte de esta plataforma.

Historia

Hibernate fue una iniciativa de un grupo de desarrolladores dispersos alrededor del mundo conducidos por Gavin King.Tiempo después, JBoss Inc. (empresa comprada por Red Hat) contrató a los principales desarrolladores de Hibernate y trabajó con ellos en brindar soporte al proyecto.La rama actual de desarrollo de Hibernate es la 3.x, la cual incorpora nuevas características, como una nueva arquitectura Interceptor/Callback, filtros definidos por el usuario, y —opcionalmente— el uso de anotaciones para definir la correspondencia en lugar (oconjuntamente con) los archivos XML. Hibernate 3 también guarda cercanía con la especificación EJB 3.0 (aunque apareciera antes de la publicación de dicha especificación por Java Community Process) y actúa como la espina dorsal de la implementación de EJB 3.0 en JBoss.

Lucene

Utilizado por xWiki para indexar todo el contenido de la wiki y sus adjuntos facilitando las búsquedas dentro de tales contenidos.Es un API de código abierto para recuperación de información, originalmente implementada en Java por Doug Cutting. Está apoyado por el Apache Software Foundation y se distribuye bajo la Apache Software License. Lucene tiene versiones para otros lenguajes incluyendo Delphi, Perl, C#, C++, Python, Ruby y PHP.Es útil para cualquier aplicación que requiera indexado y búsqueda a texto completo. Lucene ha sido ampliamente usado por su utilidad en la implementación de motores de búsquedas. Por ello, a veces se confunde Lucene con un motor de búsquedas con funciones de "crawling" y análisis de documentos en HTML incorporadas.El centro de la arquitectura lógica de Lucene se encuentra el concepto de Documento (Document) que contiene Campos (Fields) de texto. Esta flexibilidad permite a Lucene ser independiente del formato del fichero. Textos que se encuentran en PDFs, páginas HTML, documentos de Microsoft Word, así como muchos otros pueden ser indexados mientras que se pueda extraer información de ellos.

Nutch es un software que, sobre la base aportada por Lucene, integra todo lo que hace falta para completar un motor de búsqueda de páginas web.

Versiones

Lucene tiene o se encuentran en desarrollo de versiones para varios lenguajes de programación además de Java:

▪Lucene4c – C▪CLucene – C++▪Lucene.Net - .NET▪Pylucene – Python▪Zend Framework (búsquedas) – PHP

▪Montezuma - Lisp▪Ferret y RubyLucene - Ruby▪Plucene - Perl▪MUTIS – Delphi▪NLucene - .NET

Velocity

Apache Velocity (conocido como Jakarta Velocity) es un proyecto de código abierto dirigido por Apache Software Foundation. Es una tecnología para plantillas basada en Java que provee un lenguaje simple para plantilla que referencia a objetos definidos en código Java. Su finalidad es asegurar una clara separación entre presentación y lógica de negocio en una aplicación web (referente a patrones de diseño modelo-vista-controlador). Algunos tipos de aplicaciones que se apoyan en él son:

• Aplicaciones Web: Los diseñadores de hoy crean páginas con entornos fijos para información dinámica, estas son procesadas con VelocityViewServlet o otro de los numerosos frameworks que soportan Velocity. Este enfoque del desarrollo web es lo llamado Modelo-Vista. Controlador (MVC), esta visto a reemplazar a aplicaciones basadas en JSP o PHP.• Generación del código Fuente: Puede ser usado para generar código Java, SQL o PostScript basado en plantillas.• E-Mails automáticos: Muchas aplicaciones generan e-mails automáticamente. Con Velocity, el contenido del e-mail puede estar en un fichero como plantilla en vez de embebido en el código Java.

• Transformación XML: Velocity provee de un Ant task, llamado Anakia, la cual lee un fichero XML y lo prepara para una plantilla Velocity. Una aplicación común es convertir información de un formato xdoc genérico a HTML.

Plantilla Resultado## Velocity Hello World<html> <body> #set( $foo = "Velocity" ) ## followed by Hello $foo World! </body></html>

<html> <body> Hello Velocity World! </body></html>

Manuales oficiales de la versión XWiki Enterprise 2.2-rc-1.26699

Documentación para XWiki Enterprise• Guia de Usuario : Contiene una Guia de Inicio Rápido y una referencia a las características,

además de videos y manuales.

• Guia del programador : Tanto para insertar scripts en las páginas como para desarrollo de aplicaciones en los niveles superiores de XWiki.

• Guia del Administrador No olvidar un vistazo a Code Zone donde podemos encontrar snippets, macros, plugins, aplicaciones y extensione, y para consultas sobre esto consultar XWiki Syntax Page. Para información sobre colaboración en el proyecto XWiki, visite XWiki Development Zone.Si aun así tiene problemas use la FAQ.

CaracterísticasEdición de páginasUsando sintaxis wiki para dar formato al texto, crear tablas, enlaces... Como alternativa cuenta con un editor WYSIWYG.

Ciclo de vida de los DocumentosycleCreación, edición, renombrado, copias, impresión...

Control de versionesCualquier cambio es salvado, pudiendo visualizar versiones anteriores de las páginas, deshacer hasta determinado momento o comparaciones.

AdjuntosTantos como se quiera por cada página.

ExportacionesDe las páginas a PDF, RTF, XML o HTML.

Administración de permisosQuien puede qué y por niveles dentro de la estructura de la XWiki.

SpacesOrganizar documentos agrupándolos por dominio.

Usuarios y Grupos

ProgramaciónUso de la API Xwiki desde las páginas con Velocity o Groovy para mejoras del formato, capas o cualquier cosa.

NotificationesPara estar al dia con los cambios con feeds RSS y la utilidad Watchlist.

Aplicaciones y ExtensionesCrear aplicaciones mediante agrupación de paginas. Posibilitando su posterior importación o exportación.

Office ImporterConversores de documentos office a páginas de la wiki.

RESTful y XML/RPC APIs para uso remoto, permiten integrar XWiki con sus aplicaciones.

SkinsCompleto juego de plantillas, menús, ficheros CSS permiten alta personalización.

Integración Po rtlet Añade XWiki como JSR168 Portlet a un Portal.

InternacionalizaciónSoporta varias traducciones de los documentos y redirige automáticamente según idioma del perfil del usuario.

Soporte de Base de datosTodo el contenido de la wiki es almacenado en bases relacionales, use su SGBD.

Escalabilidad y ActuaciónXWiki soporta wikis virtuales y hasta granjas fácilmente configurables.

Estadísticas IntegradasSeguir quien lee o contribuye, los más vistos...

Plantillas para documentos y formulariosFácil con edición visual.

Atajos con tecladoWebDAVAcceder a cada uno de los adjuntos y documentos usando un cliente DAV o un explorador.

Paquete de AplicacionesXWiki es una wiki de segunda generación y como tal viene con un amplio conjunto de utilidades, y algunas más instalables.

Aplicación de Administración

Aplicación para BlogsTransforma la wiki en una bliki.

Aplicación OfficeImporterImporta documentos tipo office.

Aplicación para PanelesProvee de varios paneles colocables a derecha e izquierda o incluso flotantes, provee de un asistente en modo WYSIWYG.

Aplicación para PlanificaciónPermite planificar tareas ofreciendo un conjunto configurable de ellas, con la habilidad de cancelarlas replanificarlas o editarlas si le fuera necesario.

Aplicación de busquedaPor referencias, Spaces, o páginas pudiendo enviar los resultados por RSS.

Aplicación para estadísticas

Aplicación para tagsEtiquetación de contenidos para navegación entorno a palabras clave. También permite enlazar estos eventos a RSS.

Aplicación WatchlistPermite a los usuarios añadir Pages o Spaces a su watchlist. Permitiéndoles también suscribirse a sus notificaciones por RSS o e-mail..

Aplicación WebdavPermite la edición de adjuntos.

Aplicación puente para macros WikiPara creación de macros através de las páginas de la wiki

Guias XWiki EnterpriseXWiki Enterprise es un software para entornos empresariales que ofrece gestión de permisos, sistema de Blogs, autentificación mediante LDAP, exportación de contenidos a PDF. Provee de un completo sistema de formularios y soportes para script convirtiéndolo en un entorno de desarrollo perfecto para aplicaciones basadas en datos. También extensible en cuanto a scripting en las páginas incluso uso de plug-ins gracias a una arquitectura altamente modular.

¿Para que sirve?• Intranets.• Webs públicas. • Administración de documentación. • Necesidades básicas de administración de contenidos (CMS, Content Management System). • Proyectos de colaboración.• Portales basados en enlace de datos de fuentes externas...

Getting startedEmpezar por la Guia de Usuario para ver las características y sus uso. Luego descargar e instalar XWiki Enterprise o probarla online. Si quieres usarla como un portal mas de blogs prueba con myxwiki.org, un servicio gratuito ofrecido por XWiki SAS.

Guía de Usuario

Enlaces• Características • Animaciones • Videos

Se recomienda el uso de Playground, que es una instancia configurable de Xwiki miientras se siguen los manuales.

Podemos encontrar una lista de macros y utilidades aquí: http://code.xwiki.org/.

Conceptos básicosXWiki Enterprise está dividida en Spaces y Pages.

SpaceEs una colleción de wiki pages. Agrupar la páginas facilita:• Localizar páginas in cluso visualizarlas juntas o formar estructuras en árbol.• El software permite indizar el contenido del Space facilmente.• Se pueden ajustar los niveles dentro de los Spaces en conjunto con skins y los paneles

laterales.• Los permisos de usuario pueden establecerse a nivel de Space.• Limitar las búsquedas dentro del alcance del Space. También desde el modo de WebDAV.

La página de inicio de un Space es normalmente creada en .../SpaceName/WebHome.

PageEs una unidad básica de contenido, normalmente dividida en 4 áreas:• Barra de acciones (arriba): Permite interactuar con la página en cuestión.

• Contenido

• Paneles (derecha, izquierda o escondido.

• Area etiquetada al final del contenido:• Comentarios• Adjuntos que han sido subidos a dicha página.• Historial de la Página (cada versión) • Información del Documento (superiores e inferiores en la jerarquia del Space,

etiquetas...)

Las siguientes acciones pueden ser realizadas en una página, en función a los derechos de los usuarios:

• Editar• Usando el editor WYSIWYG, que es un editor de texto enriquecido. • Usando el editor wiki: para usuarios que manejen la sintaxis XWiki.

• Imprimir y Exportar los contenidos• Usando el menú para impresión.• Cada Page puede ser exportada a: HTML, PDF, RTF (para MS Office) y XAR (XWiki

Archive)

• Visualización• El usuario puede añadirla a su watchlist.• Siempre que haya modificaciones este será notificado.

Además los administradores podrán:

• Cambiar los derechos de acceso.• Editar los objetos y clases de las páginas. • Renombrar, copiar y borrar las páginas.

PanelesEs básicamente un marco con enlaces utiles que son colocados formando columnas.

Dos formas de controlarlos:

• Elegir columnas que se muestran (derecha, izquierda, ambas o ninguna) • Elegir que paneles estarán presentes.

Son útiles para construir menús o añadir utilidades, Puede haber un conjunto diferente de paneles en cada Space.

Primeros pasosSi eres AdministradorEn principio use estas credenciales:

• Usuario: Admin • Contraseña: admin canovas35

Recuerde cambiarla: Ir a perfil del administrador

Cambiando el logo y los panelesLas siguientes instrucciones se aplican a la mascara “toucan” (el unico con color y paneles en blanco a rayas).

Para ahondar en el tema ir a la página de mascaras y/o la guía completa sobre uso de skins en XWiki.org.

Cambiando el logoExisten varios métodos, el más simple:

• Elegir o crear una imagen.• Redimensionarla a 220x90px.• Guardarla como PNG y llamarla logo.png.• Por último subirla justo aqui. O colocarla en el directorio de la instalación y desde ahí en el de

la máscara en concreto, en este caso C:\Archivos de Programa\Apache Software Foundation\Tomcat 5.5 1.5\webapps\xwiki\skins\colibri

Cambiando el conjunto de coloresLa forma más fácil:

• Click sobre el enlace de Administración en la parte de arriba.• Click sobre el botón "Presentación".• En el campo "Página de estilos por defecto", reemplazar "style.css" y pruebe con cada uno

de estos:style-black.cssstyle-blue.css

style-darkblue.cssstyle-kaki.css

style-orange.css

style-darkgray.cssstyle-gray.css

style-green.cssstyle-purple.css

style-red.css• Click en Guardar.

Cambiando los Paneles• Click sobre el enlace Administración, en la parte de arriba.• Click sobre Asistente de Paneles.

• La pestaña Capas de página permite definir donde quieres las columnas (derecha, izquierda, ambas o ninguna).

• Click en la capa deseada y luego Salvar nueva capa.• La pestaña Lista de Paneles permite seleccionar cuales se pretenden mostrar.

• Arrastrar y soltar de la página de paneles a las columnas y entre columnas para reorganizarlos, viceversa para quitarlos.

• Luego Salvar nueva capa.

Si tiene problemas con esto use Firefox.

Crear nuevos usuariosSi está pensando en integrar LDAP para esto eche mejor un vistazo a esta página.

• Click sobre el enlace Administración, en la parte de arriba.• Click sobre Usuarios, y Añadir nuevo usuario. • Rellene los campos y Guardar

Añadirlos a gruposAgrupando usuarios será más fácil administrar sus privilegios:

• Click sobre el enlace Administración, en la parte de arriba.• Click sobre Usuarios, y Añadir nuevo usuario. • Rellene los campos y pulsar Crear grupo• Para añadirle usuarios:

• Usar el icono de la columna Editar en la fila del grupo a gestionar.• Rellenar los campos y Añadir.

Más información en administrando usuarios y grupos.

Derechos de usuarioPara más detalles.A diferentes niveles podemos censurar diferentes cosas de las cuales permiten interacuar al usuario con la XWiki:

• Click sobre el enlace Administración, en la parte de arriba.• Click en Derechos.

Aquí esta lo más básico en relación a cada elemento de la wiki.• Registro: quién permite la creación de nuevas cuentas de usuario?

• Abierto: todos pueden.• Cerrado: administradores y usuarios registrados.• Bloqueado: solo administradores pueden crear nuevas cuentas.

• Ver, comentar y editar las páginas• Editable: todos pueden.• Visible: los usuarios no registrados solo pueden ver y comentar.• Oculto: los no registrados ni siquiera pueden visualizar.• Protegido: solo administradores pueden ver y editar.

• Alcance de la protección: pueden los derechos globales se suplantados a otros niveles?• Ligero: los derechos pueden ser suplantados para usuarios no registredos a nivel de

Space o Page.• Strong: no podrán ser suplantados.

Para todos estos esquemas de seguridad dejar a los usuarios en blanco.

Wiki Abierta - Editable

Wiki Cerrada - Editable

Wiki Editable -Bloqueada

Wiki Visible - Abierta

Wiki Visible - Cerrada

Wiki Visible -Bloqueada

Wiki Oculta -Cerrada (Ligero)

Wiki Oculta – Cerrada (Fuerte)

Wiki Oculta – Bloqueada (Ligera)

Wiki Oculta – Bloqueada (Fuerte)

Wiki Protegida - Bloqueada

Si eres UsuarioLo primero será obtener las credenciales de usuario para loguearse.

Editando una página XWiki• Según la configuración habrá que logyearse para editar.• En la parte de arriba a la izquierda está el botón Edición.

• Si no se ve el botón, habrá que loguearse. Si aún así no aparece debe ser que el usuario no tiene suficientes permisos.

• Se abre una nueva página, el contenido se muestra en un editor de texto enriquecido.• A la derecha hay un enlace donde se muestran trozos de código y como resultan.

Estas páginas permiten incluir diversos tipos de contenido para variados propositos.

Creando nuevas páginas y enlacesPara los enlaces, seleccionar el texto, pulsar Enlace e indicar la ruta enlazada.Si enlazamos a páginas que aún no existen, el enlace aparecerá subrayado y nos enviara a la página en modo edición.

Page HistorySiempre que se guardan cambios se registra, así permite comparar y deshacer cambios. En el botón Ver se ofrece un desplegable con la opción History, luego podemos seleccionar y comparar tanto el contenido como los comentarios y adjuntos.Para más información ver Control de Versiones en Xwiki.org.

Guia del Administrador

Instalación Como instalar o actualizar a versión superior.

ConfiguraciónPodemos configurar XWIKI de dos formas:

• Parando la instancia de XWiki y editando el fichero xwiki/WEB-INF/xwiki.cfg, y reiniciando XWiki tras ello.

• Accediendo como usuario con privilegios de administración e ir a la página de administración (en la parte superior derecha de la página). Puedes ir directamente a través de la URL siguiente: http://gerion:8080/xwiki/bin/admin/XWiki/XWikiPreferences. Esto nos permite mantener el servidor en ejecución mientras se realizan los cambios.

AVISO: Algunas configuraciones sólo son accesibles desde el fichero xwiki.cfg y no hay nada equivalente en la página de administración.A continuación, veremos distintos apartados que pueden configurarse:

Habilitar cuentas de super-administradorEditar el fichero xwiki.cfg y habilitar la propiedad xwiki.superadminpassword. Por ejemplo:Cuando te autentiques, el usuario deberá ser superadmin y la contraseña será la que configurarás en la propiedad xwiki.superadminpassword.

Configuración de idiomaEn la página de administración, en la pestaña de preferencias, localizar el campo Default Language (Idioma por defecto) e introducir el código de idioma que se desee (“es” para español).Puede configurarse la wiki para soportar multilenguaje. Ver el siguiente enlace: I18 user page para más información.Finalmente, se puede forzar a la wiki a mostrar sólo un idioma de los especificados en la configuración, editando el fichero WEB-INF/xwiki.cfg. Busca la sección de internacionalización, y deberías ver dos configuraciones comentadas que deberías descomentar y actualizar a '1':

#-# By default, XWiki chooses the language specified by the client (browser). This#-# allows to use the default language of the wiki when the user didn't manually choose a language.# xwiki.language.preferDefault=0

#-# Force only one of the supported languages to be accepted.# xwiki.language.forceSupported=0

Formato de la fechaIr a Administración / general, más información.

MMMM dd, HH:mm Enero 27, 12:27

yyyy/MM/dd, HH:mm 2009/01/27, 12:27

dd/MM/yyyy, HH:mm 27/01/2009, 12:27

Configuración de accesoSegún su utilidad así será su política de acceso:

• Wiki Abierta : todos pueden editar.

• Public Wiki Pública : solo editan los usuarios registrados, pero el registro es libre, esta es la configuración por defecto.

• Wiki privada con password with password : el registro está restringido.

• Wiki Privada con testigos para el registro : el registro esta restringido, los usuarios disponen de un tipo de invitación.

Wiki Privada con contraseñaDerechos Globales

En Derechos globales establecer User:XWikiGuest, Groups:, Level:register, Allow-Deny:Allow.

RegistroEn Preferencias donde se indica Registro establecer Use email verification:yes. Y echar un vistazo al resto de los campos.

Más información sobre derechos de acceso

Habilitando y deshabilitando las EstadísticasPara habilitar y deshabilitar ponemos a 0 ó 1 respectivamente, los siguientes valores en el fichero xwiki.cfg

• xwiki.stats Si esta encendido o no.

• xwiki.stats.default Controla lo mismo, es útil en Wikis Virtuales posteriores. El software puede decirlo en función al valor del campo XWiki.XWikiPreferences. Si este no está definido tomará el valor de este otro.

Versiones de DocumentosEs la funcionalidad que nos permite tanto el seguimiento de la evolución de los documentos como la recuperación de estados anteriores. Por otro lado esto consume espacio, para deshabilitarlo en el fichero xwiki.cfg añadir:

xwiki.store.versioning=0

Versiones de adjuntosLas almacena por defecto, con el mismo inconveniente, para deshabilitarlo en el fichero xwiki.cfg añadir:

xwiki.store.attachment.versioning=0

Reciclaje de DocumentosPor defecto los documento borrados no son eliminados realmente. Para deshabilitarlo en el fichero xwiki.cfg añadir:

xwiki.recyclebin=0Note que deshabilitar esto le hará imposible recuperar cualquier documento si no hay una copia de respaldo de la BBDD.

Por defecto un documento borrado por un administrador es al instante, mientras que por otro tipo de usuarios se borra tras siete días. Para reajustar esto editar en el fichero xwiki.cfg:

# Admins must wait 3 days before being allowed to permanently delete xwiki.store.recyclebin.adminWaitDays=3 # Normal users must also wait 3 days xwiki.store.recyclebin.waitDays=3

Reciclaje de AdjuntosLos adjuntos borrados también van a una papelera y también pueden ser restaurados ya sea por opción o por recuperación de una versión anterior ya sea del propio adjunto o de la página a la que se adjunta. Para deshabilitarlo en el fichero xwiki.cfg añadir:

storage.attachment.recyclebin=0

Personalizar el aspectoVer la Guía para aspecto.

Configuración de la seguridadVer la Guía de Seguridad.

Personalizar los menúsLo primero a entender es que los menús dependen del aspecto que se le esté dando. Si estamos usando el Skin 1.0 es probable que la Aplicación de Paneles nos provea de diferentes paneles, siga el enlace para ver como configurarlos y/o editarlos.

Codificación Ver la Guía de Codificación.

Autenticación de usuariosVer la Guía de Autentificación.

Personalizar la página de registroLa página de registro esta definida en una plantilla (llamada registerinline.vm). Sin embargo se puede reemplazar por una página que se nombre como XWiki.Registration.Ver más detalles sobre como configurar la página de registro.

Personalizar la página de verificación del registroEsta es parte de la Aplicación de Administración y permite requerir a los usuarios rellenar algunos campo y se validen tanto en servidor como en cliente. Permite añadir campos y métodos de validación.Para habilitar el soporte validación captcha (Completely Automated Public Turing test to tell Computers and Humans Apart) hay que editar el fichero xwiki.properties, localizado en xwiki/WEB-INF/xwiki.properties, añadirle:

captcha.enabled=truePara más información ir a Aplicación de Administración.

Página de login de usuariosVer Página de inicio de sesión.

Configurando enlaces inter-wikiEnlaces Interwiki vienen dados por una simple sintaxis. Por ejemplo para enlazar a http://en.wikipedia.org/wiki/InterWiki le indicamos [InterWiki@WikiPedia].XWiki renderiza la sintaxis Xwiki con la tecnologia Radeox, soporta estos enlaces y otros de la misma manera que SnipSnap .Para configurarlos:

• Crear un fichero llamado [lugar donde empiece su contenedor]/conf/intermap.txt• Rellene conf/intermap.txt con lineas como:

IMDB http://us.imdb.com/Title? OpenWiki http://openwiki.com/? SourceForge http://sourceforge.net/ TWiki http://twiki.org/cgi-bin/view/ Why http://clublet.com/c/c/why? Wiki http://c2.com/cgi/wiki? WikiPedia http://www.wikipedia.com/wiki/

• Para añadir entradas propias:

• El análisis de sintaxis de Radeox es muy frágil, una linea de más puede dejarlo fuera de juego.

• Reiniciar XWiki, como cada vez que se realice un cambio. Si no funciona puede echar un vistazo a xwiki.log.

Establecer el editor por defecto – Sintaxis XWiki o WYSIWYGIr a la pantalla de Administración, en General podrá seleccionarlo

Configurar el editor tipo WYSIWYGVer Editor WYSIWYG para ver como habilitar y deshabilitar sus herramientas.

Usar URLs cortasEs posible configurar Xwiki para esto.

Reorganizar los esquemas de la BBDDEspecialmente en entornos empresariales pueden incluso hacer falta más de los preestablecidos.

• xwiki.db - nombre del esquema principal de la wiki.

• xwiki.db.prefix – útil con wikis virtuales, donde tendremos un esquema por cada una. Estos prefijos son añadidos a los esquemas tras el mapeo entre wikis y esquemas, también aplicable a la BBDD de la wiki principal.

Deshabilitar comentarios y adjuntosHabrá que editar la clase XWiki.XWikiPreferences:

• Ir a <server>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=class• Añadir una nueva propiedad showcomments o showattachments (para poner en off) de tipo

String Class

<server>/xwiki/bin/edit/XWiki/XWikiPreferences?editor=object&classname=XWiki.XWikiPreferences# - # and write no | yes in the showcomments or showattachments field

Comportamiento del editor de comentariosDurante la edición de páginas tenemos un marco para comentarios, ver Edición de páginas. Para deshabilitarlo establecer xwiki.editcomment=0 en xwiki.cfg.Si habilitado, en xwiki.cfg estableciendo xwiki.editcomment.mandatory=1 forzará al usuario editor a realizar un comentario, para que sea posible dejarlo en blanco deberemos indicar en el mismo fichero xwiki.editcomment.suggested=1.Si dejó activos algunos de estos modos, puede igualmente ocultar el recuadro del comentario con xwiki.editcomment.hidden=0 en xwiki.cfg, lo cual provocará que salte luego trás la edición de tal página en modo ventana flotante.Para esto también tenemos ciertos campos en el objeto XWikiPreferences en vez de editar xwiki.cfg. Estos campos son: editcomment, editcomment_mandatory, editcomment_suggested y editcomment_hidden.

Uso del servido SMTPSi se pretende usar la funcionalidad de envío de correos será necesario indicarle algunos datos como el puerto, servidor y cuenta.Para esto ir a https://gerion:8080/xwiki/bin /admin/XWiki/XWikiPreferences , click en general e indicar estos datos.

Configurar la autentificación por SMTPEstas instrucciones están ahora obsoletas.Por defecto los campos usuario/contraseña no están disponibles en la Preferencias. Para ésto:

• Editar la clase XWiki.XWikiPreferences en /xwiki/bin/edit/XWiki/XWikiPreferences?editor=class añadiendo dos campos, tipo String, llamados smtp_server_username y smtp_server_password.

• Editar el objeto XWiki.XWikiPreferences en /xwiki/bin/edit/XWiki/XWikiPreferences?editor=object&classname=XWiki.XWikiPreferences&nb=0&property=smtp_server_username,smtp_server_password e introducir tales datos en los recién añadidos campos.

Configurando TLS para la conexión al servidorEstas instrucciones también están obsoletas.Para habilitar TLS se debe:

• Editar la clase XWiki.XWikiPreferences en /xwiki/bin/edit/XWiki/XWikiPreferences?editor=class y añadir un campo tipo TextArea llamado javamail_extra_props

• Editar el objeto XWiki.XWikiPreferences en /xwiki/bin/edit/XWiki/XWikiPreferences?editor=object&classname=XWiki.XWikiPreferences&nb=0&property=javamail_extra_props e introducir: mail.smtp.starttls.enable=true.

Configurando WebDAV (desde 1.7)Está habilitado por defecto.

Asegurando el servicio WebDAVLa implementación de WebDAV solo soporta un esquema de Autentificación de acceso básica a los clientes WebDAV, por esto es altamente recomendable el uso de SSL, hay que consultar la documentación de su contenedor para aplicaciones web.

Deshabilitar WebDAVEditar el fichero web.xml eliminando el elemento de mapeo de URLs que solicitan servicio WebDAV. Similar al siguiente:

<servlet-mapping><servlet-name>webdav</servlet-name><url-pattern>/webdav/*</url-pattern></servlet-mapping>

RedireccionesXWiki soporta definición de redirecciones para solicitudes entrantes. Para activarlo en xwiki.cfg establecer:

xwiki.preferences.redirect=1Luego para cada redirección que se quiera añadir en el fichero XWiki.XWikiPreferences principal incluir un objeto XWiki.GlobalRedirect. Estos objetos tienen dos campos, pattern y destination. La URL recibida se mapea al valor de lo indicado en destination.

Configuración de la sintaxis XWiki y cual por defectoEn xwiki.cfg ir a la propiedad xwiki.rendering.syntaxes y core.defaultDocumentSyntax (desde XWiki Enterprise 1.8):

xwiki.rendering.syntaxes = xwiki/1.0, xwiki/2.0, confluence/1.0, jspwiki/1.0, creole/1.0, mediawiki/1.0, xhtml/1.0, twiki/1.0core.defaultDocumentSyntax = xwiki/2.0

Personalizando la exportación a PDFEn el futuro querremos reeditar el exportador a PDF como renderizadores en el nuevo Módulo de Renderización.

De momento tenemos tres partes ajustables:• El CSS utilizado para renderizar el contenido de la página a exportar como PDF/RTF• La transformación XHTML2FO XSL.• La transformación FOP XSL

El siguiente esquema muestra como trabaja actualmente:

Empezamos por crear una nueva clase XWiki. Simplemente creando una nueva página en modo Class (por ejemplo http:/gerion:8080/xwiki/bin/edit/XWiki/PDFClass?editor=class). Añadirle tantos Text Area como sean necesarios:

• style: contienen la información CSS que se usará en vez de los valores del, por defecto, pdf.css.

• xhtmlxsl: contienen la información XHTML a FO XSL que se usará en vez de los valores por defecto.

• fopxsl: contienen la información FOP a PDF/RTF XSL que se usarán en vez de los valores por defecto.

Entonces crear una otra página, Xwiki.PDFTemplate, y añadirle el objeto XWiki.PDFClass.Por último, cuando la página llame al exportador a PDF debe usar el parámetro tal que así: http://gerion:8080/xwiki/bin/export/Space/Page?format=pdf&language=en&pdftemplate=XWiki.PDFTemplate.

Incluso en la exportación a RTF funciona, excepto en algunos detalles referentes a como CSS trata a la capa final.

Nota: Cuando editemos código CSS no debemos dejar nunca espacios en blanco entre las reglas, esto viene en relación al encargado de renderizar dichos ficheros.

h2 { margin-left: 2cm; margin-bottom: 1cm; color: red;}h3 { margin: 3cm; color: yellow;}

h2 { margin-left: 2cm; margin-bottom: 1cm; color: red;}

h3 { margin: 3cm; color: yellow;}

Ejemplo de xwiki.cfg

#-# Default value is xwiki/1.0.core.defaultDocumentSyntax = xwiki/2.0</tt></div><div class="box warningmessage">Hint: If it doesn't work check that you've edited the correct configuration file.</div><h1 id="HSamplexwikicfg"><span>Sample xwiki.cfg</span></h1><div class="box code"><tt class="wikimodel-verbatim">#---------------------------------------# Preamble## This is the main old XWiki configuration file. Commented parameters show the default value, #-# although some features# might be disabled. To customize, uncomment and put your own value instead.

#---------------------------------------# General wiki settings##-# When the wiki is readonly, any updates are forbidden. To mark readonly, use one of: yes, 1, true# xwiki.readonly=no

#-# [Since 1.6RC1] Defines the list of supported syntaxes#-# Available syntaxes are: #-# xwiki/1.0, xwiki/2.0, confluence/1.0, jspwiki/1.0, creole/1.0, mediawiki/1.0,#-# twiki/1.0, xhtml/1.0, html/4.01, plain/1.0xwiki.rendering.syntaxes = xwiki/1.0, xwiki/2.0

#-# List of groups that a new user should be added to by default after registering. #-# Comma-separated list of group document#-# names.# xwiki.users.initialGroups=XWiki.XWikiAllGroup

#-# Should all users be considered members of XWiki.XWikiAllGroup, even if they don't have #-# an associated object in the#-# group's document?# xwiki.authentication.group.allgroupimplicit=0

#-# Uncomment if you want to ignore requests for unmapped actions, and simply display the document# xwiki.unknownActionResponse=view

#-# The encoding to use when transformin strings to and from byte arrays. This causes the#-# jvm encoding to be ignored,#-# since we want to be independend of the underlying system.xwiki.encoding=UTF-8

#-# This parameter will activate the sectional editing.xwiki.section.edit=1

#-# This parameter controls the depth of sections that have section editing.#-# By default level 1 and level 2 sections have section editing.xwiki.section.depth=2

#-# Enable backlinks storage, which increases the update time, but allows to keep track#-# of inter document links.xwiki.backlinks=1

#-# Enable document tags.xwiki.tags=1

#---------------------------------------# Storage##-# Role hints that differentiate implementations of the various storage components. #-# To add a new implementation for one#-# of the storages, implement the appropriate interface and declare it in a components.xml#-# file (using a role-hint other#-# than 'default') and put its hint here.##-# The main (documents) storage.# xwiki.store.main.hint=default#-# The attachment storage.# xwiki.store.attachment.hint=default#-# The document versioning storage.# xwiki.store.versioning.hint=default#-# The attachment versioning storage. Use 'void' to disable attachment versioning.# xwiki.store.attachment.versioning.hint=default#-# The document recycle bin storage.# xwiki.store.recyclebin.hint=default#-# The attachment recycle bin storage.# xwiki.store.attachment.recyclebin.hint=default

#-# Whether the document recycle bin feature is activated or not# xwiki.recyclebin=1#-# Whether the attachment recycle bin feature is activated or not# storage.attachment.recyclebin=1#-# Whether the document versioning feature is activated or not# xwiki.store.versioning=1#-# Whether the attachment versioning feature is activated or not# xwiki.store.attachment.versioning=1#-# Whether the attachments should also be rolled back when a document is reverted.# xwiki.store.rollbackattachmentwithdocuments=1

#-# The path to the hibernate configuration file.# xwiki.store.hibernate.path=/WEB-INF/hibernate.cfg.xml

#-# Whether to update the database schema on startup. Useful when upgrading XWiki. as the mapping #-# could change between#-# versions, and this allows to automatically update the database. Should be disabled (=0) #-# during normal operation to#-# improve the startup time.# xwiki.store.hibernate.updateschema=1

#-# Allow or disable custom mapping for particular XClasses. Custom mapping may #-# increase the performance of certain#-# queries when large number of objects from particular classes are used in the wiki.# xwiki.store.hibernate.custommapping=1#-# Dynamic custom mapping.# xwiki.store.hibernate.custommapping.dynamic=0#-# Put a cache in front of the document store. This greatly improves performance #-# at the cost of memory consumption.#-# Disable only when memory is critical.# xwiki.store.cache=1

#-# Maximum number of documents to keep in the cache.# xwiki.store.cache.capacity=100

#-# [Since 1.6M1]#-# Force the database name for the main wiki in virtual mode and for the wiki itself in non virtual mode.# xwiki.db=xwiki

#-# [Since 1.6M1]#-# Add a prefix to all databases names of the wikis in virtual mode and to the wiki name in non virtual mode.# xwiki.db.prefix=

#---------------------------------------# Data migrations## Similar to schema updates, this manipulates the actual data, and not just the layout of the database. Useful #-# for migrating data to new formats, correct errors introduced in older versions, or even #-# for schema updates that are not handled by velocity.

#-# Whether migrations are enabled or not. Should be enabled when upgrading, but for#-# a better startup time it is better to#-# disable them in production.xwiki.store.migration=1

#-# Migration manager class. The default works with a Hibernate storage.# xwiki.store.migration.manager.class=com.xpn.xwiki.store.migration.hibernate.XWikiHibernateMigrationManager

#-# Whether to exit after migration. Useful when a server should handle migrations for a#-# large database, without going#-# live afterwards.# xwiki.store.migration.exitAfterEnd=0

#-# Indicate the list of databases to migrate.#-# to upgrade all wikis database set xwiki.store.migration.databases=all#-# to upgrade just some wikis databases set xwiki.store.migration.databases=xwiki,wiki1,wiki2#-# Note: the main wiki is always migrated whatever the configuration.# xwiki.store.migration.databases=

#---------------------------------------# Internationalization##-# By default, XWiki chooses the language specified by the client (browser) in the Accept-Language #-# HTTP header. This#-# allows to use the default language of the wiki when the user didn't manually choose a language.# xwiki.language.preferDefault=0

#-# Force only one of the supported languages to be accepted.# xwiki.language.forceSupported=0

#---------------------------------------# Virtual wikis (farm)##-# This parameter allows XWiki to operate in Hosting mode allowing to create multiple wikis having their own#-# database and responding to different URLsxwiki.virtual=0

#-# URL to redirect to when a requested wiki does not exist. This should be changed to a real page.xwiki.virtual.redirect=http://127.0.0.1:9080/xwiki/bin/Main/ThisWikiDoesNotExist

#-# Forbidden names that should not be allowed when creating a new wiki.# xwiki.virtual.reserved_wikis=

#-# How virtual wikis are mapped to different URLs. If set to 0 (the default), #-# then virtual wikis have different domain#-# names, in the format http://wikiname.myfarm.net/. If set to 1, then the domain is #-# common for the entire farm, but the#-# path contains the wiki name, in the format http://myfarm.net/xwiki/wiki/wikiname/.

#-# Note that you can configure the "/wiki/" part with xwiki.virtual.usepath.servletpath property.# xwiki.virtual.usepath=0

#-# Configure the servlet action identifier for url path based multiwiki. It has also to be#-# modified in web.xml.# xwiki.virtual.usepath.servletpath=wiki

#---------------------------------------# URLs##-# The domain name to use when creating URLs to the default wiki. If set, the generated URLs will #-# point to this server#-# instead of the requested one. It should contain schema, domain and (optional) port, and the#-# trailing /. For example:#-# xwiki.home=http://www.xwiki.org/#-# xwiki.home=http://wiki.mycompany.net:8080/# xwiki.home=

#-# The name of the default URL factory that should be used.# xwiki.urlfactory.serviceclass=com.xpn.xwiki.web.XWikiURLFactoryServiceImpl

#-# Force the protocol to use in the generated URLs. The right value is taken from the request URL, #-# so setting this#-# is not recommended in most cases.#-# For example:#-# xwiki.url.protocol=https# xwiki.url.protocol=

#-# The name of the webapp to use in the generated URLs. The right value is taken from the #-# request URL, so setting this#-# is not recommended in most cases. If set, the value should contain a trailing /, but not a #-# leading one. For example:#-# xwiki.webapppath=xwiki/# xwiki.webapppath=

#-# The default servlet mapping name to use in the generated URLs. The right value is taken from the request #-# URL preserving the requested servlet mapping, so setting this is not recommended in most cases.#-# If set, the value should contain a trailing /, but not a leading one. For example:#-# xwiki.servletpath=bin/# xwiki.servletpath=

#-# The fallback servlet mapping name to use in the generated URLs. Unlike xwiki.servletpath, this is the #-# value used when#-# the correct setting could not be determined from the request URL. A good way to use this setting#-# is to achieve short#-# URLs, see http://platform.xwiki.org/xwiki/bin/Main/ShortURLs# xwiki.defaultservletpath=bin/

#-# Whether the /view/ part of the URL should be included if the target action is 'view'.# xwiki.showviewaction=1

#-# The name of the default space. This is displayed when the URL specifies a document,#-# but not a space, or neither.# xwiki.defaultweb=Main

#-# Hide the /Space/ part of the URL when the space is the default one. Warning: use 1 to hide, 0 to show.# xwiki.usedefaultweb=0

#-# The name of the default page of a space. This is displayed when the URL specifies a

#-# space, but not a document, or neither.# xwiki.defaultpage=WebHome

#-# Hide the /WebHome part of the URL when the document is the default one. Use 0 to hide, 1 to show.# xwiki.usedefaultaction=0

#---------------------------------------# Users#xwiki.inactiveuser.allowedpages=

#---------------------------------------# Authentication and authorization##-# Enable to allow superadmin. It is disabled by default as this could be a#-# security breach if it were set and you forgot about it. Should only be enabled#-# for recovering the Wiki when the rights are completely messed.# xwiki.superadminpassword=system

#-# Authentication type. You can use 'basic' to always use basic authentication.# xwiki.authentication=form

#-# Indicate if the authentication has do be done for each request#-# 0: the default value, authentication is done only once by session.#-# 1: the authentication is done for each request. # xwiki.authentication.always=0

#-# Cookie encryption keys. You SHOULD replace these values with any random string,#-# as long as the length is the same.xwiki.authentication.validationKey=totototototototototototototototoxwiki.authentication.encryptionKey=titititititititititititititititi

#-# Comma separated list of domains for which authentication cookies are set. This#-# concerns mostly wiki farms. The exact meaning is that when a user logs in, if#-# the current domain name corresponding to the wiki ends with one of the entries#-# in this parameter, then the cookie is set for the larger domain. Otherwise, it#-# is set for the exact domain name of the wiki.#-##-# For example, suppose the cookiedomains is set to "mydomain.net". If I log in#-# on wiki1.xwiki.com, then the cookie will be set for the entire mydomain.net#-# domain, and if I visit wiki2.xwiki.com I will still be authenticated. If I log#-# in on wiki1.otherdomain.net, then I will only be authenticated on#-# wiki1.otherdomain.net, and not on wiki2.otherdomain.net.#-##-# So you need this parameter set only for global authentication in a#-# farm, there's no need to specify your domain name otherwise.#-##-# Example: xwiki.authentication.cookiedomains=xwiki.org,myxwiki.orgxwiki.authentication.cookiedomains=#-# This allows logout to happen for any page going through the /logout/ action, regardless#-# of the document or the servlet.#-# Comment-out if you want to enable logout only for /bin/logout/XWiki/XWikiLogout#-# Currently accepted patterns:#-# - /StrutsServletName/logout/ (this is usually /bin/logout/ and is the default setup)#-# - /logout/ (this works with the short URLs configuration)#-# - /wiki/SomeWikiName/logout/ (this works with path-based virtual wikis)xwiki.authentication.logoutpage=(/|/[^/]+/|/wiki/[^/]+/)logout/*

#-# The group management class.# xwiki.authentication.groupclass=com.xpn.xwiki.user.impl.xwiki.XWikiGroupServiceImpl

#-# Default value for exo:# xwiki.authentication.groupclass=com.xpn.xwiki.user.impl.exo.ExoGroupServiceImpl

#-# The authentication management class.# xwiki.authentication.authclass=com.xpn.xwiki.user.impl.xwiki.XWikiAuthServiceImpl#-# Default value for exo:# xwiki.authentication.authclass=com.xpn.xwiki.user.impl.exo.ExoAuthServiceImpl#-# Default value for LDAP:# xwiki.authentication.authclass=com.xpn.xwiki.user.impl.LDAP.XWikiLDAPAuthServiceImpl

#-# The authorization management class.# xwiki.authentication.rightsclass=com.xpn.xwiki.user.impl.xwiki.XWikiRightServiceImpl

#-# If an unauthenticated user (guest) tries to perform a restricted action, by default the#-# wiki redirects to the login#-# page. Enable this to simply display an "unauthorized" message instead, to hide the login form.# xwiki.hidelogin=false

#-# HTTP status code to sent when the authentication failed.xwiki.authentication.unauthorized_code=200

#---------------------------------------# Rendering##-# Disable particular renderers (in the old rendering engine).#-# Macro mapping# xwiki.render.macromapping=1#-# Velocity interpreter# xwiki.render.velocity=1#-# Groovy interpreter# xwiki.render.groovy=1#-# Plugin rendering# xwiki.render.plugin=1#-# Radeox wiki renderer# xwiki.render.wiki=1#-# Simple wiki syntax rendering # xwiki.render.wikiwiki=0

#-# Maximum number of documents to keep in the rendered cache# xwiki.render.cache.capacity=100

#-# Default target for external links. Use _blank to open external links in a new tab/window.# xwiki.render.externallinks.defaulttarget=

#---------------------------------------# Editing##-# Minor edits don't participate in notifications.# xwiki.minoredit=1#-# Use edit commentsxwiki.editcomment=1

#-# Hide editcomment field and only use Javascript# xwiki.editcomment.hidden=0

#-# Make edit comment mandatoryxwiki.editcomment.mandatory=0

#-# Make edit comment suggested (asks 1 time if the comment is empty.#-# 1 shows one popup if comment is empty.

#-# 0 means there is no popup.#-# This setting is ignored if mandatory is set# xwiki.editcomment.suggested=0

#-------------------------------------------------------------------------------------# LDAP#-------------------------------------------------------------------------------------#-# new LDAP authentication service# xwiki.authentication.authclass=com.xpn.xwiki.user.impl.LDAP.XWikiLDAPAuthServiceImpl

#-# Turn LDAP authentication on - otherwise only XWiki authentication#-# 0: disable#-# 1: enable# xwiki.authentication.ldap=1

#-# LDAP Server (Active Directory, eDirectory, OpenLDAP, etc.)xwiki.authentication.ldap.server=127.0.0.1xwiki.authentication.ldap.port=389

#-# LDAP login, empty = anonymous access, otherwise specify full dn#-# {0} is replaced with the username, {1} with the passwordxwiki.authentication.ldap.bind_DN=cn={0},department=USER,department=INFORMATIK,department=1230,o=MPxwiki.authentication.ldap.bind_pass={1}

#-# Force to check password after LDAP connection#-# 0: disable#-# 1: enablexwiki.authentication.ldap.validate_password=0

#-# only members of the following group will be verified in the LDAP#-# otherwise only users that are found after searching starting from the base_DN# xwiki.authentication.ldap.user_group=cn=developers,ou=groups,o=MegaNova,c=US

#-# [Since 1.5RC1, XWikiLDAPAuthServiceImpl]#-# only users not member of the following group can autheticate# xwiki.authentication.ldap.exclude_group=cn=admin,ou=groups,o=MegaNova,c=US

#-# base DN for searchesxwiki.authentication.ldap.base_DN=

#-# Specifies the LDAP attribute containing the identifier to be used as the XWiki name (default=cn)# xwiki.authentication.ldap.UID_attr=cn

#-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]#-# Specifies the LDAP attribute containing the password to be used "when#-# xwiki.authentication.ldap.validate_password" is set to 1# xwiki.authentication.ldap.password_field=userPassword

#-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]#-# The potential LDAP groups classes. Separated by commas.# xwiki.authentication.ldap.group_classes=group,groupOfNames, \ groupOfUniqueNames,dynamicGroup,dynamicGroupAux,groupWiseDistributionList

#-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]#-# The potential names of the LDAP groups fields containings the members. Separated by commas. # xwiki.authentication.ldap.group_memberfields=member,uniqueMember

#-# retrieve the following fields from LDAP and store them in the XWiki user object #-# (xwiki-attribute=ldap-attribute)

xwiki.authentication.ldap.fields_mapping=last_name=sn,first_name=givenName,email=mail

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]#-# on every login update the mapped attributes from LDAP to XWiki otherwise this happens only #-# once when the XWiki account is created.xwiki.authentication.ldap.update_user=1

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]#-# mapps XWiki groups to LDAP groups, separator is "|"# xwiki.authentication.ldap.group_mapping=XWiki.XWikiAdminGroup=cn=AdminRole,ou=groups,o=MegaNova,c=US|\# XWiki.Organisation=cn=testers,ou=groups,o=MegaNova,c=US

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]#-# time in s after which the list of members in a group is refreshed from LDAP (default=3600*6)# xwiki.authentication.ldap.groupcache_expiration=21800

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]#-# - create : synchronize group membership only when the user is first created#-# - always: synchronize on every login# xwiki.authentication.ldap.mode_group_sync=always

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]#-# if ldap authentication fails for any reason, try XWiki DB authentication #-# with the same credentialsxwiki.authentication.ldap.trylocal=1

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]#-# SSL connection to LDAP server#-# 0: normal#-# 1: SSL# xwiki.authentication.ldap.ssl=0

#-# [Since 1.3M2, XWikiLDAPAuthServiceImpl]#-# The keystore file to use in SSL connection# xwiki.authentication.ldap.ssl.keystore=

#-# [Since 1.5M1, XWikiLDAPAuthServiceImpl]#-# The java secure provider used in SSL connection# xwiki.authentication.ldap.ssl.secure_provider=com.sun.net.ssl.internal.ssl.Provider

#---------------------------------------# Cache# [DEPRECATED since 1.7M1: this way to configure cache provider is deprecated, you should #-# use xwiki.properties instead.]#---------------------------------------#-# [Since 1.5M2]#-# The cache component implementation to use as "normal" (can be local or distributed #-# depending on the implementation) cache component.# xwiki.cache.cachefactory.hint=jbosscache#-# [Since 1.5M2]#-# The cache component to use as local cache component. # xwiki.cache.cachefactory.local.hint=jbosscache/local

#---------------------------------------# WYSIWYG Editor configuration##-# You can configure the toolbars you wish to see in the WYSIWYG editor by defining the#-# xwiki.wysiwyg.toolbars property.#-# When not defined it defaults to:# xwiki.wysiwyg.toolbars=texttoolbar, listtoolbar, indenttoolbar, undotoolbar, titletoolbar, \

# styletoolbar, horizontaltoolbar, attachmenttoolbar, macrostoolbar, \# tabletoolbar, tablerowtoolbar, tablecoltoolbar, linktoolbar

#-# The full list of toolbars includes the one defined above and the following ones:#-# subtoolbar, findtoolbar, symboltoolbar

#---------------------------------------# Skins &amp; Templates configuration##-# The default skin to use when there's no value specified in the wiki preferences document.#-# Note that the default#-# wiki already specifies a skin, so this setting is only valid for empty wikis.xwiki.defaultskin=colibri

#-# The default base for skins that don't specify a base skin. This is also the last place where#-# a skin file is searched#-# if not found in the more specific skins.xwiki.defaultbaseskin=albatross

#-# Defines whether title handling should be using the compatibility mode or not. When the compatibility#-# mode is active, if the document's content first header (level 1 or level 2) matches the document's title#-# the first header is stripped.xwiki.title.compatibility=1

#---------------------------------------# Extensions#

#-# List of active plugins.xwiki.plugins=\ com.xpn.xwiki.monitor.api.MonitorPlugin,\ com.xpn.xwiki.plugin.skinx.JsSkinExtensionPlugin,\ com.xpn.xwiki.plugin.skinx.JsSkinFileExtensionPlugin,\ com.xpn.xwiki.plugin.skinx.CssSkinExtensionPlugin,\ com.xpn.xwiki.plugin.skinx.CssSkinFileExtensionPlugin,\ com.xpn.xwiki.plugin.feed.FeedPlugin,\ com.xpn.xwiki.plugin.ldap.LDAPPlugin,\ com.xpn.xwiki.plugin.google.GooglePlugin,\ com.xpn.xwiki.plugin.flickr.FlickrPlugin,\ com.xpn.xwiki.plugin.mail.MailPlugin,\ com.xpn.xwiki.plugin.packaging.PackagePlugin,\ com.xpn.xwiki.plugin.query.QueryPlugin,\ com.xpn.xwiki.plugin.svg.SVGPlugin,\ com.xpn.xwiki.plugin.charts.ChartingPlugin,\ com.xpn.xwiki.plugin.fileupload.FileUploadPlugin,\ com.xpn.xwiki.plugin.image.ImagePlugin,\ com.xpn.xwiki.plugin.userdirectory.UserDirectoryPlugin,\ com.xpn.xwiki.plugin.usertools.XWikiUserManagementToolsImpl,\ com.xpn.xwiki.plugin.zipexplorer.ZipExplorerPlugin,\ com.xpn.xwiki.plugin.autotag.AutoTagPlugin,\ com.xpn.xwiki.plugin.lucene.LucenePlugin,\ com.xpn.xwiki.plugin.diff.DiffPlugin,\ com.xpn.xwiki.plugin.rightsmanager.RightsManagerPlugin,\ com.xpn.xwiki.plugin.jodatime.JodaTimePlugin,\ com.xpn.xwiki.plugin.scheduler.SchedulerPlugin,\ com.xpn.xwiki.plugin.mailsender.MailSenderPlugin,\ com.xpn.xwiki.plugin.activitystream.plugin.ActivityStreamPlugin, \ com.xpn.xwiki.plugin.watchlist.WatchListPlugin, \ com.xpn.xwiki.wysiwyg.server.plugin.WysiwygPlugin, \ com.xpn.xwiki.plugin.tag.TagPlugin

#-# Enable light monitoring of the wiki performance. Records various statistics, like #-# number of requests processed,#-# time spent in rendering or in the database, medium time for a request, etc. Disable for a #-# minor increase of performance and a bit of memory.# xwiki.monitor=1

#-# Maximum number of last requests to remember.# xwiki.monitor.lastlistsize=20

#-# Stats configuration allows to globally activate/deactivate stats module (launch storage thread, #-# register events...).#-# Enabled by default.# xwiki.stats=1

#-# When statistics are globally enabled, storage can be enabled/disabled by wiki using the XWikiPreference property "statistics".#-# Note: Statistics are disabled by default for improved performances/space.xwiki.stats.default=0

#-# It is also possible to choose a different stats service to record statistics separately from XWiki.# xwiki.stats.class=com.xpn.xwiki.stats.impl.XWikiStatsServiceImpl

#-# This parameter will activate the eXo Platform integrationxwiki.exo=0

#-# GraphViz plugin configuration. The GraphViz plugin is not configured by default.#-# To enable it, add "com.xpn.xwiki.plugin.graphviz.GraphVizPlugin" to the list of plugins#-# in the xwiki.plugins property.#-# Uncomment and set the locations of the Dot and Neato executables# xwiki.plugin.graphviz.dotpath=c:/Program Files/ATT/GraphViz/bin/dot.exe# xwiki.plugin.graphviz.neatopath=c:/Program Files/ATT/GraphViz/bin/neato.exe

xwiki.plugin.laszlo.baseurl=/openlaszlo/xwiki/xwiki.plugin.laszlo.path=c:/Program Files/Apache Software Foundation/Tomcat 5.0/webapps/openlaszlo/xwiki/

xwiki.plugin.image.cache.capacity=30

#-# Calendar Prev/Next Month bounds.#-# The calendar generates links to the previous/next months for a limited range, by default 6 #-# months back and 12 months#-# after. A value of 0 means that there is no limit in that direction.# xwiki.calendar.bound.prev=6# xwiki.calendar.bound.next=12

#-# Lucene search engine#-# Location where to place the lucene index files. The default is the "lucene" subdirectory in the container's "work"#-# diectory. Change it if you want to store indexes in another place.# xwiki.plugins.lucene.indexdir=/usr/local/xwiki/lucene#-# The text analyzer to use for indexing.# xwiki.plugins.lucene.analyzer=org.apache.lucene.analysis.standard.StandardAnalyzer

#-# The number of seconds to wait between reindexes. A smaller value ensures that new documents #-# will be indexed faster,#-# but with a minor performance reduction. Adjust according to your wiki load.# xwiki.plugins.lucene.indexinterval=20

#-# The maximum size of the indexing queue. After this limit is reached, the reindex thread #-# will have to wait until the#-# queue is consumed. Note that this does not affect documents submitted through the notification

#-# mechanism, only the#-# full reindex option.# xwiki.plugins.lucene.maxQueueSize=1000

#-# [Since 2.0RC1]#-# Activity Stream plugin. #-# The Activity Stream plugin stores data in a dedicated table in the database. In virtual mode #-# each wiki has it's own database, the plugin can be configured to store its data into the database#-# corresponding to the wiki, into the main #-# database (default: xwiki) or both. If the wiki is not running in virtual mode these options#-# will not have any #-# effect. These options should not be both set to 0 (in this case the local store will be forced).#-# Important note: disabling storage in the main store will prevent the watchlist from retrieving#-# events from subwikis.#-##-# Default: 1 # xwiki.plugin.activitystream.uselocalstore=1#-##-# Default: 1# xwiki.plugin.activitystream.usemainstore=1

#-# Number of days the events should be kept (0 or any negative value: infinite duration)#-# Note: if this value is greater than 0 a scheduler job will be created, this job will then be #-# fired every week to#-# delete events older than the configured value.#-# Default: 0# xwiki.plugin.activitystream.daystokeepevents=0

#---------------------------------------# Misc##-# Temporary directory where XWiki can put files (during exort and upload, for example).# xwiki.temp.dir=/tmp/xwiki#-# XWiki work directory# xwiki.work.dir=/usr/local/xwiki

xwiki.work.dir=work

Ejemplo de xwiki.properties# This is the new XWiki configuration file. In the future it'll replace the old# xwiki.cfg file. However right now it's only used by some XWiki components.# As time progresses more and more component will get their configurations from# this file.

#-------------------------------------------------------------------------------------# Core#-------------------------------------------------------------------------------------

#-# [Since 1.8RC2]#-# Specifies the default syntax to use when creating new documents.#-# Default value is xwiki/2.0.core.defaultDocumentSyntax = xwiki/2.0

#-------------------------------------------------------------------------------------# Rendering#-------------------------------------------------------------------------------------

#-# [Since 1.8RC2]#-# Specifies how links labels are displayed when the user doesn't specify the label explicitely.#-# Valid values:#-# %w: wiki name #-# %s: space name#-# %p: page name#-# %P: page name with spaces between camel case words, i.e. "My Page" if#-# the page name is "MyPage"

#-# %t: page title#-##-# Note that if the page title is empty or not defined then it defaults to %p. #-# This is also the case if the title cannot be retrieved for the document.#-##-# The default is "%p". Some examples: "%s.%p", "%w:%s.%p".# rendering.linkLabelFormat = %p

#-# [Since 2.0M3]#-# Overrides default macro categories (Each macro has a default category already defined,#-# for example "presentation" for the Table of Contents Macro).#-##-# Ex: To redefine the macro category for the TOC macro so that it'd be in #-# the "My Category" category + redefine the category for the Script Macro to #-# be "My Other Category", you'd use:# rendering.macroCategories = toc:My Category# rendering.macroCategories = script:My Other Category

#-------------------------------------------------------------------------------------# Cache#-------------------------------------------------------------------------------------

#-# [Since 1.7M1]#-# The standard cache component implementation to use (can be local or distributed #-# depending on the implementation).#-# The default standard cache implementation is JBoss Cache.# cache.defaultCache=jbosscache

#-# [Since 1.7M1]#-# The local cache implementation to use.#-# The default local cache implementation is JBoss Cache.# cache.defaultLocalCache=jbosscache/local

#----------------------------------------------------------------------------------# Settings for the OpenOffice server instance consumed by the OfficeImporter plugin#----------------------------------------------------------------------------------

#-# [Since 1.9M2]#-# Type of the openoffice server instance used by officeimporter plugin.#-# 0 - Internally managed server instance. (Default)#-# 1 - Externally managed (local) server instance.# openoffice.serverType=0

#-# [Since 1.9M2]#-# Port number used for connecting to the openoffice server instance.#-# Default port is 8100# openoffice.serverPort=8100

#-# [Since 1.9M2]#-# If the openoffice server should be started / connected upon XE start.#-# Default value is false# openoffice.autoStart=false

#-# [Since 1.8RC3]#-# Path to openoffice installation (serverType:0 only).#-# If no path is provided, a default value will be calculated based on the operating environment.# openoffice.homePath=/opt/openoffice.org3/

#-# [Since 1.8RC3]#-# Path to openoffice execution profile (serverType:0 only).#-# If no path is provided, a default value will be calculated based on the operating environment.# openoffice.profilePath=/home/user/.openoffice.org/3

#-# [Since 1.8RC3]#-# Maximum number of simultaneous conversion tasks to be handled by a single #-# openoffice process (serverType:0 only).#-# Default value is 50# openoffice.maxTasksPerProcess=50

#-# [Since 1.8RC3]#-# Timeout for conversion tasks (in miliseconds) (serverType:0 only).#-# Default value is 30 seconds# openoffice.taskExecutionTimeout=30000

#-------------------------------------------------------------------------------------# Velocity#-------------------------------------------------------------------------------------

#-# [Since 2.0M1]

#-# Velocity Tools that will be available from your scripts. The format is#-# velocity.tools.<name under which it'll be available in the context> = <class name>#-# Default values (no need to add them)#-# velocity.tools = listtool = org.apache.velocity.tools.generic.ListTool#-# velocity.tools = numbertool = org.apache.velocity.tools.generic.NumberTool#-# velocity.tools = datetool = org.apache.velocity.tools.generic.DateTool#-# velocity.tools = mathtool = org.apache.velocity.tools.generic.MathTool#-# velocity.tools = sorttool = org.apache.velocity.tools.generic.SortTool #-# velocity.tools = escapetool = org.apache.velocity.tools.generic.EscapeTool#-# velocity.tools = regextool = org.xwiki.velocity.tools.RegexTool

#-# [Since 2.0M1]#-# Velocity configuration properties. The format is#-# velocity.property.<Velocity property name> = <value>#-# Default values (no need to add them)#-# velocity.properties = resource.loader = webapp#-# velocity.properties = directive.set.null.allowed = true#-# velocity.properties = webapp.resource.loader.class = org.apache.velocity.tools.view.servlet.WebappLoader#-# velocity.properties = velocimacro.messages.on = false#-# velocity.properties = resource.manager.logwhenfound = false#-# velocity.properties = velocimacro.permissions.allow.inline.local.scope = true#-# velocity.properties = runtime.introspector.uberspect = org.xwiki.velocity.introspection.ChainingUberspector#-# velocity.properties = runtime.introspector.uberspect.chainClasses = org.apache.velocity.util.introspection.SecureUberspector,org.xwiki.velocity.introspection.DeprecatedCheckUberspector

#-------------------------------------------------------------------------------------# Events distribution#-------------------------------------------------------------------------------------

#-# [Since 2.0M3]#-# Indicate if the network distribution module is enabled or not.#-# By default remote events are disabled.# observation.remote.enabled = false

#-# [Since 2.0M3]#-# The list of events communication channels to start when the application starts.#-# By default no channel is configured.#-##-# The default remote event distribution implementation is using JGroups and you'll need #-# to drop your JGroups channel#-# xml files in the WEB-INF/observation/remote/jgroups/ directory. There's a README #-# file in that directory with more#-# information.#-# Example: observation.remote.channels = public, cluster

#-# [Since 2.0M4]#-# The implementation of network adapter to use.#-# The default is jgroups.#-##-# By default obnly jgroups is provided. To add one implements NetworkAdaptor componenet #-# interface. The identifier provided in the configuration is matched with the component #-# role hint.#-# Example: observation.remote.networkadapter = jgroups

#-------------------------------------------------------------------------------------# Administration#-------------------------------------------------------------------------------------

#-# [Since 2.2M2]#-# Enable captcha: true|false#-##-# Captcha is disabled by default.#-# Example: captcha.enabled = true

Security

Admin passwordAsegurarse de cambiar la contraseña o eliminar a este usuario.

Cuenta SuperadminPorqué es especial:

• No está registrada en la base de datos.• No puede ser modificada de ninguna forma.• Tiene completo acceso aunque los permisos hayan sido alterados.

Por esto no debe ser habilitada durante demasiado tiempo.

Para habilitarla en xwiki.cfg, descomentando xwiki.superadminpassword=system, recuerde reiniciar el contenedor de XWiki tras los cambios.

Puede ser útil cuando se es incapaz de loguearse, se han borrado las cuentas de administrador...

Claves para encriptar las CookiesCuando un usuario decide que su navegador recuerde su acceso a la wiki esta le enviará una cifrada a la que nadie pueda acceder. El encriptado se basa en dos parámetros del fichero xwiki.cfg.

Es importante cambiarlas:

xwiki.authentication.validationKeyxwiki.authentication.encryptionKey

En futuras versiones se pretende generarlas basadas en números aleatorios con una semilla dependiente de la maquina física en el momento de la instalación (ver el siguiente concepto para más detalles).

Administración de UsuariosEstas instrucciones asumen que se están usando las máscaras Albatross o Toucan (capturas de pantalla de Toucan).

Añadiendo usuarios• Entrar como administrador, ir a Administración, y entrar en Usuarios. • Pulsar en Añadir y rellenar los datos.

Cambiar la contraseña a los usuarios• Entrar como administrador, ir a Administración, y entrar en Usuarios.• Pulsar sobre el usuario, luego añadir a la URL ?xpage=passwd.

Cambiar la contraseña del usuario logueado• Ir al perfil tomando el enlace que queda arriba a la derecha, y hacer clic en Cambiar

contraseña.

Editar un usuario existente• Entrar como administrador, ir a Administración, y entrar en Usuarios.• Pulsar sobre el usuario, o sobre el icono de edición.

Eliminar un usuario• Entrar como administrador, ir a Administración, y entrar en Usuarios.• Pulsar sobre el icono de borrar de la fila donde este el usuario, no se puede realizar sobre el

usuario logueado.