DEV.to è l’unica piattaforma di blogging a cui Ocoya si collega. Un post DEV.to non è una didascalia social: è un Markdown article with a title, quindi si comporta in modo diverso da tutti gli altri canali.
Before you start
Ti serve un account DEV.to e una API key generata da lì. DEV.to non ha un flusso di accesso per le app, quindi Ocoya si collega con una chiave che generi tu, invece di rimandarti su DEV.to per approvare l’accesso.
Connect DEV.to
Generate an API key on DEV.to
Su DEV.to, vai in Settings → Extensions e genera una API key. La trovi su dev.to/settings/extensions.
Open Channels in Ocoya
Seleziona Channels, poi Connect channel, e scegli DEV.to — è elencato sotto Blogging.
Paste the key
Incollala nel campo DEV.to API key e conferma. Ocoya legge il tuo profilo DEV.to per dare un nome alla connessione.
Dato che la connessione usa una chiave invece di un’approvazione, la revoca si fa su DEV.to: elimina la chiave in Settings → Extensions e Ocoya non potrà più raggiungere l’account.
What you can post
Un articolo, scritto in Markdown:
- A title — obbligatorio, ed è la cosa da azzeccare
- A body in Markdown, con la formattazione supportata da DEV.to
- Images, inserite nel body come Markdown
No video. Se ne alleghi uno, l’articolo viene rifiutato.
Gli articoli DEV.to vengono pubblicati live — Ocoya li pubblica come pubblicati, non come bozze su DEV.to.
The title
Ogni articolo DEV.to ha bisogno di un titolo, con un limite di 128 caratteri.
Se non ne imposti uno, Ocoya prende la prima riga della tua caption e la usa come titolo, rimuovendo eventuali segni di heading Markdown, così una riga che inizia con ## Introduction diventa Introduction invece di mostrare i cancelleti. Se non ha nulla da cui partire, usa Untitled article — cosa che non vuoi pubblicare, quindi imposta un titolo o inizia con una prima riga forte.
DEV.to’s limits
| Title | 128 characters |
| Body | 100,000 characters |
| Images | 10 |
| Video | Not supported |
| Tags | Not supported from Ocoya |
Il limite per il body è una protezione di Ocoya. Il limite di DEV.to è 800 KB di Markdown, ben oltre qualsiasi cosa digitata in un composer: il numero più basso significa solo che il controllo fallisce nell’editor invece che al momento della pubblicazione.
Writing for it, not for social
La stessa caption raramente funziona sia come tweet sia come articolo. Ne derivano due cose:
- Usa le per-channel captions quando un post va su DEV.to e sui social network insieme. Scrivi l’articolo per DEV.to e una versione breve per tutto il resto.
- Il Markdown viene renderizzato, quindi heading, liste, blocchi di codice e link funzionano tutti — e una caption pensata per i social sembrerà povera come articolo.
Se pubblichi regolarmente su DEV.to, di solito è un post separato invece che uno condiviso con i tuoi canali.
Common problems
“That DEV.to API key was rejected. Generate a new key and try again.” La chiave è sbagliata, è stata revocata o è stata copiata con degli spazi bianchi. Generane una nuova in Settings → Extensions e ricollega.
“DEV.to articles require text.” L’articolo non ha body. Solo i media non bastano per un articolo.
“DEV.to articles cannot exceed 800 KB.” Il Markdown supera il limite di DEV.to — dividilo in più articoli.
“DEV.to is rate limiting this account. Space the scheduled articles further apart and try again.” DEV.to limita la velocità con cui un account può pubblicare. Distribuisci meglio gli articoli programmati invece di metterne diversi alla stessa ora.
“Connection to your profile has expired. Please reconnect.” Ricollega con una chiave aggiornata. Vedi Reconnect a channel.