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

  1. 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.
  2. 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:
  3. il testo: un file Word (.docx), .md o .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;
  4. 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»;
  5. 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-2 prima di foto-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 wordpress e 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 voce argomenti.
  • 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 è tag né 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.