Introduzione

Il codice sorgente dei portali di Ubuntu-it (o almeno parte di essi) è stato nel tempo trasferito da launchpad.net a code.ubuntu-it.org che si avvale della piattaforma GitLab per la gestione di repository Git.

Per quanto riguarda i progetti del Gruppo Documentazione, viene gestito tramite GitLab il portale help.ubuntu-it.org. In questa pagina viene mostrato come interagire con la piattaforma.

Requisiti

• Avere installato il pacchetto git.

• Essere in possesso di una chiave ssh.

• Contattare uno degli amministratori (o scrivere a questo indirizzo email per essere abilitati all'utilizzo della piattaforma.

Accesso a code.ubuntu-it.org

• All'indirizzo https://code.ubuntu-it.org è possibile effettuare l'accesso inserendo le proprie credenziali Ubuntu Sso (le medesime utilizzate per il wiki).

• All'indirizzo https://code.ubuntu-it.org/ubuntu-it-doc/help è presente il codice di help.ubuntu-it.org

Aggiornare il codice

A ogni nuovo rilascio e al termine del supporto di una delle versioni di Ubuntu è necessario andare ad aggiornare i link alle rispettive pagine della documentazione ufficiale. Pertanto la principale modifica da attuare ciclicamente, riguarda il file index.html.

È possibile agire in 2 modi:

• modifica diretta sul repository remoto ospitato su code.ubuntu-it.org attraverso l'editor di testo integrato in GitLab;

• modifica in locale dei file cioè clonando il progetto sul proprio pc e quindi apportare le modifiche, verificare il risultato e inviare le modifiche sul repository remoto.

Modifica diretta su code.ubuntu-it.org

1. Dalla pagina https://code.ubuntu-it.org/ubuntu-it-doc/help sfogliare le cartelle e selezionare il file da modificare (nel nostro caso www/index.html).

   È tuttavia consigliabile scaricare in locale, facendo clic sui pulsanti Download con icona a forma di nuvola, il file index.html e la directory libs che dovrà essere estratta dal file compresso. In questo modo sarà possibile verificare localmente le modifiche da attuare al file html.

2. Fare clic su Edit e apportare le modifiche.

3. Apportate le modifiche fare clic su Commit changes.

Modifica in locale

Preparativi

1. Installare Git:

   sudo apt install git

2. Impostare indirizzo email e nome utente utilizzati su code.ubuntu-it.org:

   git config --global user.email "you@example.com"

   sostituendo you@example.com con il proprio.

   git config --global user.name "Your Name"

   sostituendo Your Name col proprio username.

Attuare le modifiche

1. Clonare il progetto nella propria Home digitando nel terminale:

   git clone git@code.ubuntu-it.org:ubuntu-it-doc/help.git

2. Spostarsi all'interno della cartella scaricata:

   cd help

3. Apportare le modifiche al file index.html.

4. Aggiungere i file al repository locale:

   git add .

5. Applicare le modifiche fatte:

   git commit -a -m "Breve messaggio per le modifiche effettuate"

6. Caricare le modifiche sul repository remoto:

   git push

Ulteriori risorse

• Guida a Git

CategoryComunitaDocumentazione