Old-Slavonic-bot

Бот-переводчик на старославянский язык. Ссылка на бота: @TransToOldSlavonic_bot.

Содержание

• Описание
• Применение
  • Перевод и странслитерация
  • Значение слова
• Файлы и папки
• References
  • Функции перевода и транслитерации, их работа
  • Работа бота
  • Heroku
  • Bot API
    • Telethon API
    • Telegram Bot API
  • Другое
  • Некоторая общая документация
• See also

Описание

Бот @TransToOldSlavonic_bot в Telegram.

Переводчик на cтарославянский язык. Доступные функции: перевод, транслитерация на алфавиты письма старославянской кириллицы и глаголицы. Подробнее: см. /help в боте @TransToOldSlavonic_bot.

Лицензия: MIT License.

Статья в Telegraph: https://telegra.ph/Perevodchik-na-staroslavyanskij-02-28.

---

В версии 1.0.0 некоторые файлы отдельно вынесены в папку контроля версий с удалением этих файлов в корне.

Начиная с момента появления нумерованных версий (1.0.0+, commit 16 в GitHub) есть три версии, записываемые в папке meta/versions-controll/: в библиотеках telebot, aiogram, telethon. Файлы/данные, записанные или подтвержденные до этого момента, приоритетно считать не столь авторитетными, как те, которые записаны или подтверджены во время, начиная с него.

Причина создания нескольких версий:

• в telethon есть возможность удобно делать некоторые вещи (например писать код: await event.reply(...) вместо bot.send_message(message.id, ..., reply_to_message_id=message.message_id), не говоря о возможности поиска пользователя в чате не по данным только Telegram, а с возможностью поиска в данных локального кеша). В telebot о таких возможностях, по крайней мере ранее, не было оглашено;
• в telebot код простой и похож на код в aiogram, но не все вещи легко сделать;
• в aiogram некоторое может быть писать удобнее, чем в telebot.

История изменений по номерам версий: ChangeLog.txt.

---

Применение

Перевод и странслитерация

Бот при вводе его имени пользователя (@⁠TransToOldSlavonic_bot) и текста после него осуществляет попытку (см. [1]) перевести текст на старославянский язык. Отправлять результат можно сразу в тот чат, где сделан такой ввод. Для отправки достаточно нажать на блок с отправляемым текстом.

[1]: Подробно о функциях перевода: см., например,

• определение функции перевода вместе с транслитерацией,
• определение функции транслитерации на глаголическое письмо.

Пример перевода слова или текста в режиме inline:

Значение слова

По команде /meaning бот ищет значение слова. Возможен поиск со словами при игре в слова. См. /meaning help в боте для подробного описания.

В действии:

Файлы и папки

• Папка с файлами, специфическими при написании бота с различными библиотеками: telebot, aiogram, telethon.
• Некоторые данные: в папке data/.
• Файл с определением функций перевода и транслитерации: /functions.py.

References (литература; документация; ссылки)

Функции перевода и транслитерации, их работа

• Схема переводов: в /meta/Scheme.txt.
• Работа функций транслитерации:
  • https://www.ponomar.net/files/gama2/p002.htm (Название: "§2. Употребление и произношение букв")
• Про числа:
  • Общие сведения: http://lukianpovorotov.narod.ru/Folder_Pravoslavie/tserkovnoslavyanskiye_chisla.html
  • Подробности: http://konorama.ru/servisy/slacy/
  • Программа для конвертации чисел: http://info-7.ru/Titlo/Titlo.shtml (ссылка на это было в Википедии, см. прошлый (-е) ресурс (-ы))

Работа бота

• Режим inline:
  • https://core.telegram.org/bots/inline
• Мануалы по режиму inline в telebot:
  • https://mastergroosha.github.io/telegram-tutorial/docs/lesson_07/,
  • https://mastergroosha.github.io/telegram-tutorial/docs/lesson_08/ <з
• Telegram Bot API: https://core.telegram.org/bots/api

Heroku

• Deployment: https://devcenter.heroku.com/categories/deployment
• Creating a 'Deploy to Heroku' Button: https://devcenter.heroku.com/articles/heroku-button

Bot API

Telethon API

• Ссылка на Telethon API: https://tl.telethon.dev/.
• Bot API vs MTProto: https://docs.telethon.dev/en/latest/concepts/botapi-vs-mtproto.html.
• Также: https://docs.telethon.dev/en/latest/concepts/botapi-vs-mtproto.html?highlight=API#what-is-mtproto.
• Про Telethon API: https://docs.telethon.dev/en/latest/concepts/full-api.html
  • Часть текста про Telethon API:

    While you have access to this, you should always use the friendly methods listed on Client Reference unless you have a better reason not to, like a method not existing or you wanting more control.

• О переходе от aiogram/telebot к telethon: https://docs.telethon.dev/en/latest/concepts/botapi-vs-mtproto.html#botapi.

Telegram Bot API

Ссылка на Telegram Bot API: https://core.telegram.org/bots/api.

Замечание: Библиотеки aiogram и telebot являются реализацией этого API. Библиотека telethon написана с применением другого (собственного) API.

• Про требуемую для действия inline-кнопок базу (как пример в /help; InlineKeyboardMarkup):

  Note: This will only work in Telegram versions released after 9 April, 2016.

(из Telegram Bot API)

• Текст inline-запроса (через @<bot_username> текст):

Text of the query (up to 256 characters)

(из Telegram Bot API)

Другое

• Частичная документация по Git: https://git-scm.com/book/ru/v2/Основы-Git-Создание-Git-репозитория/.
• https://pypi.org/project/python-dotenv/
• http://www.fabfile.org/ link to it was at prev. (dotenv.).

Некоторая общая документация

• Боты в Telegram: https://core.telegram.org/bots.
• Telegram Bot API: https://core.telegram.org/bots/api.
• Документация к telethon (pip: Telethon): https://docs.telethon.dev/en/latest/.
• Документация к aiogram: https://docs.aiogram.dev/en/latest/.
• Документация к telebot (pip: pyTelegramBotAPI):
  • https://github.com/eternnoir/pyTelegramBotAPI#pytelegrambotapi;
  • https://pypi.org/project/pyTelegramBotAPI/.

See also

• Папка с версиями в библиотеках telebot, aiogram, telethon: /meta/versions-controll/.
• История изменений, нумерация по версиям: /meta/versions-controll/ChangeLog.txt.
• Некоторые заметки: /meta/NOTES.md.txt.

К началу страницы