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
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.
Fare clic su Edit e apportare le modifiche.
Apportate le modifiche fare clic su Commit changes.
Modifica in locale
Preparativi
Installare Git:
sudo apt install git
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
Clonare il progetto nella propria Home digitando nel terminale:
git clone git@code.ubuntu-it.org:ubuntu-it-doc/help.git
Spostarsi all'interno della cartella scaricata:
cd help
Apportare le modifiche al file index.html.
Aggiungere i file al repository locale:
git add .
Applicare le modifiche fatte:
git commit -a -m "Breve messaggio per le modifiche effettuate"
Caricare le modifiche sul repository remoto:
git push