Storytelling
l’altra parte
Il sito e il blog «l’altra parte» per AL: articoli di storytelling e le immagini social, generati da script che tengono in ordine cartelle e home.
In una frase, e a chi serve
Cos’è. Un repo con due cose separate: il blog «l’altra parte» (articoli di storytelling) e le immagini social usate da Notion e Instagram. La lista articoli in home la genera uno script.
Il problema che risolve. Pubblicare articoli a mano è disordinato. Qui uno script impagina l’articolo e aggiorna la home; le cartelle numerate (NN-slug) restano in ordine cronologico da sole.
Perché è fatto così. Sito statico, semplice da ospitare. Il numero NN è la puntata, così si sa sempre qual è l’ultima. I link alle immagini social sono usati da fuori: non si spostano.
- TomasPubblica un articolo con un comando, senza impaginare niente a mano.
- CollaboratoreAggiunge articoli seguendo il formato .md più lo script di build.
- Lettore (AL)Legge un blog curato e coerente, puntata dopo puntata.
Stack e strumenti
| Strumento | Ruolo nel progetto | Perché scelto |
|---|---|---|
| HTML statico sito | index.html + un index.html per articolo. | Facile da ospitare (GitHub Pages). |
tools/*.py build | Impagina l’articolo e rigenera la home. | Un comando, niente lavoro manuale. |
meta.json dati | Dati dell’articolo per rigenerare la home. | Fonte unica per la lista. |
Cartelle NN-slug ordine | Un numero di puntata per cartella. | Ordine cronologico automatico. |
social/<cliente>/ immagini | Slide 1080x1350 usate da Notion/IG. | Link stabili, da non spostare. |
Regola delle cartelle
| Percorso | Contenuto |
|---|---|
blog/NN-slug/ | index.html + copertina.jpg + meta.json. |
social/<cliente>/NN-slug/ | slide1.png ... (1080x1350). |
Come funziona - il flusso
Aggiungere un articolo: dal testo .md alla pagina pubblicata.
Scrivi
Il testo in un .md con l’intestazione.
Genera
Lo script crea blog/NN-slug/ impaginato.
Home
La lista articoli si aggiorna da meta.json.
Copertina
Sostituisci la copertina segnaposto con la foto vera.
manualePubblica
Commit e deploy del sito statico.
manualesocial/: i link diretti sono usati da Notion e Instagram, spostarli li rompe.Dove finiscono le cose
| Cartella | Contenuto |
|---|---|
index.html | La home (generata dagli script). |
blog/ | Un articolo per cartella NN-slug. |
social/ | Immagini per cliente e per post. |
tools/ | Script e template. |
Onboarding collaboratore + spiegazione cliente
Da zero a produttivo
- Leggi il README: come sono separati
blog/esocial/. - Scrivi
bozza.mdcon l’intestazione (esempio intools/nuovo-articolo.py). - Lancia
python3 tools/nuovo-articolo.py bozza.md. - Sostituisci
copertina.jpg, poi commit e deploy.
Le competenze minime
Markdown per scrivere, Python di base per lanciare lo script e Git per pubblicare. Nessun framework.
Regola d'oro: non rinominare o spostare le cartelle social/ già pubblicate: rompi i link usati da Notion e Instagram.
«Il tuo blog racconta l’altra parte con un’impaginazione curata e coerente, articolo dopo articolo. Le stesse immagini alimentano anche Instagram.»
Ogni puntata è numerata: la storia si legge sempre in ordine.
- Non spostare le cartelle
social/pubblicate: hanno link esterni attivi. - La home è generata: si modifica via
meta.jsone script, non a mano. - Copertine segnaposto: vanno sostituite con la foto vera.
Paletti, limiti e stato
Da fare più avanti
| Automazioni | Collegare la pubblicazione al flusso social. |
| SEO | Meta e anteprime social per ogni articolo. |