JSPWiki
| ||||||||||||||||
JSPWiki es un software wiki (o WikiWiki) construido alrededor de los componentes JEE de Java, los servlets y las páginas JavaServer (JSP). Fue escrito en Java por Janne Jalkanen y liberado bajo licencia LGPL. Es un proyecto de la Apache Software Foundation y su licencia se ha cambiado a la licencia Apache. Un WikiWiki es un sitio web que permite a cualquier persona a participar en su desarrollo. JSPWiki soporta todas las características wiki tradicionales, así como el control de acceso muy detallada y la integración de seguridad con JAAS.
JSPWiki tiene interfaz para extensiones en Java, que actualmente incluyen, gráficos en SVG, indexación de páginas, weblogs, encuestas, foros, paginación de presentaciones, tablero de dibujo, etc. Apache JSPWiki, Un líder de código abierto WikiWiki motor, ricos en funciones y construido alrededor de estándares JEE componentes (Java, servlets, JSP).
Sumario
Características
Algunas de sus características son:
- WikiMarkup / Texto estructurado.
- Los archivos adjuntos.
- Apoyo Plantillas.
- El almacenamiento de datos a través de su opción de dos proveedores página wiki, con la capacidad de crear y conectar otros nuevos.
- Seguridad: control de grano fino sobre autorización y autenticación, pero fácil de configurar.
- Fácil plugin y filtros de la página de interfaces.
- Soporte UTF-8.
- Basado en JSP.
- Fácil instalación-ish.
- Página de bloqueo para evitar conflictos de edición.
- Soporte para múltiples Wikis.
- Preferencias de usuario personalizados.
Requerimientos
Para instalar JSPWiki se:
- Un motor JSP que apoya Servlet API 2.5. Recomendamos Tomcat para una instalación muy fácil. 6.x Tomcat o posterior es compatible.
- JDK 1.6 o superior.
Instalación
Las instrucciones de instalación se encuentran en el paquete, como un archivo llamado 'README'. Ver también InstallingJSPWiki, o http://doc.jspwiki.org/2.8. Además, aquí se exponen los puntos detallados para ejecutar la instalación:
1. Instalar Tomcat desde http://tomcat.apache.org/ (o cualquier otro contenedor de servlets).
2. Cambie el nombre del archivo JSPWiki.war de la descarga y cambiarle el nombre basado en su dirección URL deseada (si usted lo quiere diferente a / JSPWiki). Por ejemplo, si desea que su URL sea http: //.../wiki, cambiarle el nombre a wiki.war. Este nombre se conoce como <AppName> abajo.
Coloca esta guerra en la carpeta $ TOMCAT_HOME / webapps y (re) iniciar Tomcat.
3. Apunte su navegador a http: // <myhost> / <nombre de aplicación> /Install.jsp.
4. Siga el diálogo de instalación contestando a un par de preguntas simples.
5. Reinicie Tomcat.
6. Apunte su navegador a http: // <myhost> / <nombre de aplicación> /
Eso es todo, puede empezar a crear páginas ahora mismo en esta wiki.
Personalización de la instalación
Los pasos anteriores se supone que tiene r + w acceso a los siguientes directorios, ya que algunos archivos y carpetas se generan ahí: su casa del usuario (por las páginas wiki), su carpeta temporal (como se indica en el hotel java.io.tmpdir, por índices de Lucene y archivos Ehcache) y el directorio donde se inicia el contenedor de servlets (registro de JSPWiki se colocará allí). La mayoría de las veces esto está muy bien. Puede cambiar estos lugares, o cambiar la foprma de configuración de JSPWiki (es decir: su URL base, feeds RSS, configuración Java Mail, y un largo etcétera). En la carpeta / $ TOMCAT_HOME lib (o su equivalente en función de su contenedor de servlets), coloque un archivo jspwiki-custom.properties, que puede contener cualquier anulaciones a los valores predeterminados. Ver configuración de estos valores por defecto. Revise estos valores predeterminados para buscar los valores que usted puede desear para anular. Algunos valores comunes para anular incluyen:
- jspwiki.baseURL
- jspwiki.xmlUserDatabaseFile
- jspwiki.xmlGroupDatabaseFile
- jspwiki.fileSystemProvider.pageDir
- jspwiki.basicAttachmentProvider.storageDir
- log4j.appender.FileLog.File.
El archivo personalizado también se puede colocar en el directorio WEB-INF / carpeta de la guerra, pero almacenar este archivo en TOMCAT_HOME / lib le permite actualizar el JSPWiki sin necesidad de volver a insertar las personalizaciones.
Instalación de las páginas centrales
Hay un conjunto de páginas centrales (en diferentes idiomas) en la descarga que se puede cargar en su wiki. Descomprimir el contenido del jspwiki-corepages.zip en el directorio recién creado. Usted puede encontrar el resto de la documentación en el archivo JSPWiki-doc.zip. (Re) iniciar Tomcat. Apunte su navegador a http: // <donde su Tomcat se instala> / MyWiki /. Usted debe ver la página principal Wiki. El archivo / jspwiki.policy WEB-INF se utiliza para cambiar los permisos de acceso para el Wiki.
Configuración
Echa un vistazo a el defecto jspwiki.properties archivo en la instalación. Hay bastante amplia documentación sobre todas las configuraciones que usted puede hacer para su wiki. Nos deshicimos es contenidos aquí también. Hay varias opciones para configurar JSPWiki (en orden de prioridad):
- Argumentos de JVM (Propiedades del sistema Java).
- Variables de Entorno.
- archivo de propiedades jspwiki-custom.properties (en algún lugar de la ruta de clase).
- jspwiki.properties (empaquetado dentro jspwiki.jar empaquetado dentro JSPWiki.war).
Algunos ejemplos para iniciar JSPWiki en Tomcat con una URL base personalizado (una propiedad muy obvia es posible que desee cambiar):
Usando argumentos de JVM:
CATALINA_OPTS exportación = "-Djspwiki.baseURL = http: //www.example.com/mywiki" /usr/local/tomcat/bin/startup.sh
Usando envvars:
exportación jspwiki.baseURL = http: //www.example.com/mywiki /usr/local/tomcat/bin/startup.sh
Ver también CustomUserPreferences.
Soporte y documentación
Puede encontrar la documentación de 'JSPWiki en la URL http://doc.jspwiki.org/2.8.
Después de haber fracasado en encontrar una respuesta, trate de buscar en este wiki, o ir a cualquier de los siguientes servicios.
- JSPWikiSupport - Cualquier pregunta debe aquí.
- JSPWikiMailingList - Una lista de correo con todos los desarrolladores de JSPWiki.
- https://issues.apache.org/jira/browse/JSPWIKI - Notificación de un nuevo error.
- https://issues.apache.org/jira/browse/JSPWIKI - Presentación de una nueva idea o solicitud de mejora.
Ver también JSPWikiBrowserCompatibility y JSPWikiJDKCompatibility problemas conocidos.
Uso avanzado
Para configurar un entorno de desarrollo para JSPWiki ver DesarrolloGays
JSPWiki es fácilmente extensible. Usted puede escribir sus propios programas (Java) para personalizar o ampliar el comportamiento de JSPWiki. Estos plugpoints vienen en tres sabores:
- Plugins
- Filtros
- Proveedores
Para la interfaz de usuario Personalización ver:
- WikiSkin
- WikiTemplate
Plugins
Un plugin se llama cuando se hace una página y un código específico se encuentra en el texto de la página, más detalles
Filtros
Filtros Wiki le permiten pre y postproceso la información que vuele de ida y vuelta entre el motor de Wiki y el navegador, más detalles
Proveedores de
Los proveedores son los motores de almacenamiento que utiliza al guardar páginas. Por defecto se utiliza el FileSystemProvider, pero hay más, más detalles.
