Xwiki Manual Es
Xwiki Manual Es
2 / 2-10-2010;
Próxima versión 2.2RC2 / 2-10-2010;
Desarrollado en Java
Multi-plataforma
Licencia GNU Lesser GPL
Sitio Web http://www.xwiki.org
http://www.xwiki.com
Datos de Wikipedia
XWiki 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.
Historia
XWiki 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.
Groovy
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+ Groovy
for (String it : new String[] {"Rod", ["Rod", "Carlos", "Chris"].
"Carlos", "Chris"}) .findAll{it.size() <=
if (it.length() <= 4) 4}.each{println it}
System.out.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.
Características
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 (o
conjuntamente 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
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>
<html> <body>
<body> Hello Velocity World!
#set( $foo = "Velocity" ) </body>
## followed by </html>
Hello $foo World!
</body>
</html>
Características
Edición de páginas
Ciclo de vida de los Documentosycle
Usando sintaxis wiki para dar formato al
Creación, edición, renombrado, copias,
texto, crear tablas, enlaces... Como
impresión...
alternativa cuenta con un editor WYSIWYG.
Control de versiones
Cualquier cambio es salvado, pudiendo
Adjuntos
visualizar versiones anteriores de las
Tantos como se quiera por cada página.
páginas, deshacer hasta determinado
momento o comparaciones.
Administración de permisos
Exportaciones
Quien puede qué y por niveles dentro de
De las páginas a PDF, RTF, XML o HTML.
la estructura de la XWiki.
Spaces
Organizar documentos agrupándolos por Usuarios y Grupos
dominio.
Programación
Notificationes
Uso de la API Xwiki desde las páginas con
Para estar al dia con los cambios con
Velocity o Groovy para mejoras del formato,
feeds RSS y la utilidad Watchlist.
capas o cualquier cosa.
Aplicaciones y Extensiones
Office Importer
Crear aplicaciones mediante agrupación de
Conversores de documentos office a
paginas. Posibilitando su posterior
páginas de la wiki.
importación o exportación.
Internacionalización
Integración Portlet
Soporta varias traducciones de los
Añade XWiki como JSR168 Portlet a un
documentos y redirige automáticamente
Portal.
según idioma del perfil del usuario.
Estadísticas Integradas
Plantillas para documentos y formularios
Seguir quien lee o contribuye, los más
Fácil con edición visual.
vistos...
WebDAV
Atajos con teclado Acceder a cada uno de los adjuntos y
documentos usando un cliente DAV o un
explorador.
Paquete de Aplicaciones
XWiki 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
Getting started
Empezar 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ásicos
XWiki Enterprise está dividida en Spaces y Pages.
Space
Es 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.
Page
Es 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.
Paneles
Es 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 pasos
Si eres Administrador
En principio use estas credenciales:
• Usuario: Admin
• Contraseña: admin canovas35
Recuerde cambiarla: Ir a perfil del administrador
Cambiando el logo
Existen 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 colores
La 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.css style-darkgray.css
style-blue.css style-gray.css
style-darkblue.css style-green.css
style-kaki.css style-purple.css
style-orange.css style-red.css
• Click en Guardar.
Añadirlos a grupos
Agrupando 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 usuario
Para 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.
Si eres Usuario
Lo primero será obtener las credenciales de usuario para loguearse.
Page History
Siempre 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ón
Podemos 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:
Configuración de idioma
En 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
Versiones de Documentos
Es 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 adjuntos
Las almacena por defecto, con el mismo inconveniente, para deshabilitarlo en el fichero xwiki.cfg
añadir:
xwiki.store.attachment.versioning=0
Reciclaje de Documentos
Por defecto los documento borrados no son eliminados realmente. Para deshabilitarlo en el fichero
xwiki.cfg añadir:
xwiki.recyclebin=0
Note 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:
Reciclaje de Adjuntos
Los 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 aspecto
Ver la Guía para aspecto.
Configuración de la seguridad
Ver la Guía de Seguridad.
Codificación
Ver la Guía de Codificación.
Autenticación de usuarios
Ver la Guía de Autentificación.
Deshabilitar WebDAV
Editar 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>
Redirecciones
XWiki soporta definición de redirecciones para solicitudes entrantes. Para activarlo en xwiki.cfg
establecer:
xwiki.preferences.redirect=1
Luego 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.
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 { h2 {
margin-left: 2cm; margin-left: 2cm;
margin-bottom: 1cm; margin-bottom: 1cm;
color: red; color: red;
} }
h3 {
margin: 3cm; h3 {
color: yellow; margin: 3cm;
} color: yellow;
}
Ejemplo de xwiki.cfg
#---------------------------------------
# General wiki settings
#
#-# When the wiki is readonly, any updates are forbidden. To mark readonly, use one of: yes, 1, true
# xwiki.readonly=no
#-# 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 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
#-# 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
#---------------------------------------
# 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
#---------------------------------------
# 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
#---------------------------------------
# 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 URLs
xwiki.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
#-# Cookie encryption keys. You SHOULD replace these values with any random string,
#-# as long as the length is the same.
xwiki.authentication.validationKey=totototototototototototototototo
xwiki.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.org
xwiki.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/*
#-# 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
#---------------------------------------
# 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
#-# 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 comments
xwiki.editcomment=1
#-# 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
#-# 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
#-# Specifies the LDAP attribute containing the identifier to be used as the XWiki name (default=cn)
# xwiki.authentication.ldap.UID_attr=cn
#-# 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
#---------------------------------------
# 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 & 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
#
#-# 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
#-# 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
#-# 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
#-# 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
#-------------------------------------------------------------------------------------
#-------------------------------------------------------------------------------------
# Rendering
#-------------------------------------------------------------------------------------
#-------------------------------------------------------------------------------------
# Cache
#-------------------------------------------------------------------------------------
#----------------------------------------------------------------------------------
# Settings for the OpenOffice server instance consumed by the OfficeImporter plugin
#----------------------------------------------------------------------------------
#-------------------------------------------------------------------------------------
# Velocity
#-------------------------------------------------------------------------------------
#-------------------------------------------------------------------------------------
# Events distribution
#-------------------------------------------------------------------------------------
#-------------------------------------------------------------------------------------
# Administration
#-------------------------------------------------------------------------------------
Admin password
Asegurarse de cambiar la contraseña o eliminar a este usuario.
Cuenta Superadmin
Porqué 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...
Administración de Usuarios
Estas 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.