Introduzione

Su Launchpad sono ospitati i progetti inerenti alla documentazione:

• wiki-repo: qui è ospitato il codice del Wiki.

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

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

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:

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. Importare le macro:

   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/

Modificando il file common.css sarà possibile testare nuove soluzioni per la resa grafica del sito.

Ulteriori risorse

• Hompage del wiki-repo

• Hompage di help-repo

• MoinMoin Desktop Edition

CategoryComunitaDocumentazione