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

Installare i pacchetti necessari digitando in un terminale:
```
sudo apt-get install python-moinmoin
```
Creare nella propria Home una directory (in questo esempio verrà nominata mywiki):
```
mkdir ~/mywiki
```

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

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

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

Allo stato attuale, senza aver impostato restrizioni sui permessi di accesso, le pagine possono essere create da chiunque non solo dagli utenti registrati.

Creare utenti

Aprire nel browser il seguente indirizzo: http://localhost:8080/LanguageSetup?action=newaccount
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:

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

Individuare le stringhe:

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

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

Se il browser è impostato in lingua italiana, alcuni parti di MoinMoin appariranno automaticamente tradotti. Tuttavia per completare l'impostazione della lingua:

Effettuare il login come amministratore.
Accedere al seguente indirizzo.
Fare click su Installa alla voce all_pages (se lo si desiderà è comunque possibile scegliere i singoli pacchetti).

A questo punto, pagine di uso frequente come ModificheRecenti, CercaPagina, AiutoContenuti, ecc.. saranno funzionanti e tradotte in italiano.

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.

Per approfondire l'argomento visitare la pagina sul Controllo liste di accesso.

Utilizzo del wiki

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

Ulteriori risorse

CategoryInternet CategoryProduttivita

-  ⇤ ← Versione 47 del 24/11/2014 14.13.35 → 
  Dimensione: 3807
  Autore: jeremie2
  Commento:
+   ← Versione 49 del 24/11/2014 17.07.52 → ⇥
  Dimensione: 5387
  Autore: jeremie2
  Commento:
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 36:
-. Digitare in un [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{
+. Per avviare il servizio, digitare in un [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{
 Linea 38:
-}}}
+}}}Quando necessario, il servizio può essere interrotto tramite la combinazione di tasti '''Ctrl+C'''.
 Linea 41:
-= Configurazione =
+A questo punto le pagine potranno essere create in modo analogo a quanto scritto sulla pagina [[GuidaWiki/CreazioneNuovePagine|Creazione nuove pagine]].
 Linea 43:
-La configurazione dell'applicazione risiede nei file `wikiconfig.py` e `wikiserver.py`.
+||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''Allo stato attuale, senza aver impostato restrizioni sui [[#acl|permessi]] di accesso, le pagine possono essere create da chiunque non solo dagli utenti registrati.'' ||
 Linea 45:
-== Impostare la porta ==
+= Creare utenti =
 Linea 47:
-Aprire con un [[Ufficio/EditorDiTesto|editor di testo]] il file `~/mywiki/moin.py` e assicurarsi che sia presente la seguente riga: {{{
port = 8080
+. Aprire nel browser il seguente indirizzo: http://localhost:8080/LanguageSetup?action=newaccount
 0. Inserire le credenziali e quindi fare clic su '''Crea il profilo'''.
 
A questo punto sarà possibile effettuare l'accesso tramite il link [[http://localhost:8080/LanguageSetup?action=login|Accedi]]. 

= Amministratore =

Per creare il '''superuser''' e quindi avere accesso totale a tutti i servizi disponibili:
 0. Aprire con un [[Ufficio/EditorDiTesto|editor di testo]] il file `~/mywiki/wikiconfig.py`.
 0. Individuare le stringhe:{{{
#superuser = [u"YourName", ]
#acl_rights_before = u"YourName:read,write,delete,revert,admin"
}}}
 0. Decommentarle e sostituire '''!YourName''' con il nome dell'utente che si desidera come amministratore.<<BR>>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"
-Linea 51:
+Linea 65:
-== Modificare i permessi ==
+= Lingua italiana e pagine extra =
-Linea 53:
+Linea 67:
-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.
+Se il browser è impostato in lingua italiana, alcuni parti di '''!MoinMoin''' appariranno automaticamente tradotti. Tuttavia per completare l'impostazione della lingua:
 0. Effettuare il login come amministratore. 
 0. Accedere al [[http://localhost:8080/LanguageSetup?action=language_setup&pageset=all_pages&language=Italian|seguente indirizzo]].
 0. Fare click su '''Installa''' alla voce '''all_pages''' (se lo si desiderà è comunque possibile scegliere i singoli pacchetti).
-Linea 55:
+Linea 72:
-Aprire con un [[Ufficio/EditorDiTesto|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.
+A questo punto, pagine di uso frequente come [[http://localhost:8080/ModificheRecenti|ModificheRecenti]], [[http://localhost:8080/CercaPagina|CercaPagina]],  [[http://localhost:8080/AiutoContenuti|AiutoContenuti]], ecc.. saranno funzionanti e tradotte in italiano.
-Linea 57:
+Linea 74:
-Se si desiderano maggiori informazioni su come amministrare i permessi all'interno di !MoinMoin si può consultare la [[AiutoSuListeControlloAccesso|relativa guida]].
+<<Anchor(acl)>>
= Modificare i permessi =
-Linea 59:
+Linea 77:
-== Modificare la lingua delle pagine della guida ==
+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.
-Linea 61:
+Linea 79:
-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''.
+Nel caso in cui si desideri modificare i permessi, questo sarà possibile attraverso l'editazione della sezione ''Security'' nel file `~/mywiki/wikiconfig.py`.

||<tablestyle="text-align: justify; width:100%;" style="border:none;" 5%><<Immagine(Icone/Grandi/info.png,,center)>> ||<style="padding:0.5em; border:none;">Per approfondire l'argomento visitare la pagina sul [[AiutoSuListeControlloAccesso|Controllo liste di accesso]].||