diff --git a/LEGGIMI.md b/LEGGIMI.md index bba9ef9..654c827 100644 --- a/LEGGIMI.md +++ b/LEGGIMI.md @@ -19,6 +19,9 @@ 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) +ad es. index.md ha un Save_as: index.html che fa override della direttiva PAGE_SAVE_AS +e permette di salvare la pagina come index.html nella root invece che nella sottocartella index + per gli articoli ad es.: - Title: Comunicato Unit hacklab su annuncio sgombero Macao @@ -27,23 +30,39 @@ per gli articoli ad es.: - Date: 2018-09-26 - Tags: sgombero -nella cartella output le pagine sono salvate nella sottocartella pages +nella cartella output le pagine sono salvate nella sottocartella nome_pagina/index.html (direttiva PAGE_SAVE_AS) -e gli articoli nella cartella blog (direttiva ARTICLE_SAVE_AS) +si possono fare eccezioni a questo, ad esempio la pagina index non puo' finire in index/index.html, +quindi si definisce il metadato Save_as che fa override di PAGE_SAVE_AS e definisce come salvare la pagina, +in questo caso specificando index.html finisce nella root (stessa cosa si fa per la pagina 404.md) + +gli articoli invece vengono salvati 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. -> https://github.com/sQu4rks/crowsfoot/blob/30509fc0cf6d4c29f2d1d9ec87783340a7158538/templates/base.html -> https://github.com/nairobilug/pelican-alchemy/blob/f235c81bf323e6134b01915fc9a46b5e89ac238b/alchemy/templates/base.html +il tema usato e' "minimo" di dan ed e' definito come submodule di git -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. +quindi ora per clonare il repository: + +> git clone --recursive (--recursive per fare anche il clone dei submodules) + +> git submodule update --init + +per lavorare sul repository, fare pull e aggiornare anche il submodulo: + +> git pull --recurse-submodules + +> git submodule update --remote + +se il submodule contiene degli aggiornamenti, bisogna committarli nel repository del sito: + +> git add theme/minimo + +> git commit -m "aggiornato tema" + +> git push in cima alla pagina c'e' un piccolo menu con poche voci: @@ -77,11 +96,3 @@ 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. -