InsanusMokrassar/tgbotapi
1
0
Fork 0
mirror of https://github.com/InsanusMokrassar/TelegramBotAPI.git synced 2025-09-03 15:19:30 +00:00
Code Releases Activity

docs: make buildEntities usage more obvious to anyone not familiar with Telegram Bot API or ktgbotapi

Browse Source
This commit is contained in:
alex
2025-06-23 18:54:58 +08:00
parent 92f2a5afdb
commit 256607e336
1 changed files with 49 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

49
tgbotapi.core/src/commonMain/kotlin/dev/inmo/tgbotapi/utils/EntitiesBuilder.kt
View File

@@ -12,7 +12,56 @@ import dev.inmo.tgbotapi.types.message.textsources.*
typealias EntitiesBuilderBody = EntitiesBuilder.() -> Unit
val newLine = regularTextSource("\n")
/**
* Documentation: [DSL text](https://docs.inmo.dev/tgbotapi/dsls/text.html)
*
* Example: [PollsBot](https://github.com/InsanusMokrassar/TelegramBotAPI-examples/blob/master/PollsBot/src/main/kotlin/PollsBot.kt)
*
* @see dev.inmo.tgbotapi.utils.bold
* @see dev.inmo.tgbotapi.utils.blockquote
* @see dev.inmo.tgbotapi.utils.expandableBlockquote
* @see dev.inmo.tgbotapi.utils.spoiler
* @see dev.inmo.tgbotapi.utils.botCommand
* @see dev.inmo.tgbotapi.utils.cashTag
* @see dev.inmo.tgbotapi.utils.code
* @see dev.inmo.tgbotapi.utils.email
* @see dev.inmo.tgbotapi.utils.hashtag
* @see dev.inmo.tgbotapi.utils.italic
* @see dev.inmo.tgbotapi.utils.mention
* @see dev.inmo.tgbotapi.utils.phone
* @see dev.inmo.tgbotapi.utils.pre
* @see dev.inmo.tgbotapi.utils.regular
* @see dev.inmo.tgbotapi.utils.strikethrough
* @see dev.inmo.tgbotapi.utils.link
* @see dev.inmo.tgbotapi.utils.underline
* @see dev.inmo.tgbotapi.utils.customEmoji
*/
inline fun buildEntities(separator: TextSource? = null, init: EntitiesBuilderBody): TextSourcesList = EntitiesBuilder(separator).apply(init).build()
/**
* Documentation: [DSL text](https://docs.inmo.dev/tgbotapi/dsls/text.html)
*
* Example: [PollsBot](https://github.com/InsanusMokrassar/TelegramBotAPI-examples/blob/master/PollsBot/src/main/kotlin/PollsBot.kt)
*
* @see dev.inmo.tgbotapi.utils.bold
* @see dev.inmo.tgbotapi.utils.blockquote
* @see dev.inmo.tgbotapi.utils.expandableBlockquote
* @see dev.inmo.tgbotapi.utils.spoiler
* @see dev.inmo.tgbotapi.utils.botCommand
* @see dev.inmo.tgbotapi.utils.cashTag
* @see dev.inmo.tgbotapi.utils.code
* @see dev.inmo.tgbotapi.utils.email
* @see dev.inmo.tgbotapi.utils.hashtag
* @see dev.inmo.tgbotapi.utils.italic
* @see dev.inmo.tgbotapi.utils.mention
* @see dev.inmo.tgbotapi.utils.phone
* @see dev.inmo.tgbotapi.utils.pre
* @see dev.inmo.tgbotapi.utils.regular
* @see dev.inmo.tgbotapi.utils.strikethrough
* @see dev.inmo.tgbotapi.utils.link
* @see dev.inmo.tgbotapi.utils.underline
* @see dev.inmo.tgbotapi.utils.customEmoji
*/
inline fun buildEntities(separator: String, init: EntitiesBuilderBody) = buildEntities(regularTextSource(separator), init)
/**