Написан мной Профессиональный бот для конвертации статей с Telegraph / Teletype в красивые PDF-файлы.
Возможности
Поддержка доменов: telegra.ph, teletype.in, graph.org
Сохранение всех изображений внутри PDF
Красивое форматирование: шрифты, отступы, стили
Асинхронная обработка запросов
Автоматическая очистка временных файлов
Обработка ошибок и валидация ссылок
Логирование всех операций
Требования
Python версии 3.10 или выше
Telegram Bot Token (получается через botfather)
Системные библиотеки для работы WeasyPrint
Установка
Шаг 1. Подготовка проекта
Создайте директорию проекта и перейдите в неё:
mkdir telegraph_pdf_bot
cd telegraph_pdf_bot
Скопируйте в папку файлы main.py и requirements.txt.
Шаг 2. Установка системных зависимостей
WeasyPrint требует системные библиотеки для работы со шрифтами и графикой.
Linux (Ubuntu / Debian):
sudo apt-get update
sudo apt-get install -y \
python3-pip \
python3-venv \
libpango-1.0-0 \
libpangoft2-1.0-0 \
libgdk-pixbuf2.0-0 \
libffi-dev \
shared-mime-info
Linux (CentOS / RHEL / Fedora):
sudo dnf install -y \
python3-pip \
python3-virtualenv \
pango \
gdk-pixbuf2 \
libffi-devel
macOS:
brew install python3 pango gdk-pixbuf libffi
Windows:
WeasyPrint на Windows требует GTK3.
Альтернатива для Windows — использовать WSL2 и следовать Linux-инструкциям.
Шаг 3. Создание виртуального окружения
python3 -m venv venv
Активация:
Linux / macOS:
source venv/bin/activate
Windows:
venv\Scripts\activate
Шаг 4. Установка Python-зависимостей
pip install --upgrade pip
pip install -r requirements.txt
Шаг 5. Настройка токена бота
Рекомендуемый способ — через переменную окружения.
Linux / macOS:
export TELEGRAM_BOT_TOKEN="your_bot_token_here"
Windows CMD:
set TELEGRAM_BOT_TOKEN=your_bot_token_here
Windows PowerShell:
$env:TELEGRAM_BOT_TOKEN="your_bot_token_here"
Для постоянного хранения:
Linux / macOS:
echo 'export TELEGRAM_BOT_TOKEN="your_token"' >> ~/.bashrc
source ~/.bashrc
Windows:
Добавьте переменную через
Система → Дополнительные параметры → Переменные среды
Альтернативный способ (не рекомендуется):
В main.py заменить:
TELEGRAM_TOKEN = os.getenv('TELEGRAM_BOT_TOKEN', 'YOUR_BOT_TOKEN_HERE')
на:
TELEGRAM_TOKEN = 'ваш_токен_от_BotFather'
Шаг 6. Запуск бота
python main.py
В консоли должно появиться сообщение:
INFO - Бот запущен и готов к работе!
Использование
Команды бота
/start — приветствие
/help — справка
Технические детали
Используемые библиотеки:
python-telegram-bot 21.0.1 — асинхронная работа с Telegram
requests — загрузка страниц
beautifulsoup4 — парсинг HTML
weasyprint — генерация PDF
lxml — быстрый HTML/XML парсер
Pillow — обработка изображений
Структура проекта
telegraph_pdf_bot/
├── main.py
├── requirements.txt
├── README.md
├── temp_pdfs/
└── venv/
Решение проблем
Ошибка "No module named telegram":
Активируйте виртуальное окружение и переустановите зависимости.
Ошибка "cannot load library gobject":
Linux:
sudo apt-get install libgobject-2.0-0
Windows:
Переустановите GTK3 Runtime.
Ошибка "Token not set":
Проверьте переменную окружения или токен в коде.
PDF без изображений:
Проверьте доступность картинок и интернет-соединение.
Продакшен
Systemd (Linux)
Создайте файл /etc/systemd/system/telegraph-bot.service:
[Unit]
Description=Telegraph PDF Bot
After=network.target
[Service]
Type=simple
User=your_username
WorkingDirectory=/path/to/telegraph_pdf_bot
Environment="TELEGRAM_BOT_TOKEN=your_token_here"
ExecStart=/path/to/telegraph_pdf_bot/venv/bin/python main.py
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Docker
Dockerfile:
FROM python:3.11-slim
RUN apt-get update && apt-get install -y \
libpango-1.0-0 \
libpangoft2-1.0-0 \
libgdk-pixbuf2.0-0 \
libffi-dev \
shared-mime-info \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY main.py .
CMD ["python", "main.py"]
Запуск:
docker build -t telegraph-bot .
docker run -d \
--name telegraph-bot \
-e TELEGRAM_BOT_TOKEN=your_token \
--restart unless-stopped \
telegraph-bot
СКРИНШОТ:
Возможности
Поддержка доменов: telegra.ph, teletype.in, graph.org
Сохранение всех изображений внутри PDF
Красивое форматирование: шрифты, отступы, стили
Асинхронная обработка запросов
Автоматическая очистка временных файлов
Обработка ошибок и валидация ссылок
Логирование всех операций
Требования
Python версии 3.10 или выше
Telegram Bot Token (получается через botfather)
Системные библиотеки для работы WeasyPrint
Установка
Шаг 1. Подготовка проекта
Создайте директорию проекта и перейдите в неё:
mkdir telegraph_pdf_bot
cd telegraph_pdf_bot
Скопируйте в папку файлы main.py и requirements.txt.
Шаг 2. Установка системных зависимостей
WeasyPrint требует системные библиотеки для работы со шрифтами и графикой.
Linux (Ubuntu / Debian):
sudo apt-get update
sudo apt-get install -y \
python3-pip \
python3-venv \
libpango-1.0-0 \
libpangoft2-1.0-0 \
libgdk-pixbuf2.0-0 \
libffi-dev \
shared-mime-info
Linux (CentOS / RHEL / Fedora):
sudo dnf install -y \
python3-pip \
python3-virtualenv \
pango \
gdk-pixbuf2 \
libffi-devel
macOS:
brew install python3 pango gdk-pixbuf libffi
Windows:
WeasyPrint на Windows требует GTK3.
- Скачайте GTK3 Runtime:
Releases · tschoonj/GTK-for-Windows-Runtime-Environment-Installer | End Way - Форум программирования и сливов различных скриптов - Установите и включите опцию добавления в PATH
- Перезапустите терминал
Альтернатива для Windows — использовать WSL2 и следовать Linux-инструкциям.
Шаг 3. Создание виртуального окружения
python3 -m venv venv
Активация:
Linux / macOS:
source venv/bin/activate
Windows:
venv\Scripts\activate
Шаг 4. Установка Python-зависимостей
pip install --upgrade pip
pip install -r requirements.txt
Шаг 5. Настройка токена бота
Рекомендуемый способ — через переменную окружения.
Linux / macOS:
export TELEGRAM_BOT_TOKEN="your_bot_token_here"
Windows CMD:
set TELEGRAM_BOT_TOKEN=your_bot_token_here
Windows PowerShell:
$env:TELEGRAM_BOT_TOKEN="your_bot_token_here"
Для постоянного хранения:
Linux / macOS:
echo 'export TELEGRAM_BOT_TOKEN="your_token"' >> ~/.bashrc
source ~/.bashrc
Windows:
Добавьте переменную через
Система → Дополнительные параметры → Переменные среды
Альтернативный способ (не рекомендуется):
В main.py заменить:
TELEGRAM_TOKEN = os.getenv('TELEGRAM_BOT_TOKEN', 'YOUR_BOT_TOKEN_HERE')
на:
TELEGRAM_TOKEN = 'ваш_токен_от_BotFather'
Шаг 6. Запуск бота
python main.py
В консоли должно появиться сообщение:
INFO - Бот запущен и готов к работе!
Использование
- Откройте бота в Telegram
- Отправьте команду /start
- Отправьте ссылку на статью Telegraph
Пример:
https://telegra.ph/Example-Article-12-31 - Подождите 5–10 секунд
- Получите PDF файл
Команды бота
/start — приветствие
/help — справка
Технические детали
Используемые библиотеки:
python-telegram-bot 21.0.1 — асинхронная работа с Telegram
requests — загрузка страниц
beautifulsoup4 — парсинг HTML
weasyprint — генерация PDF
lxml — быстрый HTML/XML парсер
Pillow — обработка изображений
Структура проекта
telegraph_pdf_bot/
├── main.py
├── requirements.txt
├── README.md
├── temp_pdfs/
└── venv/
Решение проблем
Ошибка "No module named telegram":
Активируйте виртуальное окружение и переустановите зависимости.
Ошибка "cannot load library gobject":
Linux:
sudo apt-get install libgobject-2.0-0
Windows:
Переустановите GTK3 Runtime.
Ошибка "Token not set":
Проверьте переменную окружения или токен в коде.
PDF без изображений:
Проверьте доступность картинок и интернет-соединение.
Продакшен
Systemd (Linux)
Создайте файл /etc/systemd/system/telegraph-bot.service:
[Unit]
Description=Telegraph PDF Bot
After=network.target
[Service]
Type=simple
User=your_username
WorkingDirectory=/path/to/telegraph_pdf_bot
Environment="TELEGRAM_BOT_TOKEN=your_token_here"
ExecStart=/path/to/telegraph_pdf_bot/venv/bin/python main.py
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Docker
Dockerfile:
FROM python:3.11-slim
RUN apt-get update && apt-get install -y \
libpango-1.0-0 \
libpangoft2-1.0-0 \
libgdk-pixbuf2.0-0 \
libffi-dev \
shared-mime-info \
&& rm -rf /var/lib/apt/lists/*
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY main.py .
CMD ["python", "main.py"]
Запуск:
docker build -t telegraph-bot .
docker run -d \
--name telegraph-bot \
-e TELEGRAM_BOT_TOKEN=your_token \
--restart unless-stopped \
telegraph-bot
СКРИНШОТ:
Для просмотра скрытого содержимого вы должны войти или зарегистрироваться.
СКАЧАТЬ: Для просмотра скрытого содержимого вы должны войти или зарегистрироваться.
