Introduzione
Su Launchpad sono ospitati i progetti inerenti alla documentazione:
help-repo: qui è ospitato il codice della pagina sulla documentazione ufficiale.
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.
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>"
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
Scaricare la directory del wiki-repo nella propria Home digitando:
bzr branch lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
- Apportare le modifiche ai file interessati.
Spostarsi nella directory ~/wiki-repo:
cd ~/wiki-repo
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"
Eseguire in fine il push per caricare le modifiche sul server:
bzr push lp:~ubuntu-it-wiki/wiki-ubuntu-it/wiki-repo
|
Procedere in modo analogo per scaricare la directory help-repo sostituendo nei comandi help-repo a wiki-repo. |
Aggiungere file
Può capitare di dover aggiungere file, come ad esempio una nuova macro. In tal caso eseguire questi passaggi.
Eseguire i passi mostrati in precedenza fino al download della directory wiki-repo nella propria Home.
- Copiare il file all'interno della cartella di destinazione.
Spostarsi nella medesima cartella con il terminale digitando:
cd ~/wiki-repo/PERCORSO_DI_DESTINAZIONE
Dare quindi il comando:
bzr add NOME_FILE
sostituendo NOME_FILE con il vero nome del file.Sempre rimanendo nella medesima cartella eseguire commit e push come mostrato nel paragrafo precedente.
Modifiche di routine
Gran parte degli accessi al repository vengono effettuati per gli aggiornamenti riguardanti le versioni supportate di Ubuntu, ossia ogni volta che esce una nuova versione stabile o un'altra termina il periodo di supporto.
wiki-repo
Aggiornare il file Informazioni.py modificando la lista della versioni di Ubuntu (codenames).
Aggiungere la nuova versione stabile, ad esempio:
'15.04': 'Vivid Vervet',
Aggiungere la nuova versione in sviluppo, ad esempio:
'15.10': 'Versione_in_sviluppo'
e quindi aggiornare la variabile developing con la medesima versione:
developing = '15.10'
Modificare la dicitura della versione che arriva al termine del suo ciclo. Ad esempio da
'14.10': 'Utopic Unicorn',
a
'14.10': 'deprecated',
In questo modo la macro Informazioni eviterà di mostrare le versioni non più supportate.
help-repo
Modificare il file index.html cancellando le sezioni relative a versioni non più supportate e aggiungendo le sezioni relative alla nuova versione di Ubuntu.
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:
Installare sul proprio sistema MoinMoin Desktop Edition.
Scaricare la directory wiki-repo.
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/
Settare il parametro theme_default nel file ~/mywiki/wikiconfig.py nel seguente modo:
theme_default = 'light'
Importare le macro:
cp ~/wiki-repo/data/plugin/macro/*.py ~/mywiki/data/plugin/macro/
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/
Modificando il file common.css sarà possibile testare nuove soluzioni per la resa grafica del sito.
