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 il Gruppo Sistemisti 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. È possibile agire in 2 modi:

• modifica diretta dei file sul server attraverso l'editor di testo integrato in GitLab;

• modifica in locale dei file, cioè scaricando sul proprio pc i file del progetto, apportare le modifiche ed eseguire l'upload.

Modifica diretta sul server

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

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. Eseguire il download del 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 server:

   git push

Ulteriori risorse

• Guida a Git

CategoryComunitaDocumentazione