DEV.to è l’unica piattaforma di blogging a cui Ocoya si collega. Un post su DEV.to non è una didascalia social: è un articolo in Markdown con un titolo, quindi si comporta in modo diverso da ogni altro canale.
Prima di iniziare
Ti servono un account DEV.to e una chiave API 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 mandarti su DEV.to per approvare l’accesso.
Collega DEV.to
Genera una chiave API su DEV.to
Su DEV.to vai in Settings → Extensions e genera una chiave API. La trovi su dev.to/settings/extensions.
Apri Channels in Ocoya
Seleziona Channels, poi Connect channel, e scegli DEV.to: è elencato sotto Blogging.
Incolla la chiave
Inseriscila nel campo DEV.to API key e conferma. Ocoya legge il tuo profilo DEV.to per dare un nome alla connessione.
Poiché la connessione è una chiave e non un’approvazione, per revocarla si agisce su DEV.to: elimina la chiave in Settings → Extensions e Ocoya non potrà più raggiungere l’account.
Cosa puoi pubblicare
Un articolo, scritto in Markdown:
- Un titolo: obbligatorio, ed è la cosa da curare di più
- Un corpo in Markdown, con la formattazione supportata da DEV.to
- Immagini, incluse nel corpo come Markdown
Nessun video. Se ne alleghi uno, l’articolo viene rifiutato.
Gli articoli su DEV.to vengono pubblicati subito: Ocoya li pubblica come pubblicati, non come bozze su DEV.to.
Il titolo
Ogni articolo su DEV.to ha bisogno di un titolo, con un massimo di 128 caratteri.
Se non ne imposti uno, Ocoya prende la prima riga della tua didascalia e la usa come titolo, eliminando i simboli di intestazione Markdown, così una riga che inizia con ## Introduction diventa Introduction invece di mostrare i cancelletti. Se non ha niente da cui partire, ripiega su Untitled article, che non vuoi pubblicare: imposta un titolo o apri con una prima riga forte.
I limiti di DEV.to
| Titolo | 128 caratteri |
| Corpo | 100.000 caratteri |
| Immagini | 10 |
| Video | Non supportato |
| Tag | Non supportati da Ocoya |
Il limite del corpo è una protezione di Ocoya. Il limite di DEV.to è di 800 KB di Markdown, molto oltre ciò che si digita in un compositore: il numero più basso serve solo a farti fallire nell’editor invece che al momento della pubblicazione.
Scrivere per DEV.to, non per i social
La stessa didascalia raramente funziona sia come tweet sia come articolo. Ne derivano due cose:
- Usa le didascalie per canale quando un post va su DEV.to e sui social insieme. Scrivi l’articolo per DEV.to e una versione breve per tutto il resto.
- Il Markdown viene renderizzato, quindi titoli, elenchi, blocchi di codice e link funzionano tutti, e una didascalia scritta per i social sembrerà scarna come articolo.
Se pubblichi su DEV.to con regolarità, di solito è meglio un post separato invece di uno condiviso con i tuoi canali social.
Problemi comuni
“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. Generane una nuova in Settings → Extensions e ricollega.
“DEV.to articles require text.” L’articolo non ha un corpo. I soli contenuti multimediali non sono 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. Distanzia gli articoli pianificati invece di metterne in coda diversi nello stesso momento.
“Connection to your profile has expired. Please reconnect.” Ricollega con una chiave valida. Vedi Ricollega un canale.