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

Per installare MMDE è sufficiente installare il pacchetto python-moinmoin. Una volta terminata l'installazione per poter utilizzare il progamma è necessario creare una cartella nella Home in cui memorizzare tutti i dati. A tale scopo digitare il comando:

mkdir ~/mywiki

Copiare nella cartella appena creata le seguenti cartelle e 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

Modificare il file ~/mywiki/wikiserver.py con un editor di testo, commentando le righe che cominciano con il seguente testo:

sys.path

Avvio del programma

Per avviare MMDE è sufficiente digitare in una finestra di terminale il seguente comando:

python ~/mywiki/wikiserver.py

fare clic con il Pulsante destro del mouse nel link http://localhost:8080/ che appare nel terminale e selezionare Apri collegamento.

In alternativa è possibile fare clic due volte con il Pulsante sinistro del mouse sul file wikiserver.py, dunque fare clic su «Esegui nel terminale».

Per accedere alle pagine è sufficiente inserire nella barra degli indirizzi del browser il seguente indirizzo:

localhost:8080

Configurazione

La configurazione dell'applicazione risiede nei file wikiconfig.py e wikiserver.py.

Impostare la porta

Aprire con un editor di testo il file ~/mywiki/moin.py e assicurarsi che sia presente la seguente riga:

port = 8080

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