Apache JSPWiki 2.11 - Documentación

Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.  

El archivo de licencia se puede encontrar en LICENSE.

¿Qué es JSPWiki?

JSPWiki es un clon sencillo (bueno, ya no tanto) de WikiWiki, escrito en Java y JSP. Un WikiWiki es un sitio web que permite que cualquiera participe en su desarrollo. JSPWiki soporta todas las características tradicionales de los wikis, además de un control de acceso muy detallado e integración de seguridad mediante JAAS.

• Para más información, consulta https://jspwiki-wiki.apache.org/

Requisitos previos

Vale, ¿quieres un Wiki? Necesitarás lo siguiente:

REQUERIDO:

• Un motor JSP que soporte Servlet API 3.1. Recomendamos Tomcat desde http://tomcat.apache.org/ para una instalación realmente fácil. Se soporta Tomcat 8.x o posterior.

• Un poco de experiencia previa en administración... Si alguna vez has instalado Apache o cualquier otro servidor web, estarás bastante bien encaminado.

• Y, por supuesto, un servidor donde ejecutar el motor JSP.

• JDK 8+

OPCIONAL:

• El paquete JavaMail de java.sun.com, si quieres usar las capacidades de correo de log4j. También necesitarás Java Activation Framework.

Instalación realmente simple

Esta sección es para ti, si solo quieres una instalación muy rápida sin demasiadas preocupaciones. Si quieres una instalación más complicada (con más control sobre cómo hacer las cosas), consulta la sección "Install" más abajo.

Desde JSPWiki 2.1.153, JSPWiki incluye un motor de instalación realmente simple. Solo haz lo siguiente:

1. Instala Tomcat desde http://tomcat.apache.org/ (o cualquier otro contenedor de servlets)

2. Renombra el archivo JSPWiki.war de la descarga y asígnale el nombre según la URL deseada (si la quieres distinta de /JSPWiki). Por ejemplo, si quieres que tu URL sea http://.../wiki, renómbralo a wiki.war. Este nombre se mencionará como más abajo. Coloca este WAR en tu carpeta $TOMCAT_HOME/webapps y luego inicia Tomcat.

3. Apunta tu navegador a http://<myhost>/<appname>/Install.jsp

4. Responde un par de preguntas simples

5. Reinicia tu contenedor

6. Apunta tu navegador a http://<myhost>/<appname>/

¡Eso es todo!

Instalación avanzada

En la carpeta $TOMCAT_HOME/lib (o su equivalente según tu contenedor de servlets), coloca un archivo jspwiki-custom.properties, que puede contener cualquier anulación del archivo predeterminado ini/jspwiki.properties del JAR de JSPWiki. Para cualquier valor que no esté en el archivo jspwiki-custom.properties, JSPWiki usará el archivo predeterminado. Revisa el archivo predeterminado para buscar valores que quieras anular en el archivo personalizado. Algunos valores comunes a anular en tu archivo personalizado incluyen jspwiki.xmlUserDatabaseFile, jspwiki.xmlGroupDatabaseFile, jspwiki.fileSystemProvider.pageDir, jspwiki.basicAttachmentProvider.storageDir y log4j.appender.FileLog.File. Los comentarios en el archivo predeterminado sugerirán valores apropiados con los que anularlos.

El archivo personalizado también se puede colocar en la carpeta WEB-INF/ del WAR, pero almacenar este archivo en $TOMCAT_HOME/lib te permite actualizar el WAR de JSPWiki sin necesidad de volver a insertar tus personalizaciones.

Descomprime el contenido de jspwiki-corepages.zip en tu directorio recién creado. Puedes encontrar el resto de la documentación en el archivo JSPWiki-doc.zip.

(Inicia) reinicia Tomcat.

Apunta tu navegador a http://<donde esté tu Tomcat instalado>/MyWiki/. Deberías ver la página principal del Wiki. Consulta la siguiente sección si quieres editar las páginas =).

El archivo WEB-INF/jspwiki.policy se usa para cambiar los permisos de acceso al Wiki.

Consulta el sitio web de Apache JSPWiki y la documentación del proyecto para obtener sugerencias adicionales de configuración y puesta en marcha.

Actualización desde versiones anteriores

Lee ReleaseNotes y el documento UPGRADING que se incluyen con esta distribución.

Contacto

Puedes hacer preguntas a los miembros del equipo de JSPWiki y a otros usuarios mediante la lista de correo jspwiki-users: consulta http://jspwiki.apache.org/community/mailing_lists.html. Por favor, usa la lista de correo de usuarios en lugar de contactar directamente con los miembros del equipo, y como esta es una lista pública almacenada en archivos públicos, asegúrate de no incluir información sensible (contraseñas, datos, etc.) en tus preguntas.