#LANGUAGE it
#format wiki
<<Include(GruppoDocumentazione/Header2)>>
<<BR>>
<<Indice(depth=2)>>

= Introduzione =

Il codice sorgente dei portali di Ubuntu-it (o almeno parte di essi) è stato nel tempo trasferito da [[https://launchpad.net|launchpad.net]] a [[https://code.ubuntu-it.org|code.ubuntu-it.org]] che si avvale della piattaforma [[https://about.gitlab.com/|GitLab]] per la gestione di repository '''Git'''.

Per quanto riguarda i progetti del Gruppo Documentazione, viene gestito tramite '''!GitLab''' il portale [[https://help.ubuntu-it.org/|help.ubuntu-it.org]]. In questa pagina viene mostrato come interagire con la piattaforma.

= Requisiti =

 * Avere installato il pacchetto [[apt://git|git]].
 * Essere in possesso di una chiave [[GruppoWeb/Planet#Impostare_una_chiave_SSH_su_Launchpad|ssh]].
 * Contattare [[https://code.ubuntu-it.org/groups/admins/-/group_members|uno degli amministratori]] (o scrivere a [[mailto:support@code.ubuntu-it.org|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 [[https://code.ubuntu-it.org/ubuntu-it-doc/help/blob/master/www/index.html|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 ==

 0. 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`).
 {{{#!wiki tip
È tuttavia consigliabile scaricare in locale, facendo clic sui pulsanti ''Download'' con icona a forma di nuvola, il file [[https://code.ubuntu-it.org/ubuntu-it-doc/help/blob/master/www/index.html|index.html]] e la directory [[https://code.ubuntu-it.org/ubuntu-it-doc/help/tree/master/www/libs|libs]] che dovrà essere estratta dal file compresso. In questo modo sarà possibile verificare localmente le modifiche da attuare al file html.
}}}
 0. Fare clic su '''Edit''' e apportare le modifiche.
 0. Apportate le modifiche fare clic su '''Commit changes'''.

== Modifica in locale ==

=== Preparativi ===

 0. Installare '''Git''':{{{
sudo apt install git
}}}
 0. 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 ===

 0. Clonare il progetto nella propria '''Home''' digitando nel terminale:{{{
git clone git@code.ubuntu-it.org:ubuntu-it-doc/help.git
}}}
 0. Spostarsi all'interno della cartella scaricata:{{{
cd help
}}}
 0. Apportare le modifiche al file `index.html`.
 0. Aggiungere i file al repository locale:{{{
git add .
}}}
 0. Applicare le modifiche fatte:{{{
git commit -a -m "Breve messaggio per le modifiche effettuate"
}}}
 0. Caricare le modifiche sul repository remoto:{{{
git push
}}}

= Ulteriori risorse =

 * [[Programmazione/Git/Commit|Guida a Git]]

----
CategoryComunitaDocumentazione