Differenze tra le versioni 4 e 28 (in 24 versioni)

Indice

Introduzione
Attività di edizione
Attività amministrative
Server
1. Struttura, accesso fisico e descrizione dei principali file di MoinMoin
Attività su Launchpad
1. Gestione del gruppo
2. Gestione dei rami
Gestione canale IRC
Ulteriori risorse

Introduzione

In questa pagina sono indicate le istruzioni utili per il GruppoAdmin, il GruppoEditori, il GruppoOperatori o per coloro che dispongono dei necessari permessi per editare il Wiki.

Per altre informazioni, è possibile consultare le pagine VademecumEditori e GuidaWiki.

Attività di edizione

Rinomina pagine

Rinominare una pagina è sempre preferibile rispetto al crearne una nuova, incollare il contenuto e cancellare la vecchia pagina. Questo perché è così possibile mantenere lo storico delle modifiche.

Per rinominare è sufficiente andare in Altre azioni e fare clic su Rinomina pagina. Inserire il nuovo percorso della pagina e aggiungere un commento per segnalare ad altri cosa si sta facendo.

Quando si rinomina è consigliabile lanciare una ricerca e se la pagina è ritenuta importante, estenderla anche agli altri portali della comunità e ai motori di ricerca. Questo per non creare collegamenti "morti" e per applicare, eventualmente, un Redirect.

Purtroppo, sull'attuale versione del wiki è presente un bug riproducibile in questo modo:

Creare due pagine.
Eliminate la prima pagina.
Rinominare la seconda pagina con il nome della prima pagina.

L'errore sarà il seguente: "Una pagina con il nome 'NOME DELLA PAGINA' esiste già. Prova un nome differente." Questo succede anche provando a cancellare i file temporanei.

La soluzione consiste nell'importare il contenuto della prima pagina sulla seconda tramite taglia e incolla.

Cancellare pagine

La cancellazione di una pagina è un operazione che richiede molta attenzione in quanto è molto altro il pericolo di creare dei collegamenti "morti". Piuttosto è preferibile spostare la pagina rinominandola sotto cestino al fine di poterla rintracciare successivamente. Se è il caso impostare anche un Redirect.

E' comunque consigliabile eseguire una ricerca, specie per le pagine più importanti, e verificare che non esistano collegamenti interwiki o sul sito web o sul forum. In certi casi si consiglia di controllare i motori di ricerca per vedere se è posizionata bene.

Per cancellare è sufficiente andare in "Altre azioni" e fare clic su "Cancella pagina". Aggiungere un commento per segnalare agli altri il motivo della vostra azione.

Se si opta per la soluzione che prevede lo spostamento sotto cestino, inoltre:

Rimuovere in fondo alla pagina le categorie presenti e utilizzare unicamente CategoryDaCancellare.
Applicare in testa al documento il seguente banner:
```
<<Include(StrumentiWiki/MacroCestino)>>
```

Cancellare immagini

Prima di procedere alla cancellazione di un'immagine, provare a ricercarla sul wiki. Molta attenzione deve essere posta alle immagini posizionate sotto Strumenti Wiki in quanto potrebbero essere necessarie per il template di un portale.

Per eliminare una immagine, andare in Allegati e fare clic su Rimuovi.

Per limitare il rischio che una immagine venga cancellata per sbaglio è per questo consigliabile allegare sempre dentro la pagina che dovrà essere servita.

Un altra soluzione, comoda se si lavora in gruppo, è affidarsi a delle pagine di appoggio, come già viene fatto per: NewsletterItaliana/Materiale, UbuntuItMeeting/Allegati, StrumentiWiki/Allegati.

Creare categorie

Per impostazione del file di configurazione del nostro wiki, le pagine con il prefisso "Category" vengono identificate come categorie e quindi elencate nella pagina CategoryCategory. Questa comparirà inoltre nel menù presente sotto la riga del commento quando si è in "edit" su una pagina.

Quando si crea una categorie gli amministratori daranno alla pagina questi permessi in modo che non sia alterabile da nessuno eccetto che dagli admin e dagli editori:

#acl GruppoAdmin:admin,read,write,revert GruppoEditori:read,write,revert Known:read All:read

Sempre nella Category appena creata bisognerà aggiungere una breve descrizione della categoria e una stringa di ricerca:

Questa pagina raccoglie tutte le pagine del Gruppo Documentazione.
[[FullSearch(CategoryComunitaDocumentazione -title:CategoryComunitaDocumentazione -regex:non_mi_cercare)]]

In questo caso si spiega che la Category serve a raccogliere tutte le pagine del Gruppo Documentazione e che la ricerca comprenderà tutte le pagine "taggate" CategoryComunitaDocumentazione ad esclusione proprio della pagina con titolo CategoryComunitaDocumentazione. La funzione di ricerca -regex esclude tutte le pagine in cui è presente la frase non_mi_cercare.

Sarà infine necessario aggiornare la pagina Categorie per indicare la funzione della categoria creata.

Attività amministrative

Macro SystemAdmin

I super utenti di MoinMoin possono utilizzare la macro SystemAdmin che permette di utilizzare le seguenti action:

User account browser: ?sysadm=users
File attachment browser: ?sysadm=attachments

La prima restituisce l'elenco completo di tutti gli utenti del wiki e mostra tre colonne: Username, Mail di registrazione, Azione. La colonna azione permetterebbe la funzione "Spediscimi via email i miei dati" che però è disattivata. Gli utenti sono elencati in ordine alfabetico. La macro attualmente non è funzionante. Come rimedio, usare le istruzioni del paragrafo successivo.

La seconda restituisce tutte le pagine in cui sono presenti degli allegati e mostra tre colonne: Pagina, Nome file allegato e Dimensione. Le pagine sono elencate in ordine sparso.

Azione SubscribeUser

Un superutente con l'azione ?=SubscribeUser può decidere di abbonare ad una determinata pagina uno o più utenti del wiki.

NOTA MOLTO BENE: se si lascia il campo vuoto tutti gli utenti del wiki vengono abbonati alla pagina! Per azzerare gli abbonati della pagina inserire nel campo il il segno meno "-".

Operazioni su altri utenti

I super utenti hanno la possibilità di diventare temporaneamente un altro utente. Per farlo:

Recarsi nella pagina Preferenze Utente
Selezionare l'utente desiderato
Fare clic su Select User

In questo modo è possibile compiere con l'utente scelto tutte le operazioni che comunemente si fanno con il proprio account. Quindi è utile qualora sia necessario cambiare delle password, chiudere degli account, modificare degli indirizzi e-mail e testare personalmente eventuali errori segnalati dagli utenti.

Per ritornare al proprio utente fare clic su Esci.

Server

Struttura, accesso fisico e descrizione dei principali file di MoinMoin

descrizione dei file di help. e wiki.

Attività su Launchpad

Su Launchpad il Gruppo Documentazione utilizza solo la sezione Overview.

Code viene utilizzato con il gruppo degli admin.

Di seguito brevi istruzioni per chi deve gestire le cose.

Gestione del gruppo

Per aggiungere un utente:

Andare nella pagina +addmember.
Scrivere o cercare un utente Launchpad-
Fare clic su Add member

In +members, selezionando un utente si può:

Impostare la scadenza della membership
Togliere l'utente dal gruppo

In +edit:

Una serie di cose da non toccare
+branding per cambiare i loghi del gruppo
+edithomepage per cambiare la descrizione del gruppo
+contactaddress per cambiare mail al gruppo

Gestione dei rami

In code sono presenti due branch: help-repo e wiki-repo.

help-repo (come spiegato) contiene i file necessari per la compilazione della documentazione ufficiale.

wiki-repo serve per aggiornare i file del wiki senza necessità di disporre credenziali sul server. I file che vengono caricati vanno sul server con un cron attivo ogni 5 minuti. La struttura è identica a quella del server con molti file in meno (sono inclusi solo i file e le cartelle sulle quali abbiamo i permessi).

continua

Gestione canale IRC

Gli amministratori del wiki sono operatori del canale #ubuntu-it-doc.

Per diventare operatore del canale

/MSG ChanServ op #ubuntu-it-doc proprio_nick

Per togliere lo stato di operatore

/MSG ChanServ deop #ubuntu-it-doc proprio_nick

Per cambiare argomento del canale

/topic nuovo_argomento

Di seguito due topic da copiare e incollare

Canale del gruppo documentazione italiano di Ubuntu | http://wiki.ubuntu-it.org/GruppoDocumentazione | Regole stilistiche: http://wiki.ubuntu-it.org/GuidaWiki/RegoleStilistiche | Per restare sempre aggiornati sulle guide della documentazione: http://tinyurl.com/34anyzq | Per il supporto tecnico rivolgersi in #ubuntu-it |

Canale del gruppo documentazione italiano di Ubuntu | http://wiki.ubuntu-it.org/GruppoDocumentazione | Regole stilistiche: http://goo.gl/JTme4 | Il nostro blog: http://goo.gl/Nfqca | Problemi con il wiki? http://goo.gl/HNmQP | ATTENZIONE nuova sintassi nel wiki http://3.ly/PdHn | Per il supporto tecnico rivolgersi in #ubuntu-it |

Ulteriori risorse

GuidaWiki

CategoryComunita

-  ⇤ ← Versione 4 del 15/11/2010 10.35.40 → 
  Dimensione: 2892
  Autore: GiuseppeTerrasi
  Commento:
+   ← Versione 28 del 10/01/2017 21.09.33 → ⇥
  Dimensione: 9871
  Autore: vipri-alessandro
  Commento: rimosso link inesistente
-Le cancellazioni sono segnalate in questo modo.
+Le aggiunte sono segnalate in questo modo.
 Linea 3:
-[[Indice]]
+<<BR>>
<<Indice>>
-Linea 7:
+Linea 8:
-Il Gruppo Documentazione basa il proprio lavoro sulla [:GuidaWiki] e dispone di una pagina denominata [:GruppoDocumentazione/LavoriSporchi] ad accesso limitato per alcuni tipi di operazioni.
+In questa pagina sono indicate le istruzioni utili per il GruppoAdmin, il GruppoEditori, il GruppoOperatori o per coloro che dispongono dei necessari permessi per editare il Wiki.
-Linea 9:
+Linea 10:
-Quanto segue è utile per i nuovi editori, che per la prima volta saranno abilitati a compiere certe operazioni, e chi dispone di questo tipo di privilegi pur non essendo editori (chi è incluso nelle pagine Gruppo*).
+||<tablestyle="text-align: justify; width:62%;" style="border:none;" 5%><<Immagine(Icone/Grandi/info.png,,center)>> ||<style="padding:0.5em; border:none;">Per altre informazioni, è possibile consultare le pagine [[GruppoDocumentazione/VademecumEditori|VademecumEditori]] e [[GuidaWiki]]. ||
-Linea 11:
+Linea 12:
-= Rinomina pagine =
+= Attività di edizione =
-Linea 13:
+Linea 14:
-E' preferibile sempre rinominare e non fare taglia e cuci tra vecchie e nuove pagine per tenere traccia dello storico.
Bisogna andare in altre azioni e poi rinomina pagina ed inserire il percorso nuovo. aggiungere un commento per far capire cosa si sta facendo. prima di rinominare lanciare sempre una ricerca e se la pagina è importante estendere la ricerca anche su altri portali e google per non lasciare link morti ed eventualmente applicare un redirect.
+== Rinomina pagine ==
 Linea 16:
-= Cancellare pagine =
+Rinominare una pagina è sempre preferibile rispetto al crearne una nuova, incollare il contenuto e cancellare la vecchia pagina. Questo perché è così possibile mantenere lo storico delle modifiche.
 Linea 18:
-Cancellare una pagina è MOLTO pericolo per il rischio di lasciare link morti. E' preferibile piuttosto quando si può spostare rinominando nel cestino. Ciò non toglie che bisogna fare comunque una ricerca (specie per le pagine importanti) e verificare che non esistano collegamenti inter wiki, sul sito web, sul forum e magari lanciare una ricerca con i motori per vedere se è posizionata bene. in quel caso valutare la possibilità di un redirect. per cancellare andare in altre azioni fare clic su cancella pagina ed indicare al motivazione
+Per rinominare è sufficiente andare in '''Altre azioni''' e fare clic su '''Rinomina pagina'''. Inserire il nuovo percorso della pagina e aggiungere un commento per segnalare ad altri cosa si sta facendo.
 Linea 20:
-= Cancellare immagini =
+Quando si rinomina è consigliabile lanciare una ricerca e se la pagina è ritenuta importante, estenderla anche agli altri portali della comunità e ai motori di ricerca. Questo per non creare collegamenti "morti" e per applicare, eventualmente, un [[HelpOnProcessingInstructions|Redirect]].
 Linea 22:
-Eliminare un immagine. controllare specie se collocata in strumenti/wiki che non sia usata da nessuno e andare in allegati e fare clic su rimuovi. peccato che questa cosa non funzioni per un bug di moin e quindi si riporta qui il work around che è stato trovato: {{{
"Da ora in poi, assumo come $URL un qualsiasi link ad una qualsiasi pagina nel wiki.
        1: Aprite la pagina degli allegati ($URL?action=AttachFile)
        2: Apritene il sorgete (Cntrl+U) e cercate "ticket". Troverete qualcosa di simile a:
        <input type="hidden" name="ticket"
             value="004bcec62d.cbda7446db84e6ff4e5ac65b62f29e1aaf994b39">
       prendente nota del value.
        3: Ora fate clic su "rimuovi" in corrispondenza all'immagine che volete eliminare e modificate l'url inserendo alla fine:
        &ticket=004bcec62d.cbda7446db84e6ff4e5ac65b62f29e1aaf994b39
        Ecco un esempio:
        $URL?action=AttachFile&do=del&target=NOME_FILE.png&ticket=004bcec62d.cbda7446db84e6ff4e5ac65b62f29e1aaf994b39
+Purtroppo, sull'attuale versione del wiki è presente un bug riproducibile in questo modo:
 0. Creare due pagine.
 0. Eliminate la prima pagina.
 0. Rinominare la seconda pagina con il nome della prima pagina.

L'errore sarà il seguente: "Una pagina con il nome 'NOME DELLA PAGINA' esiste già. Prova un nome differente." Questo succede anche provando a cancellare i file temporanei.

La soluzione consiste nell'importare il contenuto della prima pagina sulla seconda tramite taglia e incolla.

== Cancellare pagine ==

La cancellazione di una pagina è un operazione che richiede molta attenzione in quanto è molto altro il pericolo di creare dei collegamenti "morti". Piuttosto è preferibile spostare la pagina rinominandola sotto [[Cestino|cestino]] al fine di poterla rintracciare successivamente. Se è il caso impostare anche un Redirect.

E' comunque consigliabile eseguire una ricerca, specie per le pagine più importanti, e verificare che non esistano collegamenti ''interwiki'' o sul sito web o sul forum. In certi casi si consiglia di controllare i motori di ricerca per vedere se è posizionata bene. 

Per cancellare è sufficiente andare in "Altre azioni" e fare clic su "Cancella pagina". Aggiungere un commento per segnalare agli altri il motivo della vostra azione.

Se si opta per la soluzione che prevede lo spostamento sotto [[Cestino|cestino]], inoltre:
 0. Rimuovere in fondo alla pagina le categorie presenti e utilizzare unicamente CategoryDaCancellare.
 0. Applicare in testa al documento il seguente banner: {{{
<<Include(StrumentiWiki/MacroCestino)>>
-Linea 35:
+Linea 45:
-= Creare categorie =
+== Cancellare immagini ==
-Linea 37:
+Linea 47:
-Come gestire le categorie. altro di interessante?
+Prima di procedere alla cancellazione di un'immagine, provare a ricercarla sul wiki. Molta attenzione deve essere posta alle immagini posizionate sotto [[StrumentiWiki|Strumenti Wiki]] in quanto potrebbero essere necessarie per il template di un portale.
-Linea 39:
+Linea 49:
-= Da aggiungere =
+Per eliminare una immagine, andare in '''Allegati''' e fare clic su '''Rimuovi'''.
-Linea 41:
+Linea 51:
- * I nostri branch su launchpad: cosa sono e come metterci le mani
 * Wiki sul server: dove si trova e come metterci le mani
 * Come si ripristina la password di un utente
+Per limitare il rischio che una immagine venga cancellata per sbaglio è per questo consigliabile allegare sempre dentro la pagina che dovrà essere servita.
-Linea 45:
+Linea 53:
+Un altra soluzione, comoda se si lavora in gruppo, è affidarsi a delle pagine di appoggio, come già viene fatto per: [[NewsletterItaliana/Materiale]], [[UbuntuItMeeting/Allegati]], [[StrumentiWiki/Allegati]].
-Linea 46:
+Linea 55:
+== Creare categorie ==
-Linea 47:
+Linea 57:
+Per impostazione del file di configurazione del nostro wiki, le pagine con il prefisso "Category" vengono identificate come categorie e quindi elencate nella pagina [[CategoryCategory]]. Questa comparirà inoltre nel menù presente sotto la riga del commento quando si è in "edit" su una pagina.

Quando si crea una categorie gli amministratori daranno alla pagina questi permessi in modo che non sia alterabile da nessuno eccetto che dagli admin e dagli editori: {{{
#acl GruppoAdmin:admin,read,write,revert GruppoEditori:read,write,revert Known:read All:read
}}}

Sempre nella Category appena creata bisognerà aggiungere una breve descrizione della categoria e una stringa di ricerca: {{{
Questa pagina raccoglie tutte le pagine del Gruppo Documentazione.
[[FullSearch(CategoryComunitaDocumentazione -title:CategoryComunitaDocumentazione -regex:non_mi_cercare)]]
}}}

In questo caso si spiega che la Category serve a raccogliere tutte le pagine del Gruppo Documentazione e che la ricerca comprenderà tutte le pagine "taggate" !CategoryComunitaDocumentazione ad esclusione proprio della pagina con titolo !CategoryComunitaDocumentazione. La funzione di ricerca `-regex` esclude tutte le pagine in cui è presente la frase `non_mi_cercare`.

Sarà infine necessario aggiornare la pagina [[GuidaWiki/Categorie|Categorie]] per indicare la funzione della categoria creata.

= Attività amministrative =
== Macro SystemAdmin ==

I super utenti di MoinMoin possono utilizzare la macro !SystemAdmin che permette di utilizzare le seguenti action:
 * User account browser: `?sysadm=users`
 * File attachment browser: `?sysadm=attachments`

La prima restituisce l'elenco completo di tutti gli utenti del wiki e mostra tre colonne: Username, Mail di registrazione, Azione. La colonna azione permetterebbe la funzione "Spediscimi via email i miei dati" che però è disattivata. Gli utenti sono elencati in ordine alfabetico. La macro attualmente non è funzionante. Come rimedio, usare le istruzioni del paragrafo successivo.

La seconda restituisce tutte le pagine in cui sono presenti degli allegati e mostra tre colonne: Pagina, Nome file allegato e Dimensione. Le pagine sono elencate in ordine sparso.

== Azione SubscribeUser ==

Un superutente con l'azione ?=Subscribe``User può decidere di abbonare ad una determinata pagina uno o più utenti del wiki. 

NOTA MOLTO BENE: se si lascia il campo vuoto tutti gli utenti del wiki vengono abbonati alla pagina! Per azzerare gli abbonati della pagina inserire nel campo il il segno meno "-".

== Operazioni su altri utenti ==

I super utenti hanno la possibilità di diventare temporaneamente un altro utente. Per farlo:
 * Recarsi nella pagina [[PreferenzeUtente|Preferenze Utente]]
 * Selezionare l'utente desiderato
 * Fare clic su '''Select User'''

In questo modo è possibile compiere con l'utente scelto tutte le operazioni che comunemente si fanno con il proprio account. Quindi è utile qualora sia necessario cambiare delle password, chiudere degli account, modificare degli indirizzi e-mail e testare personalmente eventuali errori segnalati dagli utenti.

Per ritornare al proprio utente fare clic su '''Esci'''.

= Server =
== Struttura, accesso fisico e descrizione dei principali file di MoinMoin ==

descrizione dei file di help. e wiki.

= Attività su Launchpad =

Su [[https://launchpad.net/~ubuntu-it-doc|Launchpad]] il Gruppo Documentazione utilizza solo la sezione Overview.

Code viene utilizzato con il [[https://launchpad.net/~ubuntu-it-wiki|gruppo degli admin]].

Di seguito brevi istruzioni per chi deve gestire le cose.

== Gestione del gruppo ==

Per aggiungere un utente:
 * Andare nella pagina [[https://launchpad.net/~ubuntu-it-doc/+addmember|+addmember]].
 * Scrivere o cercare un utente Launchpad-
 * Fare clic su Add member

In [[https://launchpad.net/~ubuntu-it-doc/+members|+members]], selezionando un utente si può:
 * Impostare la scadenza della membership
 * Togliere l'utente dal gruppo

In [[https://launchpad.net/~ubuntu-it-doc/+edit|+edit]]:
 0. Una serie di cose da non toccare
 0. [[https://launchpad.net/~ubuntu-it-doc/+branding|+branding]] per cambiare i loghi del gruppo
 0. [[https://launchpad.net/~ubuntu-it-doc/+edithomepage|+edithomepage]] per cambiare la descrizione del gruppo
 0. [[https://launchpad.net/~ubuntu-it-doc/+contactaddress|+contactaddress]] per cambiare mail al gruppo

== Gestione dei rami ==

In [[https://code.launchpad.net/~ubuntu-it-wiki|code]] sono presenti due branch: help-repo e wiki-repo.

help-repo (come spiegato) contiene i file necessari per la compilazione della documentazione ufficiale.

wiki-repo serve per aggiornare i file del wiki senza necessità di disporre credenziali sul server. I file che vengono caricati vanno sul server con un cron attivo ogni 5 minuti. La struttura è identica a quella del server con molti file in meno (sono inclusi solo i file e le cartelle sulle quali abbiamo i permessi).

continua

= Gestione canale IRC =

Gli amministratori del wiki sono operatori del canale #ubuntu-it-doc.

Per diventare operatore del canale {{{
/MSG ChanServ op #ubuntu-it-doc proprio_nick
}}}

Per togliere lo stato di operatore {{{
/MSG ChanServ deop #ubuntu-it-doc proprio_nick
}}}

Per cambiare argomento del canale {{{
/topic nuovo_argomento
}}}

Di seguito due topic da copiare e incollare {{{
Canale del gruppo documentazione italiano di Ubuntu | http://wiki.ubuntu-it.org/GruppoDocumentazione | Regole stilistiche: http://wiki.ubuntu-it.org/GuidaWiki/RegoleStilistiche | Per restare sempre aggiornati sulle guide della documentazione: http://tinyurl.com/34anyzq | Per il supporto tecnico rivolgersi in #ubuntu-it |

Canale del gruppo documentazione italiano di Ubuntu | http://wiki.ubuntu-it.org/GruppoDocumentazione | Regole stilistiche: http://goo.gl/JTme4 | Il nostro blog: http://goo.gl/Nfqca | Problemi con il wiki? http://goo.gl/HNmQP | ATTENZIONE nuova sintassi nel wiki http://3.ly/PdHn | Per il supporto tecnico rivolgersi in #ubuntu-it |
}}}

= Ulteriori risorse =

 * [[GuidaWiki]]