Wiki Ubuntu-it

Indice
Partecipa
FAQ
Wiki Blog
------------------
Ubuntu-it.org
Forum
Chiedi
Chat
Cerca
Planet
  • Pagina non alterabile
  • Informazioni
  • Allegati
  • Differenze per "GruppoDocumentazione/Launchpad"
Differenze tra le versioni 7 e 54 (in 47 versioni)
⇤ ← Versione 7 del 23/11/2012 18.38.29 →
Dimensione: 3439
Autore: jeremie2
Commento:
← Versione 54 del 02/03/2021 14.32.09 → ⇥
Dimensione: 6589
Autore: jeremie2
Commento: macro informazione ora funzionante in locale
Le cancellazioni sono segnalate in questo modo. Le aggiunte sono segnalate in questo modo.
Linea 1: Linea 1:
#acl GruppoAdmin:admin,read,write,revert GruppoEditori:read,write,revert Known:read
## page was renamed from Benvenuto		 ## page was renamed from jeremie2/Prove4
#LANGUAGE it
Linea 4: Linea 4:
#LANGUAGE it <<Include(GruppoDocumentazione/Header2)>>
<<BR>>
<<Indice(depth=2)>>
Linea 6: Linea 8:
##||<tablestyle="font-size: 0.9em; text-align: center; border: none; width: 100%; background-color: #f7f7f7; font-weight: bold; table-layout: fixed;"> [[http://wiki.ubuntu-it.org/GruppoDocumentazione| {{http://wiki.ubuntu-it.org/GruppoDocumentazione/Header2?action=AttachFile&do=get&target=01.png}}]]<<BR>> [[http://wiki.ubuntu-it.org/GruppoDocumentazione|Gruppo Documentazione]] || [[http://wiki.ubuntu-it.org/GuidaWiki| {{http://wiki.ubuntu-it.org/GruppoDocumentazione/Header2?action=AttachFile&do=get&target=04.png}}]]<<BR>> [[http://wiki.ubuntu-it.org/GuidaWiki|Guida Wiki]] ||
##||||<style="font-size: 0.90em; border: 2px; background-color: #cccccc;"> !WiKi||		 = Introduzione =
Linea 9: Linea 10:
Il codice sorgente del [[Documentazione|Wiki]] è ospitato su '''Launchpad''' nella pagina [[https://code.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo|wiki-repo]].
Linea 10: Linea 12:
||<tablestyle="font-size: 0.9em; text-align: center; border: none; width: 100%; background-color: #f7f7f7; font-weight: bold; table-layout: fixed;"> [[http://wiki.ubuntu-it.org/GruppoDocumentazione| {{http://wiki.ubuntu-it.org/GruppoDocumentazione/Header2?action=AttachFile&do=get&target=02.png}}]]<<BR>> [[http://wiki.ubuntu-it.org/GruppoDocumentazione/Benvenuto|Benvenuto]] || [[http://wiki.ubuntu-it.org/GruppoDocumentazione| {{http://wiki.ubuntu-it.org/GruppoDocumentazione/Header2?action=AttachFile&do=get&target=01.png}}]]<<BR>> [[http://wiki.ubuntu-it.org/GruppoDocumentazione|Gruppo Documentazione]] || [[http://wiki.ubuntu-it.org/GuidaWiki| {{http://wiki.ubuntu-it.org/GruppoDocumentazione/Header2?action=AttachFile&do=get&target=04.png}}]]<<BR>> [[http://wiki.ubuntu-it.org/GuidaWiki|Guida Wiki]] ||
||||||<style="font-size: 0.90em; border: 2px; background-color: #cccccc;"> !WiKi||		 Di seguito vengono riportate le operazioni necessarie per interagire con la piattaforma, sia per gli aggiornamenti di routine sia per modifiche supplementari.
Linea 13: Linea 14:
##<<Include(GruppoDocumentazione/Header2)>>
<<Indice(depth=2 align=right)>>		 = Requisiti =
Linea 16: Linea 16:
= Benvenuto! =  * Avere installato il pacchetto [[apt://bzr|bzr]].
 * Avere impostato una chiave '''ssh''' su Launchpad come mostrato nella [[GruppoWeb/Planet#Installare_una_versione_recente_di_.27.27bzr.27.27|seguente pagina]].
Linea 18: Linea 19:
Hai intenzione di scrivere una nuova guida o vorresti correggerne una già esistente? <<Anchor(branch)>>
= Procedura generale =
Linea 20: Linea 22:
 * '''Iscriviti al wiki''': occorre [[GuidaWiki/IscriversiAlWiki|creare un account]].
 * '''Non hai dimestichezza col wiki?''': dai un'occhiata alla [[Wiki10Passi|guida al wiki in 10 passi più uno]].
 * '''Crea una pagina personale''': la [[PaginaPersonale|pagina personale]] è utile sia come profilo personale, sia per fare pratica.		 Per scaricare nella propria '''Home''' la directory '''wiki-repo''' ospitata su [[http://bazaar.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo/files|Launchpad]], procedere con i seguenti passaggi.
Linea 24: Linea 24:
= Scrivere pagine = <<Anchor(login)>>
 0. Identificarsi attraverso il software [[Programmazione/Bazaar|Bazaar]] con il comando nella forma:{{{
bzr whoami "Nome Cognome <indirizzo_email>"
}}}Se l'utente si chiama ad es. '''Mario Rossi''' e utilizza l'email `m.rosssi@mail.com`, il comando diviene:{{{
bzr whoami "Mario Rossi <m.rossi@mail.com>"
}}}
 0. Effettuare il login digitando il comando nella forma:{{{
bzr launchpad-login nickname_launchpad
}}}Se il nickname utilizzato su Launchpad è '''mario''' il comando diviene:{{{
bzr launchpad-login mario
}}}
 0. Scaricare la directory del '''wiki-repo''' nella propria '''Home''' digitando: {{{
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
}}}
 0. Apportare le modifiche ai file interessati.
 0. Spostarsi nella directory `~/wiki-repo`:{{{
cd ~/wiki-repo
}}}
 0. Effettuare il '''commit''' per salvare le modifiche apportate nella revisione, avendo cura di inserire una brevissima descrizione dei cambiamenti:{{{
bzr commit -m "Inserire_qui_breve_messaggio_descrittivo"
}}}
 0. Eseguire in fine il '''push''' per caricare le modifiche sul server:{{{
bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
}}}
Linea 26: Linea 49:
 * '''Errori banali''': se trovi nomi sbagliati, errori ortografici, link errati, ecc.. correggili pure!
 * '''Grosse modifiche/nuove pagine''': è buona cosa informare nel [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]] il [[GruppoDocumentazione|Gruppo Doc]] in modo da evitare doppioni o pagine non necessarie.		 == Aggiungere file ==
Linea 29: Linea 51:
||<tablestyle="text-align: justify; width:100%; " style="border:none;" 5%><<Immagine(Icone/Piccole/note.png,,center)>> ||<style="padding:0.5em; border:none;">''Per le pagine da aggiornare si utilizzano [[GuidaWiki/CreazioneNuovePagine#Pagine_Prova|pagine di prova]]. Le nuove guide possono anche essere create da subito col [[GuidaWiki/CreazioneNuovePagine#Nuovi_Documenti|nome]] dell'argomento trattato.''|| Può capitare di dover aggiungere file, come ad esempio una nuova macro. In tal caso eseguire questi passaggi.
Linea 31: Linea 53:
Una volta finito fallo presente nel [[http://forum.ubuntu-it.org/viewforum.php?f=46|forum]]. Il Gruppo Documentazione inserirà la tua pagina nella [[GruppoDocumentazione/PagineDaFare#Tabella_revisioni|lista revisioni]] (se vuoi puoi inserirla tu stesso ;) ). Appena possibile sarà revisionata e se ce n'è bisogno adattata agli [[GuidaWiki/GlossarioRapido|standard]] in uso.<<BR>>
<<BR>>		  0. Eseguire i passi mostrati in precedenza fino al download della directory '''wiki-repo''' nella propria '''Home'''.
 0. Copiare il file all'interno della cartella di destinazione.
 0. Spostarsi nella medesima cartella con il terminale digitando:{{{
cd ~/wiki-repo/PERCORSO_DI_DESTINAZIONE
}}}
 0. Dare quindi il comando:{{{
bzr add NOME_FILE
}}}sostituendo NOME_FILE con il vero nome del file.
 0. Sempre rimanendo nella medesima cartella eseguire '''commit''' e '''push''' come mostrato nel paragrafo precedente.

== Attuare un merge ==

Può succedere che un utente con account Launchpad proponga delle migliorie da apportare al codice del wiki attraverso gli strumenti messi a disposizione da Launchpad stesso. In tal caso può apportare le migliorie su di un proprio branch e quindi richiedere un '''merge''' sul progetto originale.

Supponendo che un utente abbia creato il branch `lp:~username/wiki-ubuntu-it/nome-branch` e che abbia fatto una '''merge request''', seguire questi passaggi per applicare le modifiche proposte.
 0. Launchpad notificherà la richiesta agli amministratori, che potranno recarsi alla relativa pagina ([[https://code.launchpad.net/~21stefano/wiki-ubuntu-it/wiki-repo-with-msg-releases/+merge/326072|pagina di esempio]]) per segnare lo stato come '''Approved''' e inserire in basso il commento '''merge-approved'''.
 0. Dopo aver effettuato il [[#login|login]] su '''Bazaar''', scaricare entrambe le directory '''wiki-repo''' e '''nome-branch''' nella propria '''Home''' con i comandi:{{{
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo}}}{{{
bzr branch lp:~username/wiki-ubuntu-it/nome-branch
}}}
 0. Spostarsi nella cartella `wiki-repo`:{{{
cd ~/wiki-repo
}}}
 0. Eseguire il '''merge''' con il comando:{{{
bzr merge ~/nome-branch
}}}
 0. Eseguire quindi commit e push:{{{
bzr commit -m "Inserire_qui_breve_messaggio_descrittivo"
}}}{{{
bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
}}}Automaticamente lo status della richiesta passerà da '''approved''' a '''merged'''.

<<Anchor(altre_modifiche)>>
= Altre modifiche =

Per elaborare modifiche di vario genere, come ad esempio al tema grafico, è opportuno lavorare in locale su un'installazione di '''!MoinMoin Desktop Edition'''. Per ricreare l'aspetto originario del wiki procedere con i seguenti passi:

 0. Installare sul proprio sistema [[Ufficio/MoinMoinDesktopEdition|MoinMoin Desktop Edition]].
 0. [[#branch|Scaricare]] la directory `wiki-repo`.
 0. Copiare i file di configurazione: {{{
cp ~/wiki-repo/data/plugin/theme/light.py ~/mywiki/data/plugin/theme/
}}}{{{
sudo cp -pR ~/wiki-repo/htdocs/light /usr/share/moin/htdocs/
}}}
 0. Settare il parametro '''theme_default''' nel file `~/mywiki/wikiconfig.py` nel seguente modo:{{{
theme_default = 'light'
}}}
 0. Perché la macro ''informazioni'' funzioni è necessario installare il pacchetto ''python-distro-info'':{{{
sudo apt install python-distro-info
}}}copiare quindi le '''macro''' esistenti:{{{
cp ~/wiki-repo/data/plugin/macro/*.py ~/mywiki/data/plugin/macro/
}}}
 0. Creare una copia di backup del file favicon.ico: {{{
sudo cp /usr/share/moin/htdocs/favicon.ico /usr/share/moin/htdocs/favicon_backup.ico
}}}e quindi sostituire l'icona del wiki:{{{
sudo cp -p ~/wiki-repo/htdocs/favicon.ico /usr/share/moin/htdocs/
}}}

Questi sono i principali file per attuare modifiche allo stile grafico del wiki:
 * [[https://bazaar.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo/view/head:/data/plugin/theme/light.py|light.py]]: internamente al codice Python si trova il codice html che costituisce la struttura dell'header e del footer del sito;
 * [[http://bazaar.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo/view/head:/htdocs/light/css/|directory css]]: all'interno di questa cartella sono presenti i fogli di stile, in particolare i file `common.css` e `screen.css`. Qui è possibile settare le varie regole per il colore degli elementi, grandezza carattere, ecc..

= Ulteriori risorse =

 * [[https://code.launchpad.net/~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo|Hompage del wiki-repo]]
 * [[Ufficio/MoinMoinDesktopEdition|MoinMoin Desktop Edition]]
 * [[Programmazione/Bazaar|Guida a Bazaar]]


Introduzione

Il codice sorgente del Wiki è ospitato su Launchpad nella pagina wiki-repo.

Di seguito vengono riportate le operazioni necessarie per interagire con la piattaforma, sia per gli aggiornamenti di routine sia per modifiche supplementari.

Requisiti

  • Avere installato il pacchetto bzr.

  • Avere impostato una chiave ssh su Launchpad come mostrato nella seguente pagina.

Procedura generale

Per scaricare nella propria Home la directory wiki-repo ospitata su Launchpad, procedere con i seguenti passaggi.

  1. Identificarsi attraverso il software Bazaar con il comando nella forma:

    bzr whoami "Nome Cognome <indirizzo_email>"

    Se l'utente si chiama ad es. Mario Rossi e utilizza l'email m.rosssi@mail.com, il comando diviene:

    bzr whoami "Mario Rossi <m.rossi@mail.com>"

  2. Effettuare il login digitando il comando nella forma:

    bzr launchpad-login nickname_launchpad

    Se il nickname utilizzato su Launchpad è mario il comando diviene:

    bzr launchpad-login mario

  3. Scaricare la directory del wiki-repo nella propria Home digitando: 

    bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
  4. Apportare le modifiche ai file interessati.

  5. Spostarsi nella directory ~/wiki-repo:

    cd ~/wiki-repo

  6. Effettuare il commit per salvare le modifiche apportate nella revisione, avendo cura di inserire una brevissima descrizione dei cambiamenti:

    bzr commit -m "Inserire_qui_breve_messaggio_descrittivo"

  7. Eseguire in fine il push per caricare le modifiche sul server:

    bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo

Aggiungere file

Può capitare di dover aggiungere file, come ad esempio una nuova macro. In tal caso eseguire questi passaggi.

  1. Eseguire i passi mostrati in precedenza fino al download della directory wiki-repo nella propria Home.

  2. Copiare il file all'interno della cartella di destinazione.

  3. Spostarsi nella medesima cartella con il terminale digitando:

    cd ~/wiki-repo/PERCORSO_DI_DESTINAZIONE

  4. Dare quindi il comando:

    bzr add NOME_FILE
    sostituendo NOME_FILE con il vero nome del file.

  5. Sempre rimanendo nella medesima cartella eseguire commit e push come mostrato nel paragrafo precedente.

Attuare un merge

Può succedere che un utente con account Launchpad proponga delle migliorie da apportare al codice del wiki attraverso gli strumenti messi a disposizione da Launchpad stesso. In tal caso può apportare le migliorie su di un proprio branch e quindi richiedere un merge sul progetto originale.

Supponendo che un utente abbia creato il branch lp:~username/wiki-ubuntu-it/nome-branch e che abbia fatto una merge request, seguire questi passaggi per applicare le modifiche proposte.

  1. Launchpad notificherà la richiesta agli amministratori, che potranno recarsi alla relativa pagina (pagina di esempio) per segnare lo stato come Approved e inserire in basso il commento merge-approved.

  2. Dopo aver effettuato il login su Bazaar, scaricare entrambe le directory wiki-repo e nome-branch nella propria Home con i comandi:

    bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
    bzr branch lp:~username/wiki-ubuntu-it/nome-branch

  3. Spostarsi nella cartella wiki-repo:

    cd ~/wiki-repo

  4. Eseguire il merge con il comando:

    bzr merge ~/nome-branch

  5. Eseguire quindi commit e push:

    bzr commit -m "Inserire_qui_breve_messaggio_descrittivo"
    bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo

    Automaticamente lo status della richiesta passerà da approved a merged.

Altre modifiche

Per elaborare modifiche di vario genere, come ad esempio al tema grafico, è opportuno lavorare in locale su un'installazione di MoinMoin Desktop Edition. Per ricreare l'aspetto originario del wiki procedere con i seguenti passi:

  1. Installare sul proprio sistema MoinMoin Desktop Edition.

  2. Scaricare la directory wiki-repo.

  3. Copiare i file di configurazione: 

    cp ~/wiki-repo/data/plugin/theme/light.py ~/mywiki/data/plugin/theme/
    sudo cp -pR ~/wiki-repo/htdocs/light /usr/share/moin/htdocs/

  4. Settare il parametro theme_default nel file ~/mywiki/wikiconfig.py nel seguente modo:

    theme_default = 'light'

  5. Perché la macro informazioni funzioni è necessario installare il pacchetto python-distro-info:

    sudo apt install python-distro-info

    copiare quindi le macro esistenti:

    cp ~/wiki-repo/data/plugin/macro/*.py ~/mywiki/data/plugin/macro/

  6. Creare una copia di backup del file favicon.ico: 

    sudo cp /usr/share/moin/htdocs/favicon.ico /usr/share/moin/htdocs/favicon_backup.ico

    e quindi sostituire l'icona del wiki:

    sudo cp -p ~/wiki-repo/htdocs/favicon.ico /usr/share/moin/htdocs/

Questi sono i principali file per attuare modifiche allo stile grafico del wiki:

  • light.py: internamente al codice Python si trova il codice html che costituisce la struttura dell'header e del footer del sito;

  • directory css: all'interno di questa cartella sono presenti i fogli di stile, in particolare i file common.css e screen.css. Qui è possibile settare le varie regole per il colore degli elementi, grandezza carattere, ecc..

Ulteriori risorse

CategoryComunitaDocumentazione