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
9 years ago
by
Riccardo Padovani
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Update contributing and readme
parent
5ef7ba67
Changes
2
Hide 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
This diff is collapsed.
Click to expand it.
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
This diff is collapsed.
Click to expand it.
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