Pubblicare su Sanity

Collega il tuo progetto Sanity una sola volta e GrowWriter crea un documento per ogni articolo che pubblichi, modellato sul tuo schema. Ti servono circa dieci minuti e un token per il progetto.

Cosa ti serve

• L'ID progetto di Sanity e il Dataset da cui legge il tuo sito, di solito production. Entrambi sono nella pagina del progetto su manage.sanity.io.
• Un token API con permessi Editor, creato sotto API, poi Tokens, nella stessa pagina.
• Un tipo di documento per i post nel tuo schema, con almeno un documento esistente. GrowWriter ne legge un campione per imparare i campi.

Se Sanity per il tuo sito lo ha configurato qualcun altro, mandagli questa sezione e chiedi i tre valori. Il token è l'unico segreto.

Crea il token

1. Apri il tuo progetto su manage.sanity.io.
2. Vai su API, poi Tokens, e aggiungi un token chiamato GrowWriter.
3. Scegli i permessi Editor. I token in sola lettura non possono pubblicare.
4. Copia il token. Sanity lo mostra una sola volta.

Connetti in GrowWriter

Apri la pagina Canali, cerca Sanity sotto Siti web & CMS e fai clic su Connetti.

1. ID progetto e Dataset: dalla pagina del progetto.
2. Token API (accesso in scrittura): il token che hai appena creato.
3. Fai clic su Testa connessione. Connessione riuscita significa che GrowWriter può leggere e scrivere il dataset.

Due impostazioni facoltative stanno sotto Opzioni avanzate:

• URL dello Studio (facoltativo): l'indirizzo del tuo Studio, come https://myproject.sanity.studio. Con questo, il link Vedi articolo dopo la pubblicazione apre il documento nel tuo Studio.
• Lingue: i codici lingua usati dal tuo schema, separati da virgola, come en, es. Lascia en se il tuo schema non ha lingue.

Scegli il tipo di documento

Il passaggio 2 elenca i tipi di documento nel tuo dataset. Scegli quello che il tuo sito usa per i post, spesso post o article, e fai clic su Continua.

Se l'elenco dice Nessun contenuto da cui imparare, il tuo dataset non ha ancora documenti di quel tipo. Il tuo sviluppatore può eseguire npx sanity schema extract --enforce-required-fields nel progetto Studio e darti il file; incollalo in Schema JSON e GrowWriter legge la struttura da lì. L'opzione contrassegna i campi che il tuo schema richiede, così il passaggio di mappatura può avvisarti quando uno di essi resterebbe vuoto. Incollare lo schema conviene anche quando l'elenco funziona, per lo stesso motivo.

Mappa i campi

Il passaggio 3 abbina ogni campo GrowWriter a un campo del tuo tipo di documento: titolo, slug, contenuto, meta descrizione, immagine di copertina, data di pubblicazione, data di modifica, autore e lingua. GrowWriter abbina quello che può in base al nome e ti dice quanti ne ha trovati; imposta gli altri dai menu a tendina oppure scegli Salta.

Per il contenuto, scegli il formato che il tuo schema si aspetta sotto Formato del contenuto: Portable Text per il testo ricco di Sanity, oppure Markdown e HTML per campi stringa semplici. Se il tuo schema ha un riferimento all'autore, mappalo e sceglierai l'autore ogni volta che pubblichi.

Se il tuo schema ha un campo lingua, mappalo. Molti Studio e siti filtrano i post per lingua, e Sanity accetta documenti senza di essa, quindi un articolo pubblicato senza lingua può sembrare scomparso anche se esiste. GrowWriter scrive la lingua di ogni articolo e adatta il codice ai valori che il tuo schema ammette, per esempio es diventa es-ES quando è quello che il campo elenca.

Sotto i campi mappati, Aggiungi valore fisso scrive lo stesso valore in un campo dello schema a ogni pubblicazione. Usalo per i campi obbligatori per cui GrowWriter non ha dati, come una categoria o un contrassegno di sezione. Quando lo schema incollato contrassegna i campi obbligatori, il passaggio ti avvisa di quelli che nulla compila; puoi comunque salvare, ma quei documenti potrebbero richiedere una modifica manuale nello Studio.

Fai clic su Salva connessione. La riga nella pagina Canali mostra Connesso.

Pubblica il tuo primo articolo

Apri la tua Libreria, scegli un articolo finito e fai clic su Pubblica. Spunta Sanity, scegli un autore se la tua mappatura ne ha uno, e fai clic su Pubblica. GrowWriter crea il documento, carica l'immagine di copertina nel tuo dataset e compila ogni campo mappato.

Pubblicare di nuovo più tardi aggiorna lo stesso documento al suo posto e mantiene i campi non mappati che il tuo team ha modificato nello Studio. Il flusso completo, con le schermate, è su Scegli dove pubblicare.

Risoluzione dei problemi

• Sanity ha rifiutato le credenziali: il token è scaduto, è stato eliminato o ha permessi di sola lettura. Crea un nuovo token Editor, Disconnetti e collega di nuovo.
• Sanity ha rifiutato l'aggiornamento: un campo mappato non accetta il valore, il più delle volte un campo solo data che riceve un timestamp completo. Ricollega e correggi la mappatura.
• L'articolo è stato pubblicato ma non compare nello Studio né sul sito: un campo obbligatorio o di filtro è vuoto nel documento, di solito la lingua. Sanity accetta documenti che saltano la validazione dello Studio, quindi la pubblicazione riesce e il documento esiste; le liste dello Studio e le query del sito semplicemente non lo selezionano mai. Apri il documento con Vedi post, compila il campo, poi mappalo (o aggiungi un valore fisso) nella connessione così la prossima pubblicazione lo compila in automatico.
• Il documento precedente è stato eliminato in remoto, quindi ne è stato creato uno nuovo: solo informativo. Qualcuno ha rimosso il documento nello Studio; GrowWriter ne ha creato uno nuovo.
• Pubblicato con avvisi: l'articolo è online, ma è successo qualcosa di non bloccante, come un'immagine saltata o un valore di lingua che il tuo schema non elenca. La nota sotto la riga dice cosa controllare.
• L'autore selezionato non esiste più nel CMS: scegli un altro autore nella finestra di pubblicazione.