DEV.to to jedyna platforma blogowa, z którą łączy się Ocoya. Post na DEV.to to nie opis do social mediów — to artykuł w Markdownie z tytułem, więc zachowuje się inaczej niż w każdym innym kanale.
Zanim zaczniesz
Potrzebujesz konta na DEV.to i klucza API z tego konta. DEV.to nie ma logowania dla aplikacji, więc Ocoya łączy się za pomocą klucza, który sam generujesz, a nie przez przekierowanie na DEV.to w celu zatwierdzenia dostępu.
Połącz DEV.to
Wygeneruj klucz API na DEV.to
Na DEV.to przejdź do Settings → Extensions i wygeneruj klucz API. Znajdziesz to pod adresem dev.to/settings/extensions.
Otwórz Channels w Ocoya
Wybierz Channels, potem Connect channel i wybierz DEV.to — jest na liście w sekcji Blogging.
Wklej klucz
Wstaw go w polu DEV.to API key i potwierdź. Ocoya odczytuje Twój profil DEV.to, żeby nazwać połączenie.
Ponieważ połączenie opiera się na kluczu, a nie na zatwierdzeniu, cofa się je na DEV.to: usuń klucz w Settings → Extensions, a Ocoya nie będzie już miała dostępu do konta.
Co możesz opublikować
Artykuł napisany w Markdownie:
- Tytuł — wymagany i to on jest najważniejszy
- Treść w Markdownie, z formatowaniem obsługiwanym przez DEV.to
- Obrazy, wstawione w treści jako Markdown
Bez wideo. Dodaj je, a artykuł zostanie odrzucony.
Artykuły na DEV.to publikują się na żywo — Ocoya publikuje je jako opublikowane, a nie jako wersje robocze na DEV.to.
Tytuł
Każdy artykuł na DEV.to potrzebuje tytułu, ograniczonego do 128 znaków.
Jeśli go nie ustawisz, Ocoya weźmie pierwszy wiersz Twojego opisu i użyje go jako tytułu, usuwając znaki nagłówka Markdown, tak że wiersz zaczynający się od ## Introduction stanie się Introduction, a nie zostanie wydrukowany z krzyżykami. Gdy nie ma z czego wziąć tytułu, używa Untitled article — czego nie chcesz publikować, więc ustaw tytuł albo zacznij od mocnego pierwszego wiersza.
Limity DEV.to
| Tytuł | 128 znaków |
| Treść | 100 000 znaków |
| Obrazy | 10 |
| Wideo | Nieobsługiwane |
| Tagi | Nieobsługiwane z poziomu Ocoya |
Limit treści to zabezpieczenie Ocoya. Własny limit DEV.to to 800 KB Markdownu, co z dużym zapasem przekracza wszystko, co da się wpisać w kreatorze — niższa liczba sprawia po prostu, że błąd pojawia się w edytorze, a nie przy publikacji.
Pisanie pod DEV.to, a nie pod social media
Ten sam opis rzadko sprawdza się i jako tweet, i jako artykuł. Wynikają z tego dwie rzeczy:
- Używaj opisów dla poszczególnych kanałów, gdy post idzie jednocześnie na DEV.to i do sieci społecznościowych. Napisz artykuł dla DEV.to i krótką wersję dla reszty.
- Markdown jest renderowany, więc nagłówki, listy, bloki kodu i linki działają — a opis napisany pod social media będzie wyglądał jako artykuł skąpo.
Jeśli publikujesz na DEV.to regularnie, zwykle lepiej zrobić z tego osobny post niż współdzielić go z kanałami społecznościowymi.
Typowe problemy
“That DEV.to API key was rejected. Generate a new key and try again.” Klucz jest błędny, został cofnięty albo skopiowano go ze spacją. Wygeneruj nowy w Settings → Extensions i połącz ponownie.
“DEV.to articles require text.” Artykuł nie ma treści. Same media to nie artykuł.
“DEV.to articles cannot exceed 800 KB.” Markdown przekracza własny 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ć. Rozłóż zaplanowane artykuły w czasie, zamiast kolejkować kilka naraz.
“Connection to your profile has expired. Please reconnect.” Połącz ponownie, używając aktualnego klucza. Zobacz Połącz kanał ponownie.