|
Dimensione: 1701
Commento: aggiunta immagine allegata, aggiunto capitolo "inviare modifiche a code.ubuntu-it.org"
|
Dimensione: 3053
Commento: aggiunto capitolo "Organizzazione dei lavori", modifiche varie testo e organizzazione titoli
|
| Le cancellazioni sono segnalate in questo modo. | Le aggiunte sono segnalate in questo modo. |
| Linea 7: | Linea 7: |
| Questa pagina descrive alcune procedure per lavorare al sito in sviluppo di Ubuntu-it. | Questa pagina descrive le procedure per lavorare al sito in sviluppo di Ubuntu-it. |
| Linea 11: | Linea 11: |
| = Branch = | = Organizzazione dei lavori = |
| Linea 13: | Linea 13: |
| == Creare un nuovo branch == | Il sito in sviluppo è ospitato all'indirizzo [[https://code.ubuntu-it.org/ubuntu-it-web/www]]. Per lavorare al sito in sviluppo è necessario: 0. aver seguito la procedura indicata nella pagina [[GruppoWeb/Contribuire|Contribuire]], capitolo '''Contributi liberi'''; 0. aver seguito la procedura indicata nella pagina [[GruppoWeb/Documentazione/ScaricareNuovoSito|Scaricare Nuovo Sito]], in modo da scaricare i file necessari sul proprio PC; 0. scegliere una pagina del nuovo sito a cui si vuole lavorare, aggiungendo il proprio '''nome utente''' alla pagina [[GruppoWeb/Lavori|Lavori]]; 0. creare un nuovo '''branch''', con nome specifico della pagina a cui si vuole lavorare, come indicato nel capitolo seguente. = Utilizzo di GIT = Per gestire lo sviluppo del nuovo sito viene utilizzato [[https://git-scm.com/|GIT]]. Di seguito si riportano alcuni comandi utili per lavorare al sito in sviluppo. Per la documentazione completa di GIT fare riferimento a [[https://git-scm.com/docs|questa pagina]]. == Branch == === Creare un nuovo branch === |
| Linea 25: | Linea 41: |
| }}} | }}}sostituendo alla voce '''nome-nuovo-branch''' il nome del branch che si intende creare; nella scelta del nome utilizzare la forma '''nome-pagina-nuovo''', ad esempio '''derivate-nuovo''' o '''supporto-nuovo'''; |
| Linea 28: | Linea 44: |
| }}} Usare questo comando per passare al nuovo branch appena creato; il risultato sarà simile a questo: | }}}sostituendo la voce '''nome-branch''' con il nome appropriato.<<BR>> Usare questo comando per passare al nuovo branch appena creato; il risultato sarà simile a questo: |
| Linea 31: | Linea 47: |
| == Altri comandi utili == * Rimuovere un branch: {{{ git branch -d nome-branch-da-rimuovere }}} = Inviare le modifiche a code.ubuntu-it.org = |
== Inviare le modifiche a code.ubuntu-it.org == |
| Linea 59: | Linea 69: |
| OGNI VOLTA CHE MODIFICO WWW.SCSS | == Altri comandi utili == * Rimuovere un branch: {{{ git branch -d nome-branch-da-rimuovere }}} * Ogni volta che si modificano le CSS: {{{ |
| Linea 61: | Linea 76: |
| }}} |
Introduzione
Questa pagina descrive le procedure per lavorare al sito in sviluppo di Ubuntu-it.
I lavori svolti sono visualizzati all'indirizzo wwwtest.ubuntu-it.org.
Organizzazione dei lavori
Il sito in sviluppo è ospitato all'indirizzo https://code.ubuntu-it.org/ubuntu-it-web/www.
Per lavorare al sito in sviluppo è necessario:
aver seguito la procedura indicata nella pagina Contribuire, capitolo Contributi liberi;
aver seguito la procedura indicata nella pagina Scaricare Nuovo Sito, in modo da scaricare i file necessari sul proprio PC;
scegliere una pagina del nuovo sito a cui si vuole lavorare, aggiungendo il proprio nome utente alla pagina Lavori;
creare un nuovo branch, con nome specifico della pagina a cui si vuole lavorare, come indicato nel capitolo seguente.
Utilizzo di GIT
Per gestire lo sviluppo del nuovo sito viene utilizzato GIT.
Di seguito si riportano alcuni comandi utili per lavorare al sito in sviluppo. Per la documentazione completa di GIT fare riferimento a questa pagina.
Branch
Creare un nuovo branch
Digitare nel terminale i comandi seguenti.
Navigare nella cartella contenente il sito in sviluppo scaricato in locale:
cd ubuntu-it-web/www
Visualizzare il branch su cui si sta lavorando:
git branch
Prima di iniziare a modificare il sito, verrà visualizzato il solo branch develop.
Creare un nuovo branch:
git checkout -b nome-nuovo-branch
sostituendo alla voce nome-nuovo-branch il nome del branch che si intende creare; nella scelta del nome utilizzare la forma nome-pagina-nuovo, ad esempio derivate-nuovo o supporto-nuovo;
Passare ad un altro branch:
git checkout nome-branch
sostituendo la voce nome-branch con il nome appropriato.
Usare questo comando per passare al nuovo branch appena creato; il risultato sarà simile a questo:
Inviare le modifiche a code.ubuntu-it.org
Aggiungere le modifiche effettuate:
git add -p
Aggiungere le immagini nuove o modificate:
git add ~/ubuntu-it-web/www/assets/
Vedere le modifiche caricate:
git diff --cached
Creare un commit:
git commit
La prima volta che si fa un commit verrà visualizzato il testo seguente:
Please tell me who you are:
digitare il comando seguente:
git config --global user.email inserire-qui-e-mail
Inviare le modifiche:
git push origin nome-branch
Altri comandi utili
Rimuovere un branch:
git branch -d nome-branch-da-rimuovere
Ogni volta che si modificano le CSS:
invoke assets
