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

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:

Effettuare il login come amministratore.
Accedere al seguente indirizzo.
Scelta consigliata (vedi nota qua sotto): alla voce all_pages, fare click su Installa.

Se lo si desiderà è possibile scegliere singole pagine, tuttavia così facendo si corre il rischio di rompere alcuni link e non poter visualizzare il contenuto delle relative pagine.

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 55 del 30/11/2024 19.01.33 → 
  Dimensione: 13031
  Autore: ivantu
  Commento: revisione
+   ← Versione 56 del 01/12/2024 09.52.32 → ⇥
  Dimensione: 5358
  Autore: ivantu
  Commento:
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 6:
-<<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?t=281467"; rilasci="24.04 22.04 20.04 18.04")>>
+<<Informazioni(forum="http://forum.ubuntu-it.org/viewtopic.php?t=281467"; rilasci="18.04")>>
 Linea 10:
-'''!MoinMoin''' è un software [[http://it.wikipedia.org/wiki/Wiki|wiki]] scritto in linguaggio [[Programmazione/Python|Python]] adottato ufficialmente dal [[GruppoDocumentazione|Gruppo documentazione]] della [[http://www.ubuntu-it.org|Comunità Italiana di Ubuntu]].<<BR>>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.
+'''!MoinMoin''' è un [[http://it.wikipedia.org/wiki/Wiki|wiki]] scritto in linguaggio [[Programmazione/Python|Python]] ed è anche lo strumento ufficiale del [[GruppoDocumentazione|Gruppo documentazione]] della [[http://www.ubuntu-it.org|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.
 Linea 12:
-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|server web]] per funzionare.

= Prerequisiti =

 * [[InternetRete/ConfigurazioneRete/AbilitareConnessione|Connessione a Internet]]: È necessaria per scaricare i pacchetti.
 * Eseguire alcuni comandi con i [[AmministrazioneSistema/PrivilegiDiAmministrazione|privilegi di amministratore]].
 * Effettuare regolari [[AmministrazioneSistema/BackupDelSistema|backup]] del wiki per evitare perdite di dati.
+Questa guida illustra i procedimenti di installazione e configurazione di '''!MoinMoin !DesktopEdition''', la versione del wiki che non necessita di alcun [[Server/Web|server web]] per funzionare.
-Linea 22:
+Linea 16:
-. [[AmministrazioneSistema/InstallareProgrammi|Installare]] i pacchetti necessari digitando in un [[AmministrazioneSistema/Terminale|terminale]]:{{{
sudo apt install python3-moinmoin
+. [[AmministrazioneSistema/InstallareProgrammi|Installare]] i pacchetti necessari digitando in un [[AmministrazioneSistema/RigaDiComando|terminale]]:{{{
sudo apt install python-moinmoin
-Linea 25:
+Linea 19:
-. [[AmministrazioneSistema/ComandiBase#mkdir|Creare]] nella propria '''Home''' una directory, digitando nel [[AmministrazioneSistema/Terminale|terminale]] il seguente comando:{{{
+. Creare nella propria '''Home''' una directory (in questo esempio verrà nominata `mywiki`):{{{
-Linea 27:
+Linea 21:
-}}} (in questo esempio verrà nominata `mywiki`)
 0. [[AmministrazioneSistema/ComandiBase#cp|Copiare]] nella cartella `~/mywiki` i seguenti file, digitando in un [[AmministrazioneSistema/Terminale|terminale]] i seguenti comandi:{{{
+}}}
 0. Copiare nella cartella `~/mywiki` i seguenti file: {{{
-Linea 32:
+Linea 26:
-cp /usr/share/doc/python3-moinmoin/examples/wikiserver.py ~/mywiki
+cp /usr/share/doc/python-moinmoin/examples/wikiserver.py ~/mywiki
-Linea 42:
+Linea 36:
-. Per avviare il servizio, digitare in un [[AmministrazioneSistema/Terminale|terminale]] il seguente comando:{{{
python3 ~/mywiki/wikiserver.py
+. Per avviare il servizio, digitare in un [[AmministrazioneSistema/RigaDiComando|terminale]] il seguente comando:{{{
python ~/mywiki/wikiserver.py
-Linea 45:
+Linea 39:
-. Aprire in un [[InternetRete/Navigazione#Browser_per_navigare|browser]] il seguente link `https://localhost:8080`
+. Aprire in un browser il seguente link: http://localhost:8080
-Linea 52:
+Linea 46:
-= Configurazione =
+= Creare utenti =
-Linea 54:
+Linea 48:
-{{{#!wiki important
Se si sta rendendo il wiki accessibile da Internet, assicurarsi di configurare correttamente i permessi e di prendere le misure necessarie per proteggerlo da attacchi.
+. 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 58:
+Linea 66:
- * 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 [[Server/Apache|Apache]] o Nginx. Questo permetterà di accedere al wiki tramite un nome di dominio.

{{{#!wiki note
Per mantenere '''!MoinMoin''' aggiornato, esegui periodicamente `sudo apt update & sudo apt upgrade`.
}}}

{{{#!wiki note
La [[http://moinmo.in/|documentazione ufficiale]] di !MoinMoin fornisce informazioni dettagliate su tutte le funzionalità e opzioni di configurazione.
}}}

{{{#!wiki note
!MoinMoin può essere integrato con altri servizi e applicazioni, come sistemi di controllo delle versioni e strumenti di tracciamento dei bug.
}}}

== Creare utenti ==

Creare un utente in '''!MoinMoin''' è un passo fondamentale per gestire e configurare il wiki. '''!MoinMoin !DesktopEdition''' offre un modo semplice per gestire gli utenti normali e di amministrazione.

{{{#!wiki note
Le opzioni specifiche disponibili per la creazione e la gestione degli utenti possono variare a seconda della configurazione del wiki. Consultare la [[http://moinmo.in/|documentazione]] di '''!MoinMoin''' per maggiori dettagli.
}}}

{{{#!wiki note
Considerare la creazione di gruppi di utenti per gestire i permessi in modo più efficiente.
}}}

{{{#!wiki note
L'interfaccia esatta per la gestione degli utenti può variare leggermente a seconda della versione di '''!MoinMoin''' e delle eventuali personalizzazioni applicate.
}}}

L'amministrazione di questo ruolo speciale permette all'utente di avere accesso a tutte le funzionalità del wiki, incluso la creazione e la modifica di pagine, la gestione degli utenti e le configurazioni di sistema. La procedura generale esatta può variare leggermente a seconda della versione di '''!MoinMoin''' e della configurazione specifica del wiki. Tuttavia, i passaggi di base sono generalmente i seguenti:

 0. Aprire nel [[InternetRete/Navigazione#Browser_per_navigare|browser]] e digita l'URL dell'indirizzo `http://localhost:8080`.
 0. Inserire le credenziali di amministratore.
 0. 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".
 0. 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).
}}}
 0. Dopo aver compilato il form, salvare le modifiche. Il nuovo utente dovrebbe essere ora elencato insieme agli altri utenti. Cliccare sul pulsante "Salva" o "Crea utente" per confermare le modifiche.

{{{#!wiki important
Assicurarsi di assegnare all'utente amministratore tutti i [[Ufficio/MoinMoinDesktopEdition#Assegna_i_permessi_.28opzionale.29|permessi necessari]]. Questo potrebbe includere la possibilità di creare e modificare qualsiasi pagina, gestire altri utenti, modificare le impostazioni del wiki, ecc.<<BR>>La creazione di un utente amministratore comporta un rischio per la sicurezza del wiki. Proteggere le credenziali di accesso dell'amministratore e considerare l'utilizzo di un'autenticazione a due fattori per una maggiore sicurezza.
}}}

A questo punto sarà possibile effettuare l'accesso tramite il link [[http://localhost:8080/LanguageSetup?action=login|Accedi]]. 

##
== Assegna i permessi (opzionale) ==

'''!MoinMoin''' offre un sistema flessibile per gestire i permessi degli utenti e dei gruppi, consentendo di controllare chi può creare, modificare o eliminare pagine, e quali azioni possono eseguire all'interno del wiki. Come assegnare i permessi:

 0. Accesso all'interfaccia di amministrazione:
  * Accedere al wiki con le credenziali di un utente amministratore.
  * Cercare la sezione "Amministrazione", "Impostazioni" o "Pannello di controllo".
  * Individuare la sezione dedicata alla gestione degli utenti e dei gruppi.
 0. Identificazione dei gruppi:
  * '''!MoinMoin''' utilizza i gruppi per gestire i permessi. Potrebbero già esistere gruppi predefiniti come "Anonymous" (utenti non autenticati), "Authenticated" (utenti autenticati) e altri gruppi personalizzati.
  * Si può creare nuovi gruppi se necessario.
 0. Assegnazione dei permessi ai gruppi:
  * '''Permessi a livello di pagina''': Per ogni pagina, si può definire i permessi per i diversi gruppi. Ad esempio, puoi consentire a un gruppo di utenti di modificare una pagina, mentre a un altro gruppo di leggerla solo.
  * '''Permessi globali''': Alcuni permessi possono essere applicati a livello globale, ad esempio la possibilità di creare nuove pagine o di modificare le impostazioni del wiki.
 0. '''Assegnazione degli utenti ai gruppi''': Associa gli utenti ai gruppi appropriati. In questo modo, gli utenti erediteranno i permessi del gruppo a cui appartengono.

Tipi di permessi comuni:

||<tablestyle="width:60%;" :20%>'''Opzione''' ||<:40%>'''Descrizione''' ||
|| '''Lettura''' || Consente di visualizzare la pagina. ||
|| '''Scrittura''' || Consente di modificare la pagina. ||
|| '''Creazione''' || Consente di creare nuove pagine. ||
|| '''Cancellazione''' || Consente di eliminare pagine. ||
|| '''Amministrazione''' || Consente di modificare le impostazioni del wiki e di gestire gli utenti. ||

{{{#!wiki important
Permessi granulari: potrebbero concedere l'autorizzazione a creare nuove pagine, modificare pagine esistenti, cancellare pagine, ecc.
}}}

=== Esempi di scenari ===

 * '''Wiki pubblico''': Tutti gli utenti autenticati possono leggere e creare pagine, ma solo gli amministratori possono modificare le impostazioni del wiki.
 * '''Wiki aziendale''': I dipendenti di un dipartimento possono modificare le pagine relative al loro progetto, mentre gli altri dipendenti possono solo leggerle.
 * '''Wiki comunitario''': Gli utenti registrati possono creare e modificare pagine, mentre gli utenti non registrati possono solo leggere.

Suggerimenti:

 * Utilizza i gruppi in modo efficace: Organizza gli utenti in gruppi in base ai loro ruoli e responsabilità per semplificare la gestione dei permessi.
 * Assegna i permessi minimi necessari: Concedi agli utenti solo i permessi essenziali per svolgere il loro lavoro.
 * Considera i permessi a livello di pagina: Utilizza i permessi a livello di pagina per controllare l'accesso a specifiche sezioni del wiki.
 * Documenta i permessi: Tieni traccia dei permessi assegnati per facilitare la gestione futura del wiki.

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

{{{#!wiki note
Consultare la [[http://moinmo.in/|documentazione ufficiale]] di '''!MoinMoin''' per informazioni più dettagliate sulle funzionalità di gestione degli utenti.
}}}


##
## da correggere qui 
##
##

= Risoluzione problemi =
== Lingua italiana e pagine extra ==
+= Lingua italiana e pagine extra =
-Linea 183:
+Linea 78:
-== Modificare i permessi ==
+= Modificare i permessi =
-Linea 191:
+Linea 86:
-== Utilizzo del wiki ==
+= Utilizzo del wiki =