Come si pubblica
Per la redazione di ETN Magazine. Lo scrive il Cantiere; è la fonte unica: il sito lo pubblica così com'è nella pagina della redazione
/redazione/come-si-pubblica/, che i motori di ricerca non leggono. Due cose: un articolo nuovo, con «Nuovo articolo» (da B.4c a un gesto: la cartella, i campi proposti, la scheda facoltativa), e la serie delle sezioni.
Un articolo nuovo con «Nuovo articolo»
La pagina «Nuovo articolo» sta in /redazione/nuovo-articolo/. Si entra con
la propria email: arriva un codice di 6 cifre, che vale un'ora. Possono
entrare solo i redattori del magazine. Dopo l'accesso il browser ricorda la
sessione fino a «Esci» (in alto a destra, accanto al nome, e nel riquadro
«Pubblicato.»).
Il gesto
- La sezione. Il modo più semplice è partire dalla pagina della sezione del sito: chi ha fatto l'accesso vede il bottone «Nuovo articolo in …», e la pagina «Nuovo articolo» si apre con la sezione già scelta. Aprendo la pagina direttamente, si sceglie la sezione con uno dei quattro bottoni. Scelta la sezione, non si cambia: per un'altra sezione si parte dalla sua pagina.
- La cartella dell'articolo. Si trascina la cartella nella pagina, o la si sceglie con «Scegli la cartella». Sul telefono, «Scegli i file» prende più file insieme. Nella cartella:
- il testo: un file Word (
.docx),.mdo.txt. In alternativa il testo si incolla nella casella «Il testo dell'articolo», da Word o da Google Docs: titoli, elenchi, tabelle e collegamenti restano; - la copertina: l'immagine che si chiama «copertina» (o «cover»), JPEG, PNG o WebP, larga almeno 1.200 px. Se nessuna immagine si chiama così, la pagina propone la prima immagine orizzontale larga almeno 1.200 px, e sotto ogni foto c'è «Usa come copertina»;
- le foto della galleria: tutte le altre immagini, JPEG, PNG o WebP,
fino a 40, ognuna fino a 20 MB e larga almeno 600 px. Vanno nella
galleria in ordine di nome (
foto-2prima difoto-10); la didascalia di ogni foto si scrive sotto la sua miniatura.
La pagina dice che cosa ha riconosciuto («Testo: … · Copertina: … · Foto della galleria: …») e mostra le miniature: è lì che ci si accorge di una foto sbagliata. Le sottocartelle non si usano (per esempio «scarti»), e i file che non sono testo né immagini (un PDF, un video) non si pubblicano: la pagina lo dice. Le immagini dentro il Word non si pubblicano: vanno nella cartella come file. 3. I campi. La pagina propone titolo, sintesi, argomenti, testo alternativo della copertina e scadenze (qui sotto); si controllano e si correggono. La rubrica e la firma si scelgono; l'indirizzo e la data si vedono e non si scrivono. 4. Le liberatorie. Si spunta la conferma: vale per la copertina e per le foto insieme (D-031, D-035). Se ci sono persone riconoscibili, servono le loro liberatorie; per i minori, firmate dai genitori. Il magazine conserva chi ha confermato e quando. 5. Controlla: la pagina dice che cosa correggere (gli errori) e che cosa le è sembrato strano (gli avvisi, che non impediscono di pubblicare), e mostra l'anteprima: l'articolo come apparirà, con «Leggi anche» e i riquadri delle date di oggi. Dopo ogni correzione si preme di nuovo «Controlla». 6. Pubblica: la pagina carica le foto, salva l'articolo, e il sito si aggiorna da solo in qualche minuto.
Per ricominciare con un'altra cartella c'è «Cambia la cartella».
Le foto dell'iPhone in HEIC non si accettano: vanno esportate in JPEG. La pagina riduce copertina e foto nel browser, alle tre misure del magazine (400, 960 e 1.600 px, in WebP), e carica solo quelle: l'originale resta sul computer o sul telefono di chi l'ha scattata, con i suoi dati di posizione. Il Word si converte nel browser: il file non lascia il computer, con i suoi commenti e le revisioni.
I campi proposti dall'AI
Quando il testo e la copertina sono pronti, la pagina chiede all'AI del magazine (Claude Sonnet 5.5 di Anthropic, ADR-013) una proposta per i campi che mancano. All'AI vanno il testo dell'articolo, la copertina ridotta a 960 px e gli elenchi del magazine (sezioni, rubriche, argomenti); mai le foto della galleria, mai il file Word, mai i dati di chi pubblica.
L'AI propone e basta: niente si pubblica senza «Pubblica». Ogni campo proposto porta il segno «Proposto dall'AI: controllalo.» finché non lo si tocca. La pagina controlla la proposta prima di mostrarla:
| Campo | Che cosa propone l'AI | Che cosa controlla la pagina |
|---|---|---|
| Titolo | il titolo, o quello che il testo ha già in testa (# …) |
il contatore: oltre 90 caratteri lo dice |
| Sintesi | due frasi: la notizia e che cosa trova chi legge | il contatore: oltre 220 caratteri lo dice; se è troppo lunga, la chiede accorciata una volta |
| Argomenti | da 2 a 5, prima quelli che il magazine ha già | toglie i doppioni; ne tiene al massimo 5; un argomento scritto in un altro modo diventa quello che c'è |
| Testo alternativo della copertina | che cosa si vede nella copertina, in una frase | il contatore: oltre 150 caratteri lo dice |
| Scadenze | le date che il testo dice in modo esplicito | tiene solo quelle scritte nel testo, con la data scritta per intero; toglie l'ora che il testo non dice e le date già passate |
Se l'AI non risponde entro 20 secondi, o risponde male, la pagina dice «La proposta non è arrivata: scrivi tu i campi.» e funziona lo stesso.
Obbligatori per pubblicare: titolo, sintesi, testo alternativo della copertina, la copertina, la sezione e la conferma delle liberatorie.
Correggere un articolo pubblicato
Un articolo pubblicato con «Nuovo articolo» si corregge da «Correggi un articolo già pubblicato»: l'elenco ha tutti gli articoli pubblicati da questa pagina, da qualunque redattore (D-052). Si sceglie l'articolo, si carica la cartella con la versione giusta, si controllano i campi. L'indirizzo resta lo stesso, anche se cambia il titolo. La pagina dice che l'articolo sostituisce quello di prima e che cosa cambia (il titolo, le foto, le scadenze, il testo); il bottone diventa «Pubblica e sostituisci» (D-036). L'articolo nuovo prende il posto di quello vecchio, con i suoi argomenti, le scadenze e le foto; le foto tolte si cancellano.
Un articolo arrivato da WordPress non si sostituisce. Per ritirare un articolo si chiede a chi gestisce il magazine.
Fino alla messa online
Finché il magazine di oggi è WordPress, la redazione pubblica lì e il giro degli articoli li porta nel magazine nuovo. Prima della messa online un articolo pubblicato con «Nuovo articolo» si vede soltanto sul sito di prova, protetto da una password (D-034).
La scheda, se vuoi
La scheda in testa al testo è facoltativa (D-047): la pagina compone i
campi da sé. Chi la scrive, come la redazione nei suoi file, la vede valere:
le sue voci riempiono i campi, e l'AI propone solo quelli che mancano. Le voci
copertina e foto cedono alla cartella: contano i file della cartella, e se
la scheda ne nomina uno che non c'è la pagina lo dice con un avviso. La voce
sezione cede alla sezione scelta: se è un'altra, la pagina lo dice. Le voci
che la pagina non mostra come campi (data, slug, guida, tappa,
domanda) valgono come sono.
La scheda sta in testa al file, fra due righe con tre trattini. Ogni riga è una voce: il nome della voce, i due punti, uno spazio, il valore. Il valore va fino alla fine della riga, anche se contiene altri due punti. Un esempio, con i dati dell'articolo sul DM 38 della redazione:
---
titolo: «DM 38, formazione dei docenti: i percorsi si chiudono entro il 31 agosto 2027»
sezione: Bandi e notizie
rubrica: nessuna
autore: Redazione ETN
data: 2026-11-15
copertina: dm38-formazione-docenti.jpg
copertina_alt: Un gruppo di docenti in cerchio in un laboratorio, con un formatore in piedi
copertina_didascalia: Immagine generata con l'intelligenza artificiale
sintesi: «Il DM 38/2026 ha dato a 7.476 scuole da 14.000 a 56.000 euro per formare i docenti. I percorsi si chiudono entro il 31 agosto 2027: moduli, figure, costi e delibere.»
argomenti: DM 38/2026, PN Scuola e competenze 2021-2027, Formazione Docenti, scadenze
scadenza: 2027-08-31 | DM 38, formazione docenti | I percorsi si chiudono formalmente
---
Le voci:
| Voce | Obbligatoria (se non c'è il campo) | Che cosa ci va | La pagina rifiuta l'articolo se… |
|---|---|---|---|
titolo |
sì | il titolo; le virgolette « » ai due capi si tolgono | manca o è vuoto |
sezione |
sì | una delle quattro sezioni, con il nome o con lo slug: Mobilità per l'apprendimento (mobilita), Formazione (formazione), AI e tecnologie (ai-e-tecnologie), Bandi e notizie (bandi-e-notizie) |
non è una delle quattro |
rubrica |
no | una delle quattro rubriche: Dal laboratorio, Provato in classe, Il passo della scuola, Scadenzario; oppure nessuna |
non è una delle quattro |
autore |
sì | il nome di un autore del magazine, com'è scritto nel magazine; per un articolo senza un autore, Redazione ETN |
non è fra gli autori del magazine |
data |
no | il giorno di uscita, così: 2026-11-16; vuota o assente, il giorno in cui si preme «Pubblica» |
non è una data; è nel futuro |
copertina |
sì | il nome del file della copertina, uguale a quello del file scelto nella pagina | manca; il file non è fra quelli scelti; è largo meno di 1.200 px |
copertina_alt |
sì | il testo alternativo: che cosa si vede nella copertina, per chi non la vede | manca o è vuoto |
copertina_didascalia |
no | la didascalia della copertina, per esempio «Immagine generata con l'intelligenza artificiale» | — |
sintesi |
sì | due righe sull'articolo; le virgolette « » ai due capi si tolgono | manca o è vuota |
argomenti |
no | i tag, separati da virgole; un tag che c'è già nel magazine si riusa, uno nuovo si crea | c'è un tag vuoto (due virgole di fila, una virgola in fondo) |
scadenza |
no, si ripete | una data da tenere d'occhio, nei riquadri delle date: la data, un'etichetta e una riga, divise da una barra verticale (qui sotto); l'ora, facoltativa, dopo la data. Una riga per scadenza | la data non si legge; manca l'etichetta o la riga |
foto |
no, si ripete | una foto della galleria: il nome del file e la didascalia, divisi da una barra verticale (qui sotto); la didascalia è facoltativa. Una riga per foto, nell'ordine della galleria | il file non è fra quelli scelti; è largo meno di 600 px |
guida, tappa, domanda |
no, tutte e tre insieme | per un capitolo di una guida della newsletter: la guida, il numero della tappa, la domanda | ce n'è una o due; la guida non c'è ancora nel magazine; la tappa non è un numero |
slug |
no | l'indirizzo dell'articolo, /articoli/<slug>/; se manca, si fa dal titolo come in WordPress |
è quello di un articolo arrivato da WordPress |
Le scadenze e le foto, una per riga:
scadenza: 2026-11-30 | etichetta | una riga
scadenza: 2026-11-18 15:00 | etichetta | una riga
foto: nome-del-file.jpg | didascalia
foto: un-altro-file.jpg
Ancora sulla scheda:
- I segnaposto. Un valore fra parentesi quadre è un segnaposto (per esempio una data «da confermare»), nella scheda come nei campi: la pagina rifiuta l'articolo e dice il campo. Prima di pubblicare si scrive il testo vero.
- Le virgolette dritte. Un valore fra virgolette dritte ai due capi le perde.
- La voce
wordpresse le righe rientrate sotto di lei (le categorie e i tag di WordPress) non servono qui: la pagina le ignora e lo dice con un avviso. I tag vanno nella voceargomenti. - Una voce che la pagina non conosce (per esempio
immagine, la proposta per il fotografo) si ignora, con un avviso.
La sezione: la prova di «Bandi e notizie»
Prima di scegliere la sezione, la prova di D-026: l'articolo serve anche a una scuola che non lavorerà mai con ETN? Se sì, va in «Bandi e notizie». La notizia di un bando, le guide su come si partecipa, le Call Erasmus+, decreti e riforme vanno in «Bandi e notizie»; come usare un bando con le proposte di ETN va nella sezione dell'argomento (Formazione, AI e tecnologie, Mobilità). La pagina non lo può controllare: lo ricorda accanto ai bottoni delle sezioni.
La firma
Nella pagina la firma si sceglie: «Firmato da te», con il nome di autore del
redattore, oppure Redazione ETN (D-038), che nella pagina dell'articolo si
legge senza «Di» davanti, perché non è una persona. Nella scheda è la voce
autore: il nome di un autore del magazine. Chi firma con il suo nome deve
essere fra gli autori del magazine: se non c'è, lo aggiunge chi gestisce il
magazine.
Il testo in Markdown
Chi scrive in Word o incolla il testo non deve sapere niente di Markdown: la
pagina lo converte. Chi scrive un file .md o .txt, dopo la scheda (se c'è)
scrive il testo in Markdown:
- il primo titolo con un solo
#in testa al testo è il titolo dell'articolo: la pagina lo propone come titolo e lo toglie dal testo. Un altro titolo con un solo#resta, con un avviso; - i paragrafi hanno i titoli con
##, le parti di un paragrafo con###. Con almeno due titoli l'articolo ha l'indice a sinistra; - le tabelle si scrivono come in queste pagine, con le righe fra
|; - i collegamenti si scrivono con il testo fra parentesi quadre e l'indirizzo fra parentesi tonde, come sempre in Markdown;
- nel testo non vanno immagini: le foto vanno nella cartella, e la galleria la fa il sito. Un'immagine nel testo resta solo con il suo testo alternativo;
- l'HTML scritto nel testo si mostra com'è, come testo.
La serie delle sezioni: redazione/serie.csv
Nella pagina di una sezione, sotto l'articolo in apertura, c'è una riga di
quattro articoli con un titolo e il collegamento «Tutta la serie» (giro di
design, riga 9; D-029). Quale serie mostrare lo sceglie la redazione nel file
redazione/serie.csv. Il file lo crea e lo cambia la redazione; il Cantiere lo
legge e basta.
Il formato
Un file CSV in UTF-8, con la virgola come separatore e questa prima riga:
sezione,tipo,slug,titolo
Poi una riga per serie:
| Colonna | Che cosa ci va | Valori |
|---|---|---|
sezione |
la sezione in cui la serie si mostra | mobilita, formazione, ai-e-tecnologie, bandi-e-notizie |
tipo |
da dove vengono gli articoli | tag oppure rubrica |
slug |
lo slug del tag (com'è in WordPress) o della rubrica | per esempio ka120, dal-laboratorio |
titolo |
il titolo della riga, con la parola in corsivo fra asterischi | per esempio La serie sull'*accreditamento* KA120 VET |
Un titolo che contiene una virgola va fra virgolette doppie:
"Erasmus+, la serie *KA2*".
Un esempio:
sezione,tipo,slug,titolo
mobilita,tag,ka120,La serie sull'*accreditamento* KA120 VET
formazione,rubrica,dal-laboratorio,Le storie *dal laboratorio*
Che cosa mostra la pagina
- Una sezione può avere più righe. La pagina mostra la serie con l'articolo più recente.
- Della serie scelta mostra i quattro articoli più recenti in quella sezione: in italiano e nelle pagine della sezione.
- «Tutta la serie» porta all'archivio filtrato per quel tag
(
/archivio/?tag=<slug>) oppure alla pagina della rubrica (/rubriche/<slug>/). - La serie si vede solo nella prima pagina della sezione.
- Senza file, senza righe per una sezione o senza articoli, la riga non c'è.
Quando il file non va
uv run magazine genera si ferma e dice la riga del file quando:
- manca una delle quattro colonne;
- la sezione non è una delle quattro;
- il tipo non è
tagnérubrica; - il tag o la rubrica non esiste nel magazine;
- il titolo è vuoto, oppure ha un numero dispari di asterischi (il corsivo non è chiuso).
Le righe vuote non contano.
Per controllare il file prima di consegnarlo, si lancia
uv run magazine genera --uscita /tmp/sito-prova e si guarda che cosa stampa:
la riga «La serie (redazione/serie.csv): N righe», poi una riga per sezione,
che dice quale serie si vede.