DEV.to to jedyna platforma blogowa, z którą łączy się Ocoya. Post DEV.to nie jest social caption — to Markdown article with a title, więc zachowuje się inaczej niż każdy inny kanał.
Zanim zaczniesz
Potrzebujesz konta na DEV.to i klucza API z tego konta. DEV.to nie ma logowania przez aplikacje, więc Ocoya łączy się za pomocą klucza, który samodzielnie generujesz, zamiast przekierowywać cię do DEV.to po zatwierdzenie dostępu.
Połącz DEV.to
Wygeneruj klucz API na DEV.to
Na DEV.to wejdź w Settings → Extensions i wygeneruj klucz API. To jest na dev.to/settings/extensions.
Otwórz Channels w Ocoya
Wybierz Channels, potem Connect channel i wybierz DEV.to — znajdziesz je w sekcji Blogging.
Wklej klucz
Wklej go w pole DEV.to API key i zatwierdź. Ocoya odczyta twój profil DEV.to, żeby nazwać połączenie.
Ponieważ połączenie opiera się na kluczu, a nie na zatwierdzeniu, odwołujesz je na DEV.to: usuń klucz w Settings → Extensions i Ocoya nie będzie już mogła połączyć się z kontem.
Co możesz publikować
Artykuł napisany w Markdown:
- A title — wymagany i najważniejszy element
- A body w Markdown, z formatowaniem wspieranym przez DEV.to
- Images, osadzone w treści jako Markdown
No video. Jeśli dołączysz wideo, artykuł zostanie odrzucony.
Artykuły DEV.to publikują się live — Ocoya publikuje je jako opublikowane, nie jako szkice na DEV.to.
Tytuł
Każdy artykuł DEV.to potrzebuje tytułu, maksymalnie 128 znaków.
Jeśli go nie ustawisz, Ocoya weźmie first line of your caption i użyje jej, usuwając znaczniki nagłówka Markdown, więc linia zaczynająca się od ## Introduction stanie się Introduction zamiast wyświetlać kratki. Gdy nie ma z czego skorzystać, tytuł domyślny to Untitled article — czego raczej nie chcesz publikować, więc ustaw tytuł albo zacznij od mocnej pierwszej linii.
Limity DEV.to
| Title | 128 characters |
| Body | 100,000 characters |
| Images | 10 |
| Video | Not supported |
| Tags | Not supported from Ocoya |
Limit treści to zabezpieczenie po stronie Ocoya. Własny limit DEV.to to 800 KB Markdownu, co znacznie przekracza wszystko, co normalnie wpiszesz w edytorze — niższa wartość po prostu sprawia, że błąd zobaczysz w edytorze, a nie dopiero przy publikacji.
Pisanie pod DEV.to, a nie pod social
Ta sama caption rzadko sprawdza się jednocześnie jako tweet i artykuł. Wynikają z tego dwie rzeczy:
- Używaj per-channel captions, gdy post idzie jednocześnie na DEV.to i do sieci społecznościowych. Napisz artykuł pod DEV.to i krótszą wersję pod resztę.
- Markdown jest renderowany, więc działają nagłówki, listy, bloki kodu i linki — a caption napisana pod social będzie wyglądała bardzo skromnie jako artykuł.
Jeśli regularnie publikujesz na DEV.to, zwykle będzie to osobny post, a nie ten sam, który udostępniasz na inne kanały.
Częste problemy
“That DEV.to API key was rejected. Generate a new key and try again.” Klucz jest nieprawidłowy, został unieważniony albo skopiowany z białymi znakami. Wygeneruj nowy w Settings → Extensions i połącz kanał ponownie.
“DEV.to articles require text.” Artykuł nie ma treści. Sama grafika lub inne media to nie artykuł.
“DEV.to articles cannot exceed 800 KB.” Markdown przekroczył limit DEV.to — podziel go na więcej niż jeden artykuł.
“DEV.to is rate limiting this account. Space the scheduled articles further apart and try again.” DEV.to ogranicza, jak szybko jedno konto może publikować. Rozsiej zaplanowane artykuły w czasie zamiast kolejkować kilka na tę samą godzinę.
“Connection to your profile has expired. Please reconnect.” Połącz się ponownie z użyciem aktualnego klucza. Zobacz Reconnect a channel.