morny-book/inline/share-twitter.md

# Twitter 分享链接格式化

[vxtwitter]: https://github.com/dylanpdx/BetterTwitFix
[fxtwitter]: https://github.com/FixTweet/FixTweet

这个**内联查询**可以使输入的 twitter **tweet** 分享链接重新格式化为合法的 [vxtwitter] 分享链接，
同时也会去除 **twitter** 分享链接会附带的**跟踪参数**。

被输出的 [vxtwitter] 分享链接即能够基于 **telegram** 自带的**链接预览**工具，达到分享 **tweet** **内容**的效果。

## 输入

支持以下各种格式的 **tweet** 分享链接:

- **标准**的 tweet 链接 <code><font color="mediumseagreen">https://</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font></code>
- 附带了**跟踪参数**的链接，例如但不限于使用 twitter 分享按钮时的默认链接 <code><font color="mediumseagreen">https://</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font><font color="tan">?s=20&t=IeYlNFDoXYi9WNk8BkJ3-A</font></code>，相比于标准链接，其中 <code><font color="tan">?s=20&t=...</font></code> 是跟踪参数
- **简短**的 <code><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font></code>
  - 也就是链接当中的 ~~<code><font color="mediumseagreen">https://</font></code>~~ 可以**省略**（如这个例子）
  - 也可以是 <code><font color="mediumseagreen">http://</font></code>
- 以 **[vxtwitter]**/**[fxtwitter]** 为域名的 <code><font color="mediumseagreen">https://</font><font color="lightsalmon">c.</font><font color="orangered">vx</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font></code> 链接
  - 域名 <code><font color="lightsalmon">c.</font><font color="orangered">vx</font><font color="orange">twitter.com</font></code> 或是 <code><font color="orangered">vx</font><font color="orange">twitter.com</font></code> 或是 <code><font color="orangered">fx</font><font color="orange">twitter.com</font></code> 都受到支援
  - 域名 <code><font color="lightsalmon">www.</font><font color="orange">twitter.com</font></code> 也是受到支援的
    - *但域名 ~~<code><font color="lightsalmon">www.</font><font color="orangered">vx</font><font color="orange">twitter.com</font></code>~~ (以及带有 ~~<code><font color="lightsalmon">www.</font></code>~~ 的 <code><font color="orangered">fx</font><font color="orange">twitter</font></code> 都) 并**不**被支援*
- 带有 **<code><font color="mediumorchid">/photo</font></code>** 参数的链接也受到支援，例如 <code><font color="mediumseagreen">https://</font><font color="orangered">fx</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Do_While02/status/1579516695320072192</font><font color="mediumorchid">/photo/2/</font></code>。<small>其实是来源于 [fxtwitter]的，但这个分享工具所基于的 [vxtwitter] 其实并不支持 photo 参数和单图片分享</small>

> （感觉写出来的就是一大坨好丑）

<!-- [引自 世界计划小站 （日向 加藤）]
#同人 https://fxtwitter.com/Do_While02/status/1579516695320072192/photo/2/ -->

## 输出

将会被**格式化**为

<code><font color="mediumseagreen">https://</font><font color="orangered">vx</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font></code> - 选项 **[tweet] Share as VxTwitter**  
<code><font color="mediumseagreen">https://</font><font color="lightsalmon">c.</font><font color="orangered">vx</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font></code> - 选项 **[tweet] Share as VxTwitter(combination)**

> 关于 **combination method** (官方说明摘抄) :  
> ***combination_method** - using c.vxtwitter as the url causes vxTwitter to combine all images in the post into one. *

格式化输出将**只**会保留 <code><font color="cornflowerblue">Twitter/status/1551967807428071431</font></code> 部分，根据选项组合域名
<code><font color="mediumseagreen">https://</font><font color="orangered">vx</font><font color="orange">twitter.com</font>/</code> 或是
<code><font color="mediumseagreen">https://</font><font color="lightsalmon">c.</font><font color="orangered">vx</font><font color="orange">twitter.com</font>/</code>。

输入中的 ~~<code><font color="tan">?s=20&t=...</font></code>~~ 等**跟踪参数**（目前来说是一切参数，可以看作是
<code><font color="tan">?</font></code> 之后的一切）都会被**丢弃**掉。

目前，~~<code><font color="mediumorchid">/photo</font></code>~~ 参数尽管会在输入中被解析，但并**不**会被组合进结果当中，即它也是会被**丢弃**的参数
<small markdown=1>同时 **[vxtwitter]** 也本来就并**不支援**这个参数</small>

> 尽管目前，这个分享工具使用的是 [vxtwitter] 服务，搭配 telegram 自身的链接预览分享 tweet 内容，但 [vxtwitter] 所提供的 tweet 正文在遇到**长文本**时，会**截断**长文本，导致分享出来之后只剩下了文本摘要和一个 `...`。
>
> （虽然其实，twitter 自身的链接预览都不会有截断问题，尽管 twitter 自身的链接预览经常会获取不到预览内容）
>
> 出于这个问题，我们也正在设计一个更好用一点的，不依赖于 [vxtwitter] 的分享方式。

<!-- ## egs:

input: <code><font color="mediumseagreen">https://</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font><font color="tan">?s=20&t=IeYlNFDoXYi9WNk8BkJ3-A</font></code>

[tweet] Share as VxTwitter : <code><font color="mediumseagreen">https://</font><font color="orangered">vx</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font></code>  
[tweet] Share as VxTwitter(combination) : <code><font color="mediumseagreen">https://</font><font color="lightsalmon">c.</font><font color="orangered">vx</font><font color="orange">twitter.com</font>/<font color="cornflowerblue">Twitter/status/1551967807428071431</font></code>  

-->

---

## technic infomation

链接解析 所使用的 正则表达式 : <code class="regex">^(?:https?://)?((?:(?:c.)?vx|fx|www.)?twitter.com)/((\w+)/status/(\d+)(?:/photo/(\d+))?)/?(\?[\w&=-]+)?$</code>

<table>
<caption>vxtwitter version</caption>
<thead><tr><th colspan=2>inline query node info</th></tr></thead>
<tr><td align=right><b>title</b></td><td>[tweet] Share as VxTwitter</td></tr>
<tr><td align=right><b>id</b></td><td><code>[morny/share/twitter/vxtwi]</code></td></tr>
<tr><td align=right><b>cache</b></td><td><u>default<small><code>300</code></small></u></td></tr>
<tr><td align=right><b>is_personal</b></td><td><u>default<small><code>false</code></small></u></td></tr>
</table>

<table>
<caption>c.vxtwitter version</caption>
<thead><tr><th colspan=2>inline query node info</th></tr></thead>
<tr><td align=right><b>title</b></td><td>[tweet] Share as VxTwitter (combination)</td></tr>
<tr><td align=right><b>id</b></td><td><code>[morny/share/twitter/vxtwi_combine]</code></td></tr>
<tr><td align=right><b>cache</b></td><td><u>default<small><code>300</code></small></u></td></tr>
<tr><td align=right><b>is_personal</b></td><td><u>default<small><code>false</code></small></u></td></tr>
</table>