added some info about theme used as git submodule

proposta-home
putro 2019-03-27 16:54:27 +01:00
parent cd365c86d7
commit 12360b2b37
1 changed files with 29 additions and 18 deletions

View File

@ -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.