diff --git a/book.xml b/book.xml index c6ea515..98a25e2 100644 --- a/book.xml +++ b/book.xml @@ -4,7 +4,9 @@ + + diff --git a/command/hello.md b/command/hello.md new file mode 100644 index 0000000..4a44e18 --- /dev/null +++ b/command/hello.md @@ -0,0 +1,30 @@ +# /hello + +> also known as **`/hi`** +> +> also available as *`/start`* +> +> **打招呼** + + + +## usage - 用法 + +直接使用命令**命令**不要求也不需要任何**参数**来和 Morny 打招呼，然后 Morny 也会和你打招呼。 + +{.sticker} +![a sticker with handshake for you](https://stickers.sukazyo.cc/sticker/CAACAgEAAxkBAAMnYYYWKNXO4ibo9dlsmDctHhhV6fIAAqooAAJ4_MYFJJhrHS74xUAiBA.png) + +> 如果 Morny 没有任何回应，那大概率是 Morny 离线了... + +--- + +## 当第一次使用 Morny Cono + +当你第一次在私聊中和 Morny 说话时，Morny 也会通过这个贴纸来和你打招呼。 + +这也是通过定义命令别名 `/start` 来实现的。在 Telegram 中，用户第一次使用 bot 将会向 bot 发送 `/start` 命令，因此 Morny Cono 知道发送 `/start` 命令即是第一次使用 Morny，就会和你打招呼了。 diff --git a/command/nbnhhsh.md b/command/nbnhhsh.md new file mode 100644 index 0000000..c150053 --- /dev/null +++ b/command/nbnhhsh.md @@ -0,0 +1,76 @@ +# /nbnhhsh + +> > `text` | reply_to(text) +> +> 检索文本内 [nbnhhsh] 词条 + +[nbnhhsh]: https://lab.magiconch.com/nbnhhsh/ + +**[Nbnhhsh]**，又称 **「能不能好好说话？」**，是一个能够把奇奇怪怪让人看不懂的名称简写转换为它们能让人听得懂的学名全称的东西。 + +> ### 为什么做这东西？ +> +> 社交平台上通过拼音首字母缩写指代特定词句的情况越来越多，为了让更多人能勉强理解这一门另类沟通方式、做了这一个划词转义工具。 +> +> -- from [「能不能好好说话？」][nbnhhsh] 官方页面 + +**Morny** 的 `/nbnhhsh` 命令即是一个在 telegram 中的 [nbnhhsh] 查询工具的移植封装，为了大家能够更方便的使用其来查询短语。 + +## usage - 使用 + + + +**Morny** 的 `/nbnhhsh` 支持通过两种调用方式进行 nbnhhsh 查询。 + +**其一**是使用 `/nbnhhsh` 命令回复一条消息，就可以查询被回复消息中的 nbnhhsh 词条： + +
> Aa for Test
+这是一个例文，ta里面就有一些「nbnhhsh」的简写短语。
+
+> ANNIe
+> in reply to Aa for Test
+/nbnhhsh
+ +**其二**是通过 `/nbnhhsh texts...` 在命令后加内容的方式查询，可以查询命令后内容文本中的 nbnhhsh 词条。 + +
> ANNIe
+/nbnhhsh nbnhhsh # 想要查询的单词，或者这里也可以塞一段话查询一整段话里面的单词。
+ +**Morny** 将会从 official [nbnhhsh] 查询这里面有哪些 nbnhhsh 单词，然后列出它们和它们的释义，回复给 nbnhhsh 查询者。 + +所给出的回复大概是这个格式的： + +```nohighlight +## Result of nbnhhsh query : + +[[ ta ]] +* 圣堂刺客 +* 他/她/它 +* 天啊 + +[[ nbnhhsh ]] +* 能不能好好说话 +``` + +--- + +## 你知道吗 + +- [nbnhhsh] 官方的 api 的设计就是直接传进去一整段文字，然后 api 就可以吐出来这段文字里有什么符合 nbnhhsh 词条的词，然后返回这些词条。 + + + +- Morny 最后所返回的 `## Result of nbnhhsh query :` 那个标题是可以点击的（显然，它就是一个链接），它指向的就是 nbnhhsh 的官方网页 + - 其实，最开始是想让这个标题指向 nbnhhsh 官网，然后打开就可以复现这次查询的内容（也就是可以说是带着查询内容的参数）。然而最终似乎 nbnhhsh 官网并没有提供这样的查询链接格式，最终的设计就 fallback 到了单纯往官网页面指向过去好了。 + + + +- 这大概是第8个解释功能的页面。写到这里就给人感觉写的内容越来越少了。不过，本来这些功能都不能说很复杂，或许本来就不需要那么多废话来阐述就是了。 diff --git a/command/on.md b/command/on.md index df3994e..e364c8c 100644 --- a/command/on.md +++ b/command/on.md @@ -2,6 +2,12 @@ > **检查是否在线** + + ## usage - 用法 **直接使用命令。** @@ -10,7 +16,8 @@ 使用后，如果 bot **在线**，即会返回贴纸 **`sticker.ID_ONLINE_STATUS_RETURN`**： -![a "Hello" sticker](https://stickers.sukazyo.cc/sticker/CAACAgEAAx0CW-CvvgAC5eBhhhODGRuu0pxKLwoQ3yMsowjviAACcycAAnj8xgVVU666si1utiIE.png) +{.sticker} +![a sticker that have a big "O" in hand](https://stickers.sukazyo.cc/sticker/CAACAgEAAx0CW-CvvgAC5eBhhhODGRuu0pxKLwoQ3yMsowjviAACcycAAnj8xgVVU666si1utiIE.png) 如果 bot 当前正在**离线**状态，则**不会返回任何东西**。 diff --git a/command/overview.md b/command/overview.md index 02d459a..596ff91 100644 --- a/command/overview.md +++ b/command/overview.md @@ -25,12 +25,12 @@ -/hello +/hello 打招呼 -/hi +/hi @@ -46,7 +46,7 @@ -/nbnhhsh +/nbnhhsh <text> | reply_to(text) 检索文本内 nbnhhsh 词条 diff --git a/main.md b/main.md index 17b5fe5..46eea25 100644 --- a/main.md +++ b/main.md @@ -31,15 +31,21 @@ --- + + 这是 **[Morny Coeur] / [Morny Cono]** 的**使用手册**。 **Monry** Cono 是一个使用 Morny **Coeur** 作为其核心的 **Telegram 机器人**。 -![a "Hello" sticker](https://stickers.sukazyo.cc/sticker/CAACAgEAAxkBAAMnYYYWKNXO4ibo9dlsmDctHhhV6fIAAqooAAJ4_MYFJJhrHS74xUAiBA.png) +![a "Hello" sticker](https://stickers.sukazyo.cc/sticker/CAACAgEAAxkBAAMnYYYWKNXO4ibo9dlsmDctHhhV6fIAAqooAAJ4_MYFJJhrHS74xUAiBA.png){.sticker} **欢迎使用 [Morny Cono]！** -这也是一个 telegram 贴纸——是当你[第一次使用 bot](./command/on#alias-start) 时 bot 会和你打招呼使用的贴纸。 +这也是一个 telegram 贴纸——是当你[第一次使用 bot](./command/hello#当第一次使用-morny-cono) 时 bot 会和你打招呼使用的贴纸。 这里是作为 **[Morny Cono] / [Morny Coeur]** 的 **wiki** 一样的存在，你可以从左侧的**页面导航**中找到一个描述你想要的**功能**的**页面**，点进去，即可查看使用这个功能的**指引**！