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 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"

Lingua italiana e pagine extra

Alcune pagine di comune utilizzo come ModificheRecenti, CercaPagina, AiutoContenuti, ecc.. non saranno funzionanti e i loro link verranno visualizzati con i relativi nomi in inglese, nonostante MoinMoin sia impostato per rilevare automaticamente la lingua del browser.
Per completare l'installazione delle pagine extra e della traduzione in lingua italiana:

1. Effettuare il login come amministratore.

2. Accedere al seguente indirizzo.

3. Scelta consigliata (vedi nota qua sotto): alla voce all_pages, fare click su Installa.

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 non dovrebbe creare problemi.
Nel caso in cui si desideri modificare i permessi, questo sarà possibile attraverso l'editazione della sezione Security nel file ~/mywiki/wikiconfig.py.

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