website-pelican/LEGGIMI.md

PELICAN WEBSITE HOWTO

pelicanconf.py:

in questo file si definiscono un tot di cose, tra cui:

i contenuti stanno nella cartella "content", vengono scritti in markdown e sono di due tipi:

• pagine statiche (nella sottocartella "pages")
• articoli tipo blog (nella sottocartella "blog")

una volta elaborati sono salvati nella cartella "output" che e' quella che conterrà i files .html del sito vero e proprio

in testa ai files .md devono essere definiti dei metadati:

per le pagine statiche:

• Title (il titolo che poi compare a video nella pagina finale html)
• Slug (il nome con cui la pagina sara' salvata nella cartella output)

per gli articoli ad es.:

• Title: Comunicato Unit hacklab su annuncio sgombero Macao
• Author: Unit
• Category: comunicato
• Date: 2018-09-26
• Tags: sgombero

nella cartella output le pagine sono salvate nella sottocartella pages (direttiva PAGE_SAVE_AS) e gli articoli nella cartella blog (direttiva ARTICLE_SAVE_AS)

gli articoli finiscono nel feed rss, le pagine no, quindi se si crea una pagina e' bene fare anche un articolo che la "presenti".

il tema usato e' "minimo" di dan (ho fatto solo una piccola modifica per includere il logo di unit in tutte le pagine (vedi templates/base.html)) in realta' andrebbe modificato il css in modo che se e' definito ad esempio SITE_LOGO in pelicanconf.py, compaia il logo di fianco a Unit, e non sotto (per come fare vedi ad es.

30509fc0cf/templates/base.html f235c81bf3/alchemy/templates/base.html

altra cosa che si potrebbe fare: usare il tema come submodulo git del sito, in modo che siano due cose separate, ma al momento minimo non e' in git come se fosse solo un tema (cioe' solo le cartelle templates e static) c'e' anche altro intorno, andrebbe sistemato.

in cima alla pagina c'e' un piccolo menu con poche voci:

• HOME (index)
• BLOG (lista degli articoli con anteprima (articles.html), volendo ci sarebbe anche la pagina archives.html che contiene la lista degli articoli ma senza anteprima.
• CATEGORIE (lista delle categorie degli articoli, cliccabile)
• TAG (lista dei tag degli articoli, cliccabile)
• CONTATTI (pagina che riporta i contatti)
• RSS (link al feed rss (atom))

ci sono due cartelle statiche:

• media (che contiene i materiali delle pagine, pdf, immagini etc.)
• images (che contiene le immagini della struttura del sito, al momento solo il logo))

publishconf.py

questo file definisce solo il SITEURL in produzione e l'indirizzo dei feed rss e atom creati (quando sostituiremo il sito perderemo tutti i feed precedenti, a meno di creare degli articoli nel blog, pero' poi mi sa che chi ha sottoscritto il feed li ricevera' di nuovo.... ? per or

Makefile

e' il makefile standard con le istruzioni per SSH per caricare il sito e un nuovo comando "production" per copiare il sito al suo posto (ma funziona solo se viene lanciato da zaphoda)

TODO: il sito ora e' visibile su https://unit.abbiamoundominio.org/tmp/, visto che sta in una sottocartella, in produzione per i menuitems andra' aggiunto un / prima di ogni pagina stessa cosa per il tema, e l'immagine del logo dovra' avere uno / prima del path (questo perche' senno' se sei nella cartella /categories/qualcosa poi non funzionano piu' i link, se sono relativi)

valutare magari di mettere una pagina 404 (o meglio ancora 40x) da configurare in nginx.