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
bba2816e
Commit
bba2816e
authored
Dec 10, 2015
by
Riccardo Padovani
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update contributing and readme
parent
5ef7ba67
Changes
2
Show whitespace changes
Inline
Side-by-side
Showing
2 changed files
with
65 additions
and
56 deletions
+65
-56
CONTRIBUTING.md
CONTRIBUTING.md
+39
-0
README.md
README.md
+26
-56
No files found.
CONTRIBUTING.md
View file @
bba2816e
...
...
@@ -91,6 +91,8 @@ 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*
...
...
@@ -128,6 +130,42 @@ 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
...
...
@@ -135,3 +173,4 @@ modifiche.
[
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 @
bba2816e
...
...
@@ -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
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