|
Dimensione: 3309
Commento:
|
Dimensione: 3366
Commento: Aggiornata terminologia
|
| Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
| Linea 27: | Linea 27: |
| * '''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, verificare il risultato e quindi eseguire l'upload.<<BR>>Delle due quest'ultima è la procedura consigliata (./) |
* '''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.<<BR>>Delle due quest'ultima è la procedura consigliata (./) |
| Linea 30: | Linea 30: |
| == Modifica diretta sul server == | == Modifica diretta su code.ubuntu-it.org == |
| Linea 51: | Linea 51: |
| 0. Eseguire il download del progetto nella propria '''Home''' digitando nel terminale:{{{ | 0. Clonare il progetto nella propria '''Home''' digitando nel terminale:{{{ |
| Linea 64: | Linea 64: |
| 0. Caricare le modifiche sul server:{{{ | 0. Caricare le modifiche sul repository remoto:{{{ |
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. È 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.
Delle due quest'ultima è la procedura consigliata
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).
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
