## page was renamed from jeremie2/Prove4
#LANGUAGE it
#format wiki
<<Include(GruppoDocumentazione/Header2)>>
<<BR>>
<<Indice(depth=2)>>

= Introduzione =

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

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 [[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]].

<<Anchor(branch)>>
= Procedura generale =

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.

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

== Aggiungere file ==

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

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

----
CategoryComunitaDocumentazione