Introduzione

MoinMoin è un software wiki scritto in linguaggio Python adottato ufficialmente dal Gruppo documentazione della Comunità Italiana di Ubuntu.
Particolarmente indicato per l'incremento della produttività personale, rappresenta uno strumento ideale per coloro che intendono acquisire le dinamiche padronanza con le operazioni di creazione e modifica delle pagine all'interno di questo wiki.

Questa guida fornisce i procedimenti dettagliati per l'installazione e configurazione di MoinMoin DesktopEdition, una versione autonoma del wiki che non richiede l'implementazione di alcun server web per funzionare.

Prerequisiti

• Connessione a Internet: È necessaria per scaricare i pacchetti.

• Eseguire alcuni comandi con i privilegi di amministratore.

• Effettuare regolari backup del wiki per evitare perdite di dati.

Installazione

1. Installare i pacchetti necessari digitando in un terminale:

   sudo apt install python3-moinmoin

2. Creare nella propria Home una directory, digitando nel terminale il seguente comando:

   mkdir ~/mywiki

   (in questo esempio verrà nominata mywiki)

3. Copiare nella cartella ~/mywiki i seguenti file, digitando in un terminale i seguenti comandi:

   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/python3-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:

   python3 ~/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 https://localhost:8080

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

Configurazione

• Per personalizzare il wiki, si può modificare il file wikiconfig.py. Ad esempio, si può cambiare la lingua, abilitare l'autenticazione degli utenti o configurare altri parametri.

• Utilizzo di un web server: Per un utilizzo più professionale, si può configurare MoinMoin per funzionare con un web server come Apache o Nginx. Questo permetterà di accedere al wiki tramite un nome di dominio.

Creare utenti

MoinMoin DesktopEdition offre un modo semplice per gestire gli utenti. Ecco una guida passo-passo su come creare nuovi utenti:

1. Aprire nel browser il seguente indirizzo http://localhost:8080

2. Inserire le credenziali di amministratore.
3. Accedere alla pagina di amministrazione degli utenti:
   • Cercare il link "Amministrazione" o "Impostazioni" solitamente presente nella barra laterale o in alto a destra della pagina.
   • Cercare una sezione dedicata agli utenti, come "Utenti", "Gruppi" o "Amministrazione utenti".
4. Creare un nuovo utente:
   • Trovare un form che permetta di inserire i dettagli del nuovo utente. I campi richiesti solitamente includono: Nome utente: Un nome univoco per identificare l'utente. Password: Una password sicura. Email: Un indirizzo email (opzionale, ma utile per le notifiche). Ruolo: Il ruolo dell'utente (es. utente normale, amministratore).
5. Dopo aver compilato il form, salvare le modifiche. Il nuovo utente dovrebbe essere ora elencato insieme agli altri utenti.

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

Assegna i permessi (opzionale)

MoinMoin permette spesso di assegnare permessi specifici a ciascun utente o gruppo di utenti.

Gruppi: si può creare gruppi di utenti e assegnare permessi ai gruppi anziché a singoli utenti, semplificando la gestione delle autorizzazioni.

Sicurezza

• Assegnare a ciascun utente solo i permessi strettamente necessari per svolgere le proprie attività.
• Password forti: Incoraggia gli utenti a scegliere password sicure e complesse.
• Autenticazione: Considera l'utilizzo di un'autenticazione esterna, come LDAP o OAuth, per una maggiore sicurezza.

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