2016pgdayIT

Questo progetto ospita il sito del PGDAY.it 2016. Usiamo Pelican, e Python 3 come versione dell'interprete.

Documentazione ufficiale di Pelican

Installazione

Consigliamo di creare un ambiente virtuale python e utilizzare quello come ambiente di sviluppo.

$ mkvirtualenv -p python3 pgday_www  # se si usa virtualenvwrapper
$ virtualenv3 pgday_www              # se non si usa virtualenvwrapper

Su Debian può essere necessario indicare il path completo di Python:

$ mkvirtualenv -p /usr/bin/python3 pgday_www

Attivare il virtualenv con

$ workon pgday_www          # se si usa virtualenvwrapper
$ . pgday_www/bin/activate  # se non si usa virtualenvwrapper

Installare le dipendenze con

$ pip install -r pip_requirements

Verificare che tutto funzioni con

$ pelican

il risultato dovrebbe essere qualcosa di molto simile a

Done: Processed 4 articles, 0 drafts, 6 pages and 1 hidden page in 1.12 seconds.
Done: Processed 4 articles, 0 drafts, 6 pages and 1 hidden page in 2.45 seconds.

Provare il sito

Per provare il sito, ci sono diversi modi, tra cui

cd output/ && python -m http.server

Consultare la documentazione ufficiale di pelican per scoprire altri metodi. Documentazione ufficiale di Pelican

Contribuire

Pagine e news

Per modificare una pagina del sito, aprire con un editor di testo uno dei file con estensione rst presenti nella cartella content/pages e modificarne il contenuto.

Le news sono semplici pagine che si trovano nella cartella content/news/.

La sintassi utilizzata e' ReStructuredText. Referenza della sintassi RST.

Una volta terminate le modifiche, generare il sito con

$ pelican

Configurazioni avanzate

Ci sono tutta una serie di parametri che e' possibile configurare attraverso un file di configurazione scritto in python.

Ad esempio, il programma non e' una pagina, bensi' viene generato in automatico dalla configurazione.

I file di configurazione sono in tutto 3:

settings/base.py      # contiene le configurazioni generiche
settings/theme_it.py  # contiene le configurazioni per l'italiano
settings/theme_en.py  # contiene le configurazioni per l'inglese

Se si aprono questi file si scoprira' che i parametri sono tutti auto esplicativi, in futuro metteremo qui una lista di tutti i parametri.

Una volta modificato un file di configurazione, rigenerare il sito con

$ pelican

Traduzione dei template

E' possibile, anzi e' un dovere, tradurre tutte le stringhe del sito che non appartengono al contenuto di una pagina.

Ad esempio, i titoli delle sezioni della homepage sono tutte stringhe da tradurre.

La traduzione avviene in 3 passaggi:

• Estrazione delle stringhe marcate per la traduzione
• Traduzione vera e propria
• Compilazione delle stringhe tradotte

Estrazione delle stringhe da tradurre

Posizionarsi nella cartella root del progetto ed eseguire:

./update_translations.sh

Traduzione vera e propria

Modificare i file:

$ awesomeconference_theme/translations/it/LC_MESSAGES/messages.po # per l'italiano
$ awesomeconference_theme/translations/en/LC_MESSAGES/messages.po # per l'inglese

Aggiungendo o modificando le traduzioni

Compilazione delle stringhe tradotte

Posizionarsi nella cartella root del progetto ed eseguire:

./compile_translations.sh

Generare di nuovo il sito per controllare.

Ricordarsi infine di aggiungere al repository sia i file sorgente (.pot e .po) sia i file compilati (.mo).