Need to deliver formatted content to your bot clients? Having a hangover after trying to fit HTML into telegram? Beautifulsoup is too complicated and not helping with messages?
Try sulguk (술국, a hangover
soup) - delivered since 1800s.
Telegram supports parse_mode="html", but:
- Telegram processes spaces and new lines incorrectly. So we cannot format HTML source for more readability.
- Amount of supported tags is very low
- It does not ignore additional attributes in supported tags.
Let's imagine we have HTML like this:
<b>This is a demo of <a href="https://github.com/tishka17/sulguk">Sulguk</a></b>
<u>Underlined</u>
<i>Italic</i>
<b>Bold</b>This is how it is rendered in browser (expected behavior):
But this is how it is rendered in Telegram with parse_mode="html":
To solve this we can convert HTML to telegram entities with sulguk. So that's how it looks now:
- Create your nice HTML:
<ol start="10">
<li>some item</li>
<li>other item</li>
</ol>
<p>Some <b>text</b> in a paragraph</p>- Convert it into text and entities
result = transform_html(raw_html)- Send it to telegram.
Depending on your library you may need to convert entities from dict into proper type
await bot.send_message(
chat_id=CHAT_ID,
text=result.text,
entities=result.entities,
)- Add
SulgukMiddlewareto your bot
from sulguk import AiogramSulgukMiddleware
bot.session.middleware(AiogramSulgukMiddleware())- Create your nice HTML:
<ol start="10">
<li>some item</li>
<li>other item</li>
</ol>
<p>Some <b>text</b> in a paragraph</p>- Send it using
sulgukas aparse_mode:
from sulguk import SULGUK_PARSE_MODE
await bot.send_message(
chat_id=CHAT_ID,
text=raw_html,
parse_mode=SULGUK_PARSE_MODE,
)For all supported tags unknown attributes are ignored as well as unknown classes. Unsupported tags are raising an error.
<a>- a hyperlink withhrefattribute<b>,<strong>- a bold text<i>,<em>- an italic text<s>,<strike>,<del>- a strikethrough text<u>,<ins>- an underlined text<span>- an inline element with optional attributeclass="tg-spoiler"to make a spoiler<tg-spoiler>- a telegram spoiler<pre>with optionalclass="language-<name>"- a preformatted block with code.<name>will be sent as a language attribute in telegram.<code>- an inline preformatted element.
Note: In standard Telegram HTML you can set a preformatted text language nesting <code class="language-<name>"> in <pre> tag. This works when it is an only child. But any additional symbol outside of <code> breaks it.
The same behavior is supported in sulguk. Otherwise, you can set the language on <pre> tag itself.
<br/>- new line<hr/>- horizontal line<wbr/>- word break opportunity<ul>- unordered list<ol>- ordered list with optional attributesreversed- to reverse numbers ordertype(1/a/A/i/I) - to set numbering stylestart- to set starting number
<li>- list item, with optionalvalueattribute to change number. Nested lists have indentation<div>- a block (not inline) element<p>- a paragraph, emphasized with empty lines<q>- a quoted text<blockquote>- a block quote. Like a paragraph with indentation<h1>-<h6>- text headers, styled using available telegram options<noscirpt>- contents is shown as not scripting is supported<cite>,<var>- italic<progress>,<meter>are rendered using emoji (🟩🟩🟩🟨⬜️⬜️)<kbd>,<samp>- preformatted text<img>- as a link with picture emoji before.alttext is used if provided.
<footer>, <header>, <main>, <nav>, <section>
<html>, <body>, <output>, <data>, <time>
<head>, <link>, <meta>, <script>, <style>, <template>, <title>
- Install with addons
pip install 'sulguk[cli]'- Set environment variable
BOT_TOKEN
export BOT_TOKEN="your telegram token"- Send HTML file as a message to your channel. Additional files will be sent as comments to the first one. You can provide a channel name or a public link
sulguk send @chat_id file.html- If you want to, edit using the link from shell or from your tg client. Edition of comments is supported as well.
sulguk edit 'https://t.me/channel/1?comment=42' file.html