Apache JSPWiki 2.11 - Documentazione

Concesso in licenza alla Apache Software Foundation (ASF) in base a uno
o più accordi di licenza con i contributori.  Vedere il file NOTICE
distribuito con quest'opera per ulteriori informazioni
riguardanti la proprietà del copyright.  La ASF concede in licenza questo file
a te secondo i termini della Apache License, Versione 2.0 (la
"Licenza"); non puoi utilizzare questo file se non in conformità
con la Licenza.  Puoi ottenere una copia della Licenza al seguente indirizzo:

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

Salvo quanto previsto dalla legge applicabile o concordato per iscritto,
il software distribuito con la Licenza è distribuito su una base
"COSÌ COM'È", SENZA GARANZIE O CONDIZIONI DI ALCUN
TIPO, sia espresse che implicite.  Consulta la Licenza per il
linguaggio specifico che disciplina i permessi e le limitazioni
previsti dalla Licenza.  

Il file di licenza può essere trovato in LICENSE.

Cos'è JSPWiki?

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

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

Prerequisiti

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

RICHIESTI:

• Un motore JSP che supporti la Servlet API 3.1. Ti consigliamo Tomcat da http://tomcat.apache.org/ per un'installazione davvero facile. Sono supportate Tomcat 8.x o successive.

• Un po' di esperienza precedente di amministrazione... Se hai mai installato Apache o qualsiasi altro server web, dovresti essere messo abbastanza bene.

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

• JDK 8+

OPZIONALI:

• Il pacchetto JavaMail da java.sun.com, se vuoi utilizzare le funzionalità di posta 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" qui sotto.

Dalla versione JSPWiki 2.1.153, JSPWiki include un motore di installazione davvero semplice. Fai semplicemente quanto segue:

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

2. Rinomina il file JSPWiki.war scaricato e rinominalo in base all'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 tuo 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 di servlet), inserisci un file jspwiki-custom.properties, che può contenere qualsiasi sostituzione al 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 individuare 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 archiviando questo file in $TOMCAT_HOME/lib puoi 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.

(Ri)avvia tomcat.

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

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

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

Aggiornamento da versioni precedenti

Leggi le ReleaseNotes e il documento UPGRADING disponibili con questa distribuzione.

Contatti

È possibile rivolgere domande ai membri del team di JSPWiki e agli altri utenti tramite la mailing list jspwiki-users: vedere http://jspwiki.apache.org/community/mailing_lists.html. Ti preghiamo di utilizzare la mailing list degli utenti invece di contattare direttamente i membri del team, e poiché si tratta di una lista pubblica conservata in archivi pubblici, assicurati di evitare di includere informazioni sensibili (password, dati, ecc.) nelle tue domande.