Что такое Telegra.PH|Как использовать телеграф
Посты в Telegra.PH привязываются к куки (Cokie) — чтобы отредактировать пост вам нужно зайти с того – же устройства с которого он был опубликован! у телеграфа нету поиска или главной страницы, поэтому чтобы не потерять посты: Надо привязать аккаунт Telegram к аккаунту Telegraph
Переходим в официального бота (@telegraph) и нажимаем запустить бот автоматически найдет ваш аккаунт в Telegraph после этого вам станет доступна авторизация в Telegraph через мессенджер Telegram: также вы не потеряете свои посты и в любое время сможете их редактировать в отличие от того: если бы вы не связали аккаунт
Как создавать медийные посты в Telegra.ph
Telegra.ph дает возможность публиковать тексты, фотографии, видео. Если разместить ссылку на пост в Telegraph в чат или собственный канал, то подписчики смогут посмотреть статью с функцией быстрого просмотра Instant View . То есть, при нажатии на ссылку, происходит мгновенный переход на статью.
В частности, в Telegraph вы можете создать :
1-2) курсив, жирный
4-5) два типа заголовков (первого и второго уровней)
7) вставка фотографии (с возможностью добавить подпись)
8) вставка видео с YouTube и Vimeo
Про цитирование нужно заметить, что оно бывает двух видов
Якоря
С помощью якорей можно сделать оглавление, можно отправить читателя сразу к интересующему его месту вашего текста.
Якорь — это заголовок, который не должен повторяться далее, не может быть одинаковым с другим заголовком. Ссылка на якорь начинается с тега # и без пробелов. Если в заголовке несколько слов, они пишутся через тире (пример #Глава-номер-пять) ссылка #_tl_editor она просто перебрасывает в начало всего документа.
Работа с картинками
Картинки можно вставить с помощью маленького фотоаппаратика, что появляется слева в каждой новой строке абзаца, либо просто перетянуть сюда и сохранить.
Можно перетащить картинку из интернета, например с яндекса. Иногда бывает, при попытки сохранить публикацию сразу после вставки картинки, выскакивает надпись «Upload in progress. Please wait. » Тут нужно просто подождать, пока картинка прогрузится в телеграф.
Картинку можно подписывать:
Вы видите надпись под картинкой Caption (optional)? Здесь можно подписывать картинку.
Видео
В телеграф можно загружать как видео так и гиф. Размер не должен превышать 5 Мб. Делается также через маленький фотоаппаратик (жмем <>), появится
Страничность
- Для начала сохраняем первую статью. Потом создаем вторую. Тоже сохраняем.
- Копируем ссылку 2-й статьи и идем в первую и редактируем.
- Внизу документа, пишем сообщение формата «Следующая глава», или «Читать дальше».
- Сохраняем, копируем ссылку первого документа, идем во второй и повторяем пункт два.
Пример: ЧИТАТЬ ДАЛЬШЕ —>
Так можно вернуться в начало статьи. Помните же про тег#_tl_editor , пример его применения: Наверх (вставляем код)
Вот так выглядит пост в Telegraph на моем канале Деньги в Telegram
Telegraph API: автоматизированное создание заметок
Сервису telegra.ph уже много лет, но информации о том как пользоваться его api почему-то не много, тем временем, крупные телеграм-каналы потихоньку приступили к промышленному освоению. Инструмент вполне себе неплохая альтернатива созданию веб-страниц, к тому же появилась удобная библиотека, которая позволяет автоматизировать процесс.
С чего всё началось:
Случайно обратил внимание на кнопку «Посмотреть», которая появилась на некоторых телеграмм-каналах («Раньше всех, ну почти», и «RT на русском»)
Если нажать кнопку, то открывается статья судя-по всему на telegra.ph, что интересно, в самом посте ссылка на сайт, и на компьютере она туда и ведет, а вот в мобильной версии, есть такой вот просмотр. Пока не разбирался с деталями именно такой реализации, но сделать автопостинг в телеграф сразу захотелось, об этом, собственно дальше и будет разговор.
Array of Node или главная загвоздка Telegraph API и её разрешение
В целом, ничего сложного в Telegraph API нет, основная проблема была в том, что передавать содержание страницы нужно в виде Array of Node, up to 64 KB. Т.е. просто написать «Hello world» не получится (нужно писать [«Hello world»]), а передать какую-то разметку, так совсем не просто, например «Hello world»:
Однако решение есть, это библиотека Telegraph, впрочем, постараюсь рассказать как работать и без неё. Приступаем.
Создание аккаунта и получение токена
Все работает через запросы к https://api.telegra.ph/ после чего указывается метод и, если надо, путь. Делать это можно как угодно: curl из командной строки, или requests.get() в питоне, или где хотите ещё. Я приведу пример работы в python.
Чтобы создать новый аккаунт нужно выполнить просто запрос к https://api.telegra.ph/ с указанием метода createAccount:
Из bash будет так:
С библиотекой telegraph: нужно её установить (pip install telegraph), а дальше всё просто:
В ответ приходит json с токеном и прочим. Токен надо сохранять, я сохраню полученные данные в файл graph_bot.json
Что интересно, метода удаления профайла и страниц не обнаружил. Имена аккаунтов не уникальные, можно насоздавать сколько угодно профилей с одинаковым именем, разница будет только в токенах.
Создание страницы (createPage)
Получаем токен из сохраненного json и передаём запрос на создание страницы:
Если всё пройдет хорошо, в ответ придет примерно такой результат:
Если в отправляемых данных есть ошибка, возвращается сообщение о ней:
Как уже сказал выше, главная проблема тут, это правильный формат передаваемого текста, рабочий парсер html to node реализован в библиотеке telegraph. Тут всё просто, можно сохранить весь HTML в строковую переменную и спокойно её передать в виде соответствующего поля:
В библиотеке довольно внушительный список запрещенных тэгов, но для минимальной верстки telegra.ph хватает
Изменение страницы (editPage)
Чтобы изменить страницу надо знать её адрес, он идет после ph/ для страницы https://telegra.ph/Hey-11-04-22 параметр path будет «Hey-11-04-22». И конечно, токен доступа. Отправляем запрос с указанием метода и параметрами к https://api.telegra.ph/editPage
Опять же тут проблема в формате данных, которые должны быть Array of Node. Воспользуемся готовым решением:
В случае ошибки приходит сообщение <'ok': False, 'error': 'описание ошибки'>. Если всё хорошо, статус ‘ok’ будет True.
Что ещё можно:
В целом, для создания и редактирования страниц достаточно, думаю принцип работы понятен. Также можно: