Документация / Каналы

Hashnode

Подключите публикацию Hashnode по персональному токену и публикуйте посты как статьи в Markdown с обложкой, тегами и каноническим адресом.

English version · API для разработчиков

Содержание

Hashnode — блоговая платформа. Здесь пост превращается в статью: первая строка текста — заголовок, остальное — тело статьи в Markdown. Канал — это одна публикация (блог) Hashnode. Общие вещи о каналах описаны в разделе Каналы: обзор.

Что можно публиковать

  • Текст и ссылка — статья из подписи. Для ссылки адрес добавляется в конец статьи после пустой строки.
  • Изображение — одно, оно становится обложкой статьи. Берётся первое изображение поста.

Видео не поддерживается. Лимит длины текста сервис не задаёт.

Как подпись превращается в статью:

  1. Первая непустая строка — заголовок. Если она начинается с # и пробела, эти знаки отбрасываются.
  2. Всё, что ниже, — тело статьи в Markdown.
  3. Если в подписи одна строка, она же становится и телом статьи.

Заголовок не может быть пустым.

Перед началом

Вам нужны аккаунт Hashnode хотя бы с одной публикацией и персональный токен доступа. Создайте его в Hashnode: откройте Account settings, затем Developer и сгенерируйте новый токен.

Токен хранится вместе с каналом и отправляется только в Hashnode.

Подключение

  1. Откройте Каналы и нажмите Добавить каналы.
  2. В карточке Hashnode нажмите Hashnode.
  3. На странице Подключить публикацию Hashnode вставьте токен в поле Персональный токен доступа и нажмите Продолжить. Сервис проверяет токен и получает список ваших публикаций.
  4. В блоке Выберите публикацию для постинга выберите публикацию (рядом с названием показан её адрес) и нажмите Подключить.
  5. На странице Добавьте новые каналы отметьте публикацию и нажмите Добавить новый.

Канал появится в списке под названием публикации. Чтобы подключить ещё одну публикацию, повторите шаги.

Настройки в редакторе поста

Когда в редакторе выбран канал Hashnode, под полем текста появляется блок Hashnode с подсказкой о заголовке и обложке и двумя настройками:

  • Теги (через запятую) — теги статьи через запятую. Знак # в начале и повторы убираются.
  • Канонический URL — адрес оригинала, если статья уже опубликована в другом месте. Принимается только корректный адрес; иначе поле игнорируется.

Если что-то не работает

  • Введите ваш персональный токен доступа. — поле токена пустое.
  • Токен не принят. — Hashnode не принял токен. Создайте новый и повторите.
  • В этом аккаунте Hashnode нет публикации для постинга. — у аккаунта нет ни одной публикации. Создайте её в Hashnode и подключитесь снова.
  • Выберите публикацию. — публикация не выбрана.
  • Hashnode: первая строка текста — заголовок статьи, а она пуста. — напишите заголовок первой строкой.
  • У аккаунта Hashnode нет действующего токена. Переподключите его. — доступ потерян, например токен отозван. Нажмите Переподключить на карточке канала и введите новый токен.
  • Hashnode вернул ответ, который не удалось прочитать. — ответ не удалось разобрать; проверьте публикацию, прежде чем публиковать повторно.

Подробнее о переподключении и статусах каналов — в разделе Каналы: обзор.