Apache JSPWiki 2.11 - Documentazione

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

   https://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.  

Il file di licenza è disponibile in LICENSE.

Cos'è JSPWiki?

JSPWiki è un clone di WikiWiki semplice (beh, non più), scritto in Java e JSP. Un WikiWiki è un sito web che consente a chiunque di partecipare al suo sviluppo. JSPWiki supporta tutte le caratteristiche wiki tradizionali, oltre a un controllo degli accessi molto dettagliato e all'integrazione della sicurezza tramite JAAS.

• Per maggiori informazioni vedere https://jspwiki-wiki.apache.org/

Prerequisiti

Okay, quindi vuoi un Wiki? Ti serviranno le seguenti cose:

RICHIESTI:

• Un motore JSP che supporti Servlet API 3.1. Consigliamo Apache Tomcat per un'installazione davvero facile. Sono consigliati Tomcat 9.x o successivi, anche se Tomcat 8.x è supportato; vedere la configurazione aggiuntiva che deve essere impostata per eseguire JSPWiki su Tomcat 8.x.

• Una certa esperienza di amministrazione precedente... Se hai mai installato Apache o qualsiasi altro server web, dovresti essere a posto.

• E, naturalmente, un server su cui far girare il motore JSP.

• JDK 8+

OPZIONALI:

• Il pacchetto JavaMail da java.sun.com, se vuoi usare le funzionalità di mailing di log4j. Avrai anche bisogno del Java Activation Framework.

Installazione davvero semplice

Questa sezione è pensata per te, se vuoi solo un'installazione davvero rapida senza troppe preoccupazioni. Se desideri un'installazione più complicata (con più controllo su come fare le cose), consulta la sezione "Install" più sotto.

A partire da JSPWiki 2.1.153, JSPWiki include un motore di installazione davvero semplice. Basta fare quanto segue:

1. Installa Tomcat da https://tomcat.apache.org/ (o qualsiasi altro contenitore servlet)

2. Rinomina il file JSPWiki.war scaricato in base al tuo URL desiderato (se lo vuoi diverso da /JSPWiki). Ad esempio, se vuoi che il tuo URL sia http://.../wiki, rinominalo in wiki.war. Questo nome verrà indicato come qui sotto. Posiziona questo WAR nella cartella $TOMCAT_HOME/webapps e poi avvia Tomcat.

3. Punta il browser su http://<myhost>/<appname>/Install.jsp

4. Rispondi a un paio di semplici domande

5. Riavvia il contenitore

6. Punta il browser su http://<myhost>/<appname>/

Tutto qui!

Installazione avanzata

Nella cartella $TOMCAT_HOME/lib (o equivalente in base al tuo contenitore servlet), inserisci un file jspwiki-custom.properties, che può contenere qualsiasi sovrascrittura del file predefinito ini/jspwiki.properties nel JAR di JSPWiki. Per qualsiasi valore non inserito nel file jspwiki-custom.properties, JSPWiki farà affidamento sul file predefinito. Esamina il file predefinito per cercare i valori che potresti voler sovrascrivere nel file personalizzato. Alcuni valori comuni da sovrascrivere nel file personalizzato includono jspwiki.xmlUserDatabaseFile, jspwiki.xmlGroupDatabaseFile, jspwiki.fileSystemProvider.pageDir, jspwiki.basicAttachmentProvider.storageDir e log4j.appender.FileLog.File. I commenti nel file predefinito suggeriranno valori appropriati con cui sovrascriverli.

Il file personalizzato può anche essere inserito nella cartella WEB-INF/ del WAR, ma archiviare questo file in $TOMCAT_HOME/lib ti consente di aggiornare il WAR di JSPWiki senza dover reinserire le tue personalizzazioni.

Decomprimi il contenuto di jspwiki-corepages.zip nella directory appena creata. Puoi trovare il resto della documentazione nel file JSPWiki-doc.zip.

(R)avvia Tomcat.

Punta il browser su http://<dove è installato il tuo Tomcat>/MyWiki/. Dovresti vedere la pagina Main Wiki. Vedi la sezione successiva se vuoi modificare le pagine =).

Il file WEB-INF/jspwiki.policy viene utilizzato per modificare i permessi di accesso al Wiki.

Controlla il sito web di Apache JSPWiki e la documentazione del progetto per ulteriori suggerimenti su configurazione e impostazione.

Utilizzo dell'immagine Docker

Le immagini Docker non sono release ufficiali ASF ma sono fornite per comodità. L'uso consigliato è sempre quello di compilare il sorgente.

L'immagine Docker di Apache JSPWiki è disponibile su Docker Hub.

Ottenere l'immagine

$ docker pull apache/jspwiki

Eseguire il contenitore

$ docker run -d -p 8080:8080 --name jspwiki apache/jspwiki

Quindi punta il browser su http://localhost:8080/ e dovresti avere subito un wiki funzionante!

Vedi https://jspwiki-wiki.apache.org/Wiki.jsp?page=Docker per personalizzazioni e utilizzo avanzato dell'immagine.

Aggiornamento dalle versioni precedenti

Si prega di leggere i documenti ReleaseNotes e UPGRADING disponibili con questa distribuzione.

Contatti

Le domande possono essere rivolte ai membri del team di JSPWiki e agli altri utenti tramite la mailing list jspwiki-users: vedi https://jspwiki.apache.org/community/mailing_lists.html. Utilizza la mailing list degli utenti invece di contattare direttamente i membri del team, e poiché si tratta di una lista pubblica archiviata in archivi pubblici, assicurati di evitare di includere informazioni sensibili (password, dati, ecc.) nelle tue domande.