Differenze tra le versioni 6 e 28 (in 22 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 6 del 19/11/2010 22.11.52 → 
  Dimensione: 4393
  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:
-{{{
a tal proposito, esiste un bug riproducibile in questa maniera:
 
Due bug sul wiki
« inserita: Oggi alle 18:49:19 »
 Rispondi citandoCitazione Modifica messaggioModifica Rimuovi messaggioRimuovi Dividi discussioneDividi discussione
Il primo si riproduce in questo modo.
1) Create due pagine.
2) Eliminate la prima
3) Provate a rinominare la seconda con il nome della prima
L'errore sarà "Una pagina con il nome 'xxxxx' esiste già. Prova un nome differente."
Vale anche provando a cancellare i file temporanei
+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 [[HelpOnProcessingInstructions|Redirect]].

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 30:
+Linea 45:
-= Cancellare pagine =
+== Cancellare immagini ==
-Linea 32:
+Linea 47:
-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
+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 34:
+Linea 49:
-= Cancellare immagini =
+Per eliminare una immagine, andare in '''Allegati''' e fare clic su '''Rimuovi'''.
-Linea 36:
+Linea 51:
-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
+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
-Linea 49:
+Linea 63:
-= Creare categorie =

Come gestire le categorie. altro di interessante?

{{{
appunti sparsi da sistemare

Per ogni nuova pagina ecco il codice.

 0. Permessi di pagina per ciascuna nuova categoria: {{{
#acl GruppoAdmin:admin,read,write,revert GruppoEditori:read,write,revert Known:read All:read
}}} Pregando un amministratore di applicare questi permessi affinché i Know e gli All non possano editare.

 0. Codice di ricerca (un esempio vale per tutti): {{{
+Sempre nella Category appena creata bisognerà aggiungere una breve descrizione della categoria e una stringa di ricerca: {{{
-Linea 64:
+Linea 65:
-[[FullSearch(CategoryComunitaDocumentazione -title:CategoryComunitaDocumentazione)]]
+[[FullSearch(CategoryComunitaDocumentazione -title:CategoryComunitaDocumentazione -regex:non_mi_cercare)]]
-Linea 67:
+Linea 68:
-. Codice da mettere nell'attuale pagina CategoryComunita per renderla residuale: {{{
[[FullSearch(CategoryComunita -title:CategoryComunita -regex:nomegruppo ))]]
}}} E via dicendo, un regex per ogni gruppo. Credo anche un -title:CategoryComunitaEtcEtc ma poi vedremo.
+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`.
-Linea 71:
+Linea 70:
-Aggiornare la pagina http://wiki.ubuntu-it.org/GiudaWiki/Categorie per inglobare le informazioni su queste nuove categorie
+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
-Linea 74:
+Linea 148:
+Per togliere lo stato di operatore {{{
/MSG ChanServ deop #ubuntu-it-doc proprio_nick
}}}
-Linea 75:
+Linea 152:
-= Da aggiungere =
+Per cambiare argomento del canale {{{
/topic nuovo_argomento
}}}
-Linea 77:
+Linea 156:
- * 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
+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 |
-Linea 81:
+Linea 159:
+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 |
}}}
-Linea 82:
+Linea 162:
+= Ulteriori risorse =
-Linea 83:
+Linea 164:
+ * [[GuidaWiki]]