added some info about theme used as git submodule

This commit is contained in:
putro 2019-03-27 16:54:27 +01:00
parent cd365c86d7
commit 12360b2b37

View File

@ -19,6 +19,9 @@ per le pagine statiche:
- Title (il titolo che poi compare a video nella pagina finale html) - Title (il titolo che poi compare a video nella pagina finale html)
- Slug (il nome con cui la pagina sara' salvata nella cartella output) - 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.: per gli articoli ad es.:
- Title: Comunicato Unit hacklab su annuncio sgombero Macao - Title: Comunicato Unit hacklab su annuncio sgombero Macao
@ -27,23 +30,39 @@ per gli articoli ad es.:
- Date: 2018-09-26 - Date: 2018-09-26
- Tags: sgombero - 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) (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 gli articoli finiscono nel feed rss, le pagine no, quindi se si crea una pagina
e' bene fare anche un articolo che la "presenti". 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)) il tema usato e' "minimo" di dan ed e' definito come submodule di git
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
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) quindi ora per clonare il repository:
c'e' anche altro intorno, andrebbe sistemato.
> 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: 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) (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.