Introduzione

Questa pagina descrive le procedure per lavorare al sito in sviluppo di Ubuntu-it, ospitato all'indirizzo https://code.ubuntu-it.org/ubuntu-it-web/www.

I lavori svolti sono visualizzati all'indirizzo wwwtest.ubuntu-it.org.

Organizzazione dei lavori

Requisiti

Per lavorare al sito in sviluppo è necessario:

1. aver seguito la procedura indicata nella pagina Contribuire, capitolo Contributi liberi;

2. aver seguito la procedura indicata nella pagina Scaricare Nuovo Sito, in modo da scaricare i file necessari sul proprio PC;

3. scegliere una pagina del nuovo sito a cui si vuole lavorare, aggiungendo il proprio nome utente alla pagina Lavori;

4. creare un nuovo branch, con nome specifico della pagina a cui si vuole lavorare, come indicato nel capitolo seguente.

Per gestire lo sviluppo del nuovo sito viene utilizzato GIT.
Di seguito si riportano alcuni comandi utili per lavorare al sito in sviluppo. Per la documentazione completa di GIT fare riferimento a questa pagina.

Contenuti

Nel riempire le pagine del sito tenere a mente quanto segue:

• testi e immagini devono riguardare l'ultimo rilascio LTS di Ubuntu e derivate, per non dover aggiornate tutto il sito ad ogni nuovo rilascio;

• l'unica pagina a fare eccezione è ovviamente scopri-ubuntu/nuovo-rilascio, che andrà aggiornata ad ogni nuovo rilascio di Ubuntu;

• caricare immagini di "peso" ridotto, quando possibile; tramite GIMP è possibile ridurre considerevolmente il peso dei file .png come indicato di seguito:

  1. selezionare il menu Immagine → Modalità → Indicizzata...;

  2. una volta aperto lo strumento Conversione a indicizzato, spuntare l'opzione Genera tavolozza automatizzata;

  3. indicate 256 alla voce Numero massimo di colori;

  4. premere Converti, quindi salvare l'immagine.

Procedura

Creare un nuovo Branch

Digitare nel terminale i comandi seguenti.

1. Navigare nella cartella contenente il sito in sviluppo scaricato in locale:

   cd ubuntu-it-web/www

2. Visualizzare il branch su cui si sta lavorando:

   git branch

   Prima di iniziare a modificare il sito, verrà visualizzato il solo branch develop.

3. Creare un nuovo branch:

   git checkout -b nome-nuovo-branch

   sostituendo alla voce nome-nuovo-branch il nome del branch che si intende creare; nella scelta del nome utilizzare la forma nome-pagina-nuovo, ad esempio derivate-nuovo o supporto-nuovo;

4. Passare ad un altro branch:

   git checkout nome-nuovo-branch

   sostituendo la voce nome-nuovo-branch con il nome del branch appena creato;

5. Visualizzare nuovamente il branch su cui si sta lavorando:

   git branch

   A questo punto dovrebbe essere spuntato il branch appena creato.
   Il risultato degli ultimi due comandi sarà simile a questo:

Modificare una pagina

Per modificare una pagina è necessario aprire i file .html con l'editor di testo che si preferisce (si può utilizzare anche Gedit).

La struttura è la seguente:

• i file .html delle pagine sono salvati nella cartella ~/ubuntu-it-web/www/uitwww/templates/pages

• le immagini sono salvate nella cartella ~/ubuntu-it-web/www/assets/images

Inviare le modifiche a code.ubuntu-it.org

1. Aggiungere le modifiche effettuate ad una pagina .html esistente:

   git add -p

   Se vengono create nuove pagine .html:

   ~/ubuntu-it-web/www/uitwww/templates/pages/nome-pagina.html

   sostituendo alla voce nome-pagina.html il nome della pagina .html creata.
   Se vengono realizzate, modificate o cancellate delle immagini:

   git add ~/ubuntu-it-web/www/assets/

2. Vedere le modifiche aggiunte prima di fare un commit:

   git diff --cached

3. Creare un commit:

   git commit

   quindi scrivere le modifiche fatte e salvare.
   La prima volta che si fa un commit verrà visualizzato il testo seguente:

   Please tell me who you are:

   digitare quindi il comando seguente:

   git config --global user.email inserire-qui-e-mail

   sostituendo alla voce inserire-qui-e-mail l'indirizzo e-mail utilizzato per accedere ad Ubuntu SSO;

4. Inviare le modifiche:

   git push origin nome-nuovo-branch

   sostituendo la voce nome-nuovo-branch con il nome del branch su cui si sta lavorando.
   Verrà visualizzato nel terminale un output simile al seguente:
   Premendo su link si verrà rimandati alla pagina specifica del branch a cui si sta lavorando.
   Se è la prima volta che si fa un push al nuovo branch, premendo sul link riportato nel terminale sarà necessario dare un Titolo al nuovo branch e confermarne la creazione.
   Una volta fatto, le modifiche saranno visibili all'indirizzo wwwtest.ubuntu-it.org.

Altri comandi utili

• Rimuovere un branch:

  git branch -d nome-branch-da-rimuovere

• Ogni volta che si modifica il file ~/ubuntu-it-web/www/assets/scss/www.scss:

  invoke assets

CategoryComunitaWeb