Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
N
Nuovo sito
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Issues
16
Issues
16
List
Boards
Labels
Milestones
Merge Requests
2
Merge Requests
2
Analytics
Analytics
Repository
Value Stream
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Create a new issue
Commits
Issue Boards
Open sidebar
Gruppo Web
Nuovo sito
Commits
4801c26b
Commit
4801c26b
authored
Dec 10, 2015
by
Riccardo Padovani
Browse files
Options
Browse Files
Download
Plain Diff
Merge branch 'master' into scopriUbuntu
parents
a1ff3c26
1e6cc20c
Changes
5
Hide whitespace changes
Inline
Side-by-side
Showing
5 changed files
with
211 additions
and
57 deletions
+211
-57
AUTHORS.md
AUTHORS.md
+8
-0
CONTRIBUTING.md
CONTRIBUTING.md
+176
-0
README.md
README.md
+26
-56
uitwww/navbar.json
uitwww/navbar.json
+1
-1
uitwww/templates/pages/scopri-ubuntu/index.html
uitwww/templates/pages/scopri-ubuntu/index.html
+0
-0
No files found.
AUTHORS.md
0 → 100644
View file @
4801c26b
This site was started in 2015 and has received many contributions from the
following people.
In addition, numerous translations, bug reports and other non-code contributions
have been made which are equally valued.
Pietro Albini
<pietroalbini@ubuntu.com>
Riccardo Padovani
<rpadovani@ubuntu.com>
CONTRIBUTING.md
0 → 100644
View file @
4801c26b
Ciao, e grazie per il tuo interessamento su come migliorare il sito web di
Ubuntu-it :-)
## Come contribuire
Il Gruppo Web è composto dai contributori occasionali e dal core team. Fanno
parte del core team tutti quei contributori che hanno mostrato costanza nel
partecipare alle attività del team. Chi fa parte del core team ha la membership
del gruppo ubuntu-it-www su Launchpad, come segno di riconoscimento. La
membership ha rinnovo semestrale.
### Cosa c'è da fare
Non c'è bisogno di essere sviluppatori per aiutarci :-) Basta avere voglia di
fare e di imparare. Di seguito scriviamo le tre maggiori aree di contributo, ma
se pensi che le tue abilità possano servirci e vuoi aiutarci, scrivici!
### Prerequisiti
-
Creazione di un account Launchpad
-
Richiesta di un account su code.ubuntu-it.org
-
Firma del codice di condotta
-
Conoscere l'inglese, almeno a livello basilare
### Design
Hai qualche suggerimento su come migliorare il tema, o vuoi creare immagini da
mettere sul sito, ma non sai programmare? Non c'è problema, scrivici i tuoi
suggerimenti, ci penseremo noi a trasformarli in realtà ;-)
Per iniziare, iscriviti alla nostra
[
mailing list
][
ml
]
e presentati, linkando il
tuo account Launchpad e spiegando cosa vuoi fare!
### Contenuti
Ti piace scrivere? Sai creare contenuti che attirano e sorprendono? Vienici a
trovare! Il sito web è in continua espansione, e aggiungiamo sempre nuove pagine
con i nuovi fantastici contenuti della comunità e di Ubuntu stesso.
### Sviluppatori
Il sito è un sito statico, generato da Python grazie a Flask - non conosci
queste tecnologie? Non preoccuparti, basta sapere un po' di HTML e un po' di CSS
per poter aiutarci a scrivere il codice!
Il tema è basato sull'
[
Ubuntu Vanilla Theme
][
vanilla
]
sviluppato da Canonical,
con alcune modifiche apportate da noi.
Non conosci niente di tutto questo ma vuoi imparare? Sei il benvenuto, questo è
un team dove si impara tutti insieme :-)
Per iniziare, puoi installare il sito e il tema in locale e iniziare a guardare
i bug presenti su questo sito
Nel frattempo, iscriviti alla nostra
[
mailing list
][
ml
]
e presentati, linkando
il tuo account Launchpad, ti forniremo un account su code.ubuntu-it.org, dove è
ospitato il nostro codice.
Il server di test è ospitato a questo indirizzo:
[
http://wwwtest.ubuntu-it.org
][
test
]
Fai anche un salto su
[
#ubuntu-it-web su Freenode
][
irc
]
per conoscerci, così
parliamo di cosa c'è bisogno di fare. Come avrai notato, il lavoro è tanto ;-)
## Istruzioni per gli sviluppatori
Innanzitutto, ricordati che devi configurare git per poter lavorare con questo
sito, così come spiegato
[
qua
][
git
]
.
### Git workflow
Una cosa importante: per ogni contributo (un bug fix, una nuova feature), crea
un nuovo branch partendo da
`master`
. Per ovvie ragioni non puoi pushare
direttamente in master, ma dovrai fare una
`Merge Request`
e aspettare che
qualcuno del team faccia una review.
Controlla quindi di essere nel master, avere il codice aggiornato, e crea il tuo
branch:
```
git checkout master
git pull
git checkout -b ilMioNuovoContributo
```
E ricordati di aggiungere il tuo nome al file AUTHORS.md ;-)
### Preparare l'ambiente per lo sviluppo
*Testato su Ubuntu 14.04*
Per preparare l'ambiente di sviluppo è necessario disporre di Python 3,
[
virtualenv
][
2
]
,
[
pyinvoke
][
3
]
e nodejs.
```
pip install invoke
```
Dopo averli installati si può generarlo con il seguente comando:
```
invoke devel
```
Esso scaricherà tutte le dipendenze da internet (la prima volta), compilerà gli
assets e creerà un virtualenv con dentro installato il sito (in modalità
modificabile). Per attivare il virtualenv, bisogna dare in ogni sessione di
terminale il seguente comando:
```
source build/envs/devel/bin/activate
```
Se si modificano gli assets è necessario ricompilarli. Lo si può effettuare con
il seguente comando:
```
invoke assets
```
In caso si facciano modifiche frequenti, può risultare conveniente l'aggiunta
della flag
`-w`
al comando, che ricompila gli assets quando sono rilevate
modifiche.
### Esecuzione del sito in locale
Per eseguire il sito in locale, è possibile eseguire questo comando (una volta
dentro il virtualenv o con il sito installato globalmente):
```
uitwww run -d -p 8000
```
Esso avvierà un'istanza in debug-mode (
*da non eseguire in produzione!!!*
), che
ascolta su
[
localhost:8000
][
localhost
]
. Se si vuole attivare anche la cache
statica, bisogna aggiungere come argomento il path della directory che la dovrà
contenere:
```
uitwww run -d -p 8000 path/to/cache
```
## Generazione di una build
Per creare una build dell'intero sito, è necessario disporre di Python 3,
[
virtualenv
][
2
]
,
[
pyinvoke
][
3
]
e nodejs. Dopo averli installati si può crearla
con il seguente comando:
```
$ invoke build
```
Esso scaricherà tutte le dipendenze da internet (la prima volta), compilerà gli
assets e genererà il pacchetto, salvandolo in
``build/packages``
. È possibile
rimuovere tutti i file creati dal processo con il comando:
```
$ invoke clean
```
[
2
]:
https://virtualenv.pypa.io
[
3
]:
http://www.pyinvoke.org
[
git
]:
http://code.ubuntu-it.org/ubuntu-it-web/www/wikis/git-setup
[
ml
]:
http://liste.ubuntu-it.org/cgi-bin/mailman/listinfo/gruppo-web
[
irc
]:
http://chat.ubuntu-it.org/#ubuntu-it-web
[
vanilla
]:
https://github.com/ubuntudesign/ubuntu-vanilla-theme
[
test
]:
http://wwwtest.ubuntu-it.org
[
localhost
]:
http://localhost:8000
README.md
View file @
4801c26b
...
...
@@ -3,74 +3,44 @@
Questo repository contiene tutto il codice sorgente del
[
sito web
][
1
]
di
ubuntu-it. Il tutto è rilasciato sotto licenza GNU-AGPL v3+.
Il sito è realizzato con
[
flask
](
http://flask.pocoo.org
)
e Python 3.
Per contribuire dai un'occhiata al file CONTRIBUTING.md
## Esecuzione del sito in locale
Il gruppo web si pone come obiettivo la diffusione, con la massima chiarezza e
semplicità, di tutte le informazioni necessarie all'utenza italiana di Ubuntu,
aggiornamento notizie e informazioni generali di supporto, ad integrazione degli
altri gruppi della comunità italiana.
Per eseguire il sito in locale, è possibile eseguire questo comando (una volta
dentro il virtualenv o con il sito installato globalmente):
```
$ uitwww run -d -p 8000
```
## Chi siamo
Esso avvierà un'istanza in debug-mode (
*da non eseguire in produzione!!!*
), che
ascolta su
`localhost:8000`
. Se si vuole attivare anche la cache statica,
bisogna aggiungere come argomento il path della directory che la dovrà
contenere:
-
DarioCavedon (
*ic3d*
) -
**Amministratore**
-
PietroAlbini (
*pietroalbini*
) -
**Amministratore**
-
RiccardoPadovani (
*rpadovani*
)
-
PaoloRotolo (
*paolorotolo*
)
-
MattiaMigliorini (
*deshack*
)
-
SilviaBindelli (
*Dolasilla*
)
-
EmanueleBoncimino (
*almaidinajad*
)
-
LucaLumetti (
*lumetti-luca*
)
-
MercuryTuts (
*mercurytuts*
)
```
$ uitwww run -d -p 8000 path/to/cache
```
##
Generazione di una build
##
Planet Ubuntu-it
Per creare una build dell'intero sito, è necessario disporre di Python 3,
[
virtualenv
][
2
]
,
[
pyinvoke
][
3
]
e nodejs. Dopo averli installati si può crearla
con il seguente comando:
Il
[
planet italiano di Ubuntu
][
planet
]
è gestito dal gruppo Web.
```
$ invoke build
```
Per qualunque informazione, segnalazione o suggerimento che riguarda il planet,
scrivere a planet@ubuntu-it.org.
Esso scaricherà tutte le dipendenze da internet (la prima volta), compilerà gli
assets e genererà il pacchetto, salvandolo in
``build/packages``
. È possibile
rimuovere tutti i file creati dal processo con il comando:
```
$ invoke clean
```
## Contatti
## Hacking
Per qualunque informazione, segnalazione o suggerimento che riguarda il Gruppo
Web potete:
Per preparare l'ambiente di sviluppo è necessario disporre di Python 3,
[
virtualenv
][
2
]
,
[
pyinvoke
][
3
]
e nodejs. Dopo averli installati si può
generarlo con il seguente comando:
-
scrivere a gruppo-web@ubuntu-it.org.
-
postare nella
[
sezione rilevante sul forum
][
forum
]
```
$ invoke devel
```
Esso scaricherà tutte le dipendenze da internet (la prima volta), compilerà gli
assets e creerà un virtualenv con dentro installato il sito (in modalità
modificabile). Per attivare il virtualenv, bisogna dare in ogni sessione di
terminale il seguente comando:
```
$ source build/envs/devel/bin/activate
```
Se si modificano gli assets è necessario ricompilarli. Lo si può effettuare con
il seguente comando:
```
$ invoke assets
```
In caso si facciano modifiche frequenti, può risultare conveniente l'aggiunta
della flag
`-w`
al comando, che ricompila gli assets quando sono rilevate
modifiche.
[
1
]:
http://www.ubuntu-it.org
[
2
]:
https://virtualenv.pypa.io
[
3
]:
http://www.pyinvoke.org
[
planet
]:
http://planet.ubuntu-it.org
[
forum
]:
http://forum.ubuntu-it.org/viewforum.php?f=45
uitwww/navbar.json
View file @
4801c26b
...
...
@@ -11,7 +11,7 @@
},
{
"name"
:
"Scopri Ubuntu"
,
"endpoint"
:
"pages.scopri
U
buntu_index"
,
"endpoint"
:
"pages.scopri
-u
buntu_index"
,
"subs"
:
[]
},
{
...
...
uitwww/templates/pages/scopri
U
buntu/index.html
→
uitwww/templates/pages/scopri
-u
buntu/index.html
View file @
4801c26b
File moved
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment