Introduzione

MoinMoin è un wiki scritto in linguaggio Python ed è anche lo strumento ufficiale del Gruppo documentazione della Comunità Italiana di Ubuntu. Ottimo anche per la produttività personale, può tornare utile a coloro che intendono acquisire padronanza con le operazioni di creazione e modifica delle pagine all'interno di questo wiki.

Questa guida illustra i procedimenti di installazione e configurazione di MoinMoin DesktopEdition, la versione del wiki che non necessita di alcun server web per funzionare.

Installazione

1. Installare i pacchetti necessari digitando in un terminale:

   sudo apt-get install python-moinmoin

2. Creare nella propria Home una directory (in questo esempio verrà nominata mywiki):

   mkdir ~/mywiki

3. Copiare nella cartella ~/mywiki i seguenti file:

   cp -R /usr/share/moin/data ~/mywiki
   cp -R /usr/share/moin/underlay ~/mywiki
   cp /usr/share/moin/config/wikiconfig.py ~/mywiki
   cp /usr/share/doc/python-moinmoin/examples/wikiserver.py ~/mywiki

4. Aprire il file ~/mywiki/wikiserver.py con un editor di testo e individuare le righe che cominciano per:

   sys.path

   "commentarle" anteponendo il simbolo #, in modo che risultino del tipo:

   #sys.path

Avvio del programma

1. Per avviare il servizio, digitare in un terminale il seguente comando:

   python ~/mywiki/wikiserver.py

   Quando necessario, il servizio può essere interrotto tramite la combinazione di tasti Ctrl+C.

2. Aprire in un browser il seguente link: http://localhost:8080

A questo punto le pagine potranno essere create in modo analogo a quanto scritto sulla pagina Creazione nuove pagine.

Creare utenti

1. Aprire nel browser il seguente indirizzo: http://localhost:8080/LanguageSetup?action=newaccount

2. Inserire le credenziali e quindi fare clic su Crea il profilo.

A questo punto sarà possibile effettuare l'accesso tramite il link Accedi.

Amministratore

Per creare il superuser e quindi avere accesso totale a tutti i servizi disponibili:

1. Aprire con un editor di testo il file ~/mywiki/wikiconfig.py.

2. Individuare le stringhe:

   #superuser = [u"YourName", ]
   #acl_rights_before = u"YourName:read,write,delete,revert,admin"

3. Decommentarle e sostituire YourName con il nome dell'utente che si desidera come amministratore.
   Supponendo che l'utente si chiami mario, le stringhe saranno del tipo:

   superuser = [u"mario", ]
   acl_rights_before = u"mario:read,write,delete,revert,admin"

Configurazioni

Gran parte delle configurazioni avvengono tramite la modifica dei file wikiconfig.py e wikiserver.py.

Modificare i permessi

Con le impostazioni predefinite chiunque acceda al wiki avrà i permessi di lettura, scrittura, cancellazione e ripristino. Trattandosi di una versione dedicata all'utilizzo personale, tale configurazione, tuttavia, non dovrebbe creare problemi. Nel caso in cui si desideri comunque modificare i permessi, questo è possibile attraverso una modifica al file di configurazione.

Aprire con un editor di testo il file ~/mywiki/wikiconfig.py e modificare la sezione Security. Sarà possibile scegliere un superuser o dotare gli utenti di permessi più o meno restrittivi.

Se si desiderano maggiori informazioni su come amministrare i permessi all'interno di MoinMoin si può consultare la relativa guida.

Modificare la lingua delle pagine della guida

Una volta modificati i permessi, per avere le pagine della guida in italiano è sufficiente autenticarsi sul wiki e visitare l'indirizzo http://localhost:8080/SystemPagesSetup. Infine, all'interno della pagina fare clic su «install» alla voce «Italiano». Questa operazione deve essere compiuta dall'utente super user.

Utilizzo del wiki

La sintassi e le regole di utilizzo sono dettagliatamente specificate nella Guida al wiki.

Ulteriori risorse

• Sito ufficiale del progetto

• Discussione sul forum

CategoryInternet CategoryProduttivita