Lavorare con i contenuti

Usa l’admin EmDash per portare una voce dalla prima bozza a una pagina pubblicata. L’editor mantiene le modifiche della bozza separate dalla versione che i visitatori possono vedere, così salvare e pubblicare sono due azioni distinte.

Aprire una collection

Apri /_emdash/admin sul tuo sito e accedi. Seleziona una collection, come Posts o Pages, nella barra laterale.

La pagina della collection elenca le sue voci. Da qui puoi:

• selezionare Add New per creare una voce;
• cercare per titolo della voce, slug e campi contrassegnati come searchable;
• filtrare per stato di pubblicazione, autore, byline, data e locale;
• selezionare voci per pubblicazione in blocco, ritorno in bozza o spostamento nel Cestino; e
• aprire Trash per ripristinare o eliminare definitivamente una voce.

I campi e le funzioni di pubblicazione disponibili nell’editor dipendono dal modello di contenuto della collection. Ad esempio, una collection può supportare revisioni, anteprime, tassonomie o ricerca.

Creare e pubblicare una voce

La voce ha un ID di contenuto stabile e uno slug separato. L’ID continua a identificare la stessa voce se il suo slug cambia. I template usano di solito l’identificatore orientato all’URL restituito da getEmDashCollection(); la guida Interrogare il contenuto spiega entrambi i valori.

Scrivere testo formattato

I campi Portable Text forniscono un editor a blocchi per titoli, paragrafi, citazioni, elenchi, link, immagini, gallerie, blocchi di codice, tabelle, blocchi HTML e sezioni riutilizzabili. I plugin installati possono aggiungere altri blocchi.

Usa la barra degli strumenti per formattare il testo selezionato. Per inserire un blocco, seleziona il controllo aggiungi-blocco accanto a un paragrafo oppure digita / e cerca un blocco per nome. I blocchi immagine e galleria aprono lo stesso selettore di media usato dai campi immagine.

Quando selezioni un blocco immagine, le sue impostazioni ti consentono di sostituire o rimuovere quell’uso dell’immagine e impostare la dimensione di visualizzazione, l’allineamento, il testo alt, la didascalia e un tooltip opzionale. Edit asset apre l’elemento sottostante della libreria media, dove modificare o sostituire l’asset può interessare altre voci che lo usano. Vedi Libreria media per quella distinzione.

Salvare le modifiche della bozza

Dopo il primo salvataggio, l’editor salva automaticamente le modifiche due secondi dopo che smetti di digitare. Il pulsante Save passa da Saving… a Saved così puoi confermare che il server ha accettato la bozza. Il salvataggio automatico sostituisce la revisione di salvataggio automatico attuale invece di riempire la cronologia delle revisioni con un checkpoint per ogni pausa.

Seleziona Save quando vuoi che un punto della sequenza di modifica resti nella cronologia delle revisioni. Se un salvataggio fallisce, l’editor mantiene i campi non salvati e mostra l’errore. Non lasciare la pagina finché il pulsante non torna a Saved o non hai copiato il lavoro non salvato altrove.

Per una voce pubblicata, salvare le modifiche aggiorna solo la sua bozza. I visitatori continuano a ricevere la revisione live precedente. Usa Preview draft per controllare la versione in sospeso, Live View per controllare la versione pubblica e Publish changes quando la bozza è pronta a sostituirla.

Cambiare lo slug di una voce pubblicata segue lo stesso flusso di bozza. L’URL pubblico cambia quando pubblichi la bozza, non quando viene eseguito il salvataggio automatico.

Lavorare con un altro editor

Aprire una voce prende un blocco di modifica per quella voce e locale. Se un’altra persona ce l’ha già aperta, EmDash identifica il titolare del blocco e offre due scelte:

• Open read-only mostra la voce senza accettare modifiche, così non puoi digitare lavoro che sarà scartato.
• Take over ti dà il blocco. L’altra persona conserva ciò che ha digitato, ma entro due minuti il suo editor segnala che tu detieni la voce. Il suo prossimo salvataggio viene rifiutato.

Il blocco viene rinnovato mentre la voce è aperta e rilasciato quando lasci l’editor o chiudi la scheda. Se il browser o il computer si chiudono senza rilasciarlo, il blocco scade sette minuti dopo il suo ultimo rinnovo.

I blocchi sono indipendenti per ogni locale, così due persone possono modificare traduzioni diverse della stessa voce. Uno script o un client API viene anche rifiutato mentre un altro editor detiene il blocco, a meno che non usi l’ override documentato. Vedi Blocco di modifica voce per il comportamento API completo.

Un amministratore può disattivare il blocco per una collection sotto Content Types, poi la collection, poi Edit locking.

Pubblicare o programmare le modifiche

Pubblicazione e programmazione usano controlli separati:

• Publish now rende live una nuova bozza dopo la conferma.
• Publish changes rende live le modifiche in sospeso di una voce pubblicata dopo la conferma.
• Schedule imposta quando una nuova voce o le modifiche in sospeso diventano live.
• Change schedule aggiorna una programmazione esistente.
• Remove schedule annulla una programmazione esistente.
• Unpublish rimuove la revisione live dalle query pubbliche, annulla qualsiasi programmazione e conserva una bozza modificabile.

Per programmare una voce, salvala prima, seleziona Schedule sotto il riepilogo di pubblicazione e scegli una data e ora future. L’editor mostra il fuso orario usato per la programmazione. Fino a quel momento, la revisione live attuale resta pubblica; per una nuova voce, nulla è ancora pubblico.

I deployment Node.js eseguono automaticamente lo sweep di pubblicazione programmata. Cloudflare Workers richiedono un Cron Trigger. I template starter Cloudflare lo includono; i deployment esistenti possono seguire Pubblicazione programmata per verificare il trigger.

Ripristinare una revisione

Le collection con supporto alle revisioni mostrano Revisions nel pannello delle impostazioni. Espandilo per vedere le versioni salvate e i campi che sono cambiati tra loro. Seleziona una revisione per ispezionarne il contenuto, poi seleziona Restore se vuoi usare di nuovo quella versione.

Il ripristino crea una nuova revisione con il contenuto selezionato. Non cancella le revisioni precedenti, così puoi ancora ispezionare la sequenza completa in seguito.

Tradurre una voce

Quando l’internazionalizzazione è abilitata, il pannello Translations mostra le locale configurate per la voce attuale.

Ogni traduzione ha il proprio slug, stato di pubblicazione, programmazione e cronologia delle revisioni. Usa il selettore di locale nella pagina della collection per visualizzare una lingua alla volta.

Spostare i contenuti nel Cestino

Apri le azioni di una voce o seleziona una o più righe nella pagina della collection, poi scegli Move to Trash. Le voci nel Cestino smettono di apparire nelle query di contenuto ordinarie ma restano disponibili nella scheda Trash della collection.

Da Trash, seleziona Restore per riportare una voce alla collection. Una voce ripristinata torna come bozza senza programmazione. Pubblicala per renderla pubblica.

Automatizzare il lavoro sui contenuti

L’API REST e la CLI EmDash supportano lo stesso flusso di bozza e pubblicazione. I campi della collection appartengono all’oggetto data della richiesta. Un aggiornamento salva una revisione di bozza; la pubblicazione è un’azione separata. Passa il valore _rev più recente quando aggiorni o pubblichi così il server rifiuta una scrittura obsoleta invece di sostituire lavoro più recente.

Usa il riferimento al ciclo di vita del contenuto per le transizioni di stato, i permessi, i conflitti e gli hook. Il riferimento all’API REST definisce i corpi di richiesta e risposta, e il riferimento alla CLI copre i comandi di terminale equivalenti.

Continua con Interrogare il contenuto per renderizzare le voci pubblicate in un sito Astro, o Libreria media per aggiungere e gestire file riutilizzabili.