diff --git a/command/overview.md b/command/overview.md index b579862..34f44da 100644 --- a/command/overview.md +++ b/command/overview.md @@ -19,7 +19,7 @@ -[`/o`](./on) +/o 检查是否在线 diff --git a/inline/share-twitter.md b/inline/share-twitter.md index b940202..0afd75e 100644 --- a/inline/share-twitter.md +++ b/inline/share-twitter.md @@ -1,24 +1,27 @@ # Twitter 分享链接格式化 -这个内联查询可以使输入的 twitter tweet 分享链接重新格式化为合法的 [vxtwitter][vxtwitter-home] 分享链接， -同时也会去除 twitter 分享链接会附带的跟踪参数。 +[vxtwitter]: https://github.com/dylanpdx/BetterTwitFix +[fxtwitter]: https://github.com/FixTweet/FixTweet -被输出的 vxtwitter 分享链接即能够基于 telegram 自带的链接预览工具，达到分享 tweet 内容的效果。 +这个**内联查询**可以使输入的 twitter **tweet** 分享链接重新格式化为合法的 [vxtwitter] 分享链接， +同时也会去除 **twitter** 分享链接会附带的**跟踪参数**。 + +被输出的 [vxtwitter] 分享链接即能够基于 **telegram** 自带的**链接预览**工具，达到分享 **tweet** **内容**的效果。 ## 输入 -支持以下各种格式的 twitter 分享链接: +支持以下各种格式的 **tweet** 分享链接: -- 标准的 tweet 链接 https://twitter.com/Twitter/status/1551967807428071431 -- 附带了跟踪参数的链接，例如但不限于使用 twitter 分享按钮时的默认链接 https://twitter.com/Twitter/status/1551967807428071431?s=20&t=IeYlNFDoXYi9WNk8BkJ3-A，相比于标准链接，其中 ?s=20&t=... 是跟踪参数 -- 简短的 twitter.com/Twitter/status/1551967807428071431 - - 也就是链接当中的 https:// 可以省略（如这个例子） +- **标准**的 tweet 链接 https://twitter.com/Twitter/status/1551967807428071431 +- 附带了**跟踪参数**的链接，例如但不限于使用 twitter 分享按钮时的默认链接 https://twitter.com/Twitter/status/1551967807428071431?s=20&t=IeYlNFDoXYi9WNk8BkJ3-A，相比于标准链接，其中 ?s=20&t=... 是跟踪参数 +- **简短**的 twitter.com/Twitter/status/1551967807428071431 + - 也就是链接当中的 ~~https://~~ 可以**省略**（如这个例子） - 也可以是 http:// -- 以 vxtwitter/[fxtwitter][fxtwitter-home] 为域名的 https://c.vxtwitter.com/Twitter/status/1551967807428071431 链接 +- 以 **[vxtwitter]**/**[fxtwitter]** 为域名的 https://c.vxtwitter.com/Twitter/status/1551967807428071431 链接 - 域名 c.vxtwitter.com 或是 vxtwitter.com 或是 fxtwitter.com 都受到支援 - 域名 www.twitter.com 也是受到支援的 - - *但域名 www.vxtwitter.com (以及带有 www. 的 fxtwitter 都) 并不被支援* -- 带有 /photo 参数的链接也受到支援，例如 https://fxtwitter.com/Do_While02/status/1579516695320072192/photo/2/。其实是来源于 [fxtwitter][fxtwitter-home]的，但这个分享工具所基于的 vxtwitter 其实并不支持 photo 参数和单图片分享 + - *但域名 ~~www.vxtwitter.com~~ (以及带有 ~~www.~~ 的 fxtwitter 都) 并**不**被支援* +- 带有 **/photo** 参数的链接也受到支援，例如 https://fxtwitter.com/Do_While02/status/1579516695320072192/photo/2/。其实是来源于 [fxtwitter]的，但这个分享工具所基于的 [vxtwitter] 其实并不支持 photo 参数和单图片分享 > （感觉写出来的就是一大坨好丑） @@ -27,25 +30,29 @@ ## 输出 -将会被格式化为 +将会被**格式化**为 https://vxtwitter.com/Twitter/status/1551967807428071431 - 选项 **[tweet] Share as VxTwitter** https://c.vxtwitter.com/Twitter/status/1551967807428071431 - 选项 **[tweet] Share as VxTwitter(combination)** -> 关于 combination method (官方说明摘抄) : +> 关于 **combination method** (官方说明摘抄) : > ***combination_method** - using c.vxtwitter as the url causes vxTwitter to combine all images in the post into one. * -格式化输出将只会保留 Twitter/status/1551967807428071431 部分，根据选项组合域名 +格式化输出将**只**会保留 Twitter/status/1551967807428071431 部分，根据选项组合域名 https://vxtwitter.com/ 或是 https://c.vxtwitter.com/。 -输入中的 ?s=20&t=... 等跟踪参数（目前来说是一切参数，可以看作是 -? 之后的一切）都会被丢弃掉。 +输入中的 ~~?s=20&t=...~~ 等**跟踪参数**（目前来说是一切参数，可以看作是 +? 之后的一切）都会被**丢弃**掉。 -目前，/photo 参数尽管会在输入中被解析，但并不会被组合进结果当中，即它也是会被丢弃的参数 -同时 vxtwitter 也本来就并不支援这个参数 +目前，~~/photo~~ 参数尽管会在输入中被解析，但并**不**会被组合进结果当中，即它也是会被**丢弃**的参数 +同时 **[vxtwitter]** 也本来就并**不支援**这个参数 -> 尽管目前，这个分享工具使用的是 vxtwitter 服务，搭配 telegram 自身的链接预览分享 tweet 内容，但 vxtwitter 所提供的 tweet 正文在遇到长文本时，会截断长文本（twitter 自身的链接预览都不会，尽管 twitter 自身的链接预览经常会获取不到预览内容）导致分享出来之后只剩下了文本摘要和一个 `...`。出于这个问题，我们也正在设计一个更好用一点的，不依赖于 vxtwitter 的分享方式。 +> 尽管目前，这个分享工具使用的是 [vxtwitter] 服务，搭配 telegram 自身的链接预览分享 tweet 内容，但 [vxtwitter] 所提供的 tweet 正文在遇到**长文本**时，会**截断**长文本，导致分享出来之后只剩下了文本摘要和一个 `...`。 +> +> （虽然其实，twitter 自身的链接预览都不会有截断问题，尽管 twitter 自身的链接预览经常会获取不到预览内容） +> +> 出于这个问题，我们也正在设计一个更好用一点的，不依赖于 [vxtwitter] 的分享方式。 +--> + +--- ## technic infomation -链接解析所使用的正则表达式 : ^(?:https?://)?((?:(?:c.)?vx|fx|www.)?twitter.com)/((\w+)/status/(\d+)(?:/photo/(\d+))?)/?(\?[\w&=-]+)?$ +链接解析 所使用的 正则表达式 : ^(?:https?://)?((?:(?:c.)?vx|fx|www.)?twitter.com)/((\w+)/status/(\d+)(?:/photo/(\d+))?)/?(\?[\w&=-]+)?$ diff --git a/main.md b/main.md index dca3195..222c35f 100644 --- a/main.md +++ b/main.md @@ -16,10 +16,10 @@ [Task Listing][todo] | [~~BBS~~][issues] | [Published][artifact] -**[$source/Coeur Morny Cono][source] | [@morny_cono_annie_bot][tg-account]** +**[$source/Coeur Morny Cono][Morny Coeur] | [@morny_cono_annie_bot][Morny Cono]** -[source]: https://github.com/Eyre-S/Coeur-Morny-Cono -[tg-account]: https://t.me/morny_cono_annie_bot +[Morny Coeur]: https://github.com/Eyre-S/Coeur-Morny-Cono +[Morny Cono]: https://t.me/morny_cono_annie_bot [issues]: https://github.com/Eyre-S/Coeur-Morny-Cono/issues [todo]: https://github.com/users/Eyre-S/projects/1 [artifact]: https://mvn.sukazyo.cc/#/releases/cc/sukazyo/morny-coeur @@ -29,19 +29,19 @@ --- -这是 [Morny Coeur][source] / [Morny Cono][tg-account] 的**使用手册**。 + +这是 **[Morny Coeur] / [Morny Cono]** 的**使用手册**。 **Monry** Cono 是一个使用 Morny **Coeur** 作为其核心的 **Telegram 机器人**。 ![a "Hello" sticker](https://stickers.sukazyo.cc/sticker/CAACAgEAAxkBAAMnYYYWKNXO4ibo9dlsmDctHhhV6fIAAqooAAJ4_MYFJJhrHS74xUAiBA.png) -欢迎使用 [Morny Cono][tg-account]！ -这也是一个 telegram 贴纸，是当你[第一次使用 bot](./command/on#alias-start) 时 bot 会和你打招呼使用的贴纸。 -它也用于[检查 bot 正在运行](./command/on) +**欢迎使用 [Morny Cono]！** +这也是一个 telegram 贴纸——是当你[第一次使用 bot](./command/on#alias-start) 时 bot 会和你打招呼使用的贴纸。 -这里是作为 **Morny Cono / Morny Coeur** 的 **wiki** 一样的存在，你可以从左侧的**页面导航**中找到一个描述你想要的**功能**的**页面**，点进去，即可查看使用这个功能的**指引**！ +这里是作为 **[Morny Cono] / [Morny Coeur]** 的 **wiki** 一样的存在，你可以从左侧的**页面导航**中找到一个描述你想要的**功能**的**页面**，点进去，即可查看使用这个功能的**指引**！ 就说到这里吧。 -顺带一提，这个 bot 的**作者**即是 **[@Eyre_S][tg-author]**：有问题去问她！ +顺带一提，这个 **bot**[官方实例][Morny Cono]以及它的[核心][Morny Coeur]，以及**这本书** 的**作者**即是 **[@Eyre_S][tg-author]**：有问题就**去问**她**！** diff --git a/trusted.md b/trusted.md index fb6ef0e..d269804 100644 --- a/trusted.md +++ b/trusted.md @@ -1,18 +1,18 @@ # "可信成员" 规则 -Morny 通过 MornyTrusted 判定一个角色是否属于可信成员。 +**Morny** 通过 MornyTrusted 判定一个角色是否属于**可信成员**。 -可信成员将有权利执行一些对 bot 而言具有破坏性或是有失安全性的行为 —— 简单而言，就是管理员权限。 +可信成员将有**权利**执行一些对 bot 而言具有**破坏性**或是**有失安全性**的行为 —— 简单而言，就是**管理员**权限。 Morny Coeur 有以下类型的可信成员规则： ## morny 的主人 -在 coeur 启动时，可以通过 `--master` 选项来设置主人的 telegram id。 +在 coeur 启动时，可以通过 **`--master`** 选项来设置**主人**的 telegram id。 **morny 本体的主人（和程序中的预设值）是 [telegram@Eyre_S(id`793274677`)][master]。** -> **for self hosting:** 如果在 coeur 程序启动时未设置这个字段，那么 coeur 将会遵循这个预设值的主人而不是没有主人。这意味着 *morny 本体的主人* 将拥有了这个实例的可信成员身份！如果你在自己搭建的实例中，不想设置主人，可以把它设置为 `-1`（在 telegram 中没有负数值的 id），而不是简单的不设置它——除非你愿意让 [@Eyre_S][master] 也能够管理你的实例。 +> **for self hosting:** 如果在 coeur 程序启动时**未设置**这个字段，那么 coeur 将会遵循这个**预设值**的主人而不是没有主人。这意味着 *morny 本体的主人* 将拥有了这个实例的可信成员身份！如果你在**自己搭建的实例**中，不想设置主人，可以把它设置为 **`-1`**（在 telegram 中没有负数值的 id），而不是简单的不设置它——除非你愿意让 [@Eyre_S][master] 也能够管理你的实例。 [master]: https://t.me/Eyre_S @@ -26,6 +26,6 @@ morny 本体的可信群组的设置（和程序中的预设值）是一个被 > **for self hosting:** > -> 关于预设值的问题，和上文的 “morny 的主人” 相同。如果要设置自己的实例，参照上文同时设定这个的值。 +> 关于预设值的问题，和上文的 “morny 的主人” 相同。如果要设置**自己的实例**，参照上文同时设定这个的值。 > -> 顺便需要注意的是，对于“超级群组”，需要填入一般带有 `-100` 前缀的被称作 “bot format” 格式的群组 id。否则，在向 telegram 的 api 请求时会出现问题关于这个问题，请自行详细了解~~麻烦的~~ [telegram bot api](https://core.telegram.org/bots/api)，在此不再赘述。 +> 顺便需要注意的是，对于“超级群组”，需要填入一般带有 **`-100`** **前缀**的被称作 **“bot format”** 格式的群组 id。否则，在向 telegram 的 api 请求时会出现问题关于这个问题，请自行详细了解~~麻烦的~~ [telegram bot api](https://core.telegram.org/bots/api)，在此不再赘述。
vxtwitter version