docs(up): upload to topic (#1104)

* docs: upload to topic

* docs: upload to topic

* docs: upload to topic

* docs: fix duplicate filter blocks

* docs: align path param

* docs: fix file name var name

* fix

* fix

Author: iyear

docs/content/en/guide/upload.md

@@ -19,10 +19,70 @@ Upload to custom chat.
 
 {{< include "snippets/chat.md" >}}
 
+### Specific Chat
+
+Upload to specific one chat:
+
 {{< command >}}
 tdl up -p /path/to/file -c CHAT
 {{< /command >}}
 
+Upload to specific topic in a forum chat:
+
+{{< command >}}
+tdl up -p /path/to/file -c CHAT --topic TOPIC_ID
+{{< /command >}}
+
+### Message Routing
+
+Upload to different chats by message router which is based on [expression](/reference/expr).
+
+{{< hint warning >}}
+The `--to` flag is conflicted with the `-c/--chat` and `--topic` flags. You can only use one of them.
+{{< /hint >}}
+
+List all available fields:
+
+{{< command >}}
+tdl up -p /path/to/file --to -
+{{< /command >}}
+
+Upload to `CHAT1` if MIME contains `video`, otherwise upload to `Saved Messages`:
+
+{{< hint info >}}
+You must return a **string** or **struct** as the target CHAT, and empty string means upload to `Saved Messages`.
+{{< /hint >}}
+
+{{< command >}}
+tdl up -p /path/to/file \
+--to 'MIME contains "video" ? "CHAT1" : ""'
+{{< /command >}}
+
+Upload to `CHAT1` if MIME contains `video`, otherwise upload to reply to message/topic `4` in `CHAT2`:
+
+{{< command >}}
+tdl up -p /path/to/file \
+--to 'MIME contains "video" ? "CHAT1" : { Peer: "CHAT2", Thread: 4 }'
+{{< /command >}}
+
+Pass a file name if the expression is complex:
+
+{{< details "router.txt" >}}
+Write your expression like `switch`:
+
+```javascript
+MIME contains "video" ? "CHAT1" :
+FileExt contains ".mp3" ? "CHAT2" :
+FileName contains "chat3" > 30 ? {Peer: "CHAT3", Thread: 101} :
+""
+```
+
+{{< /details >}}
+
+{{< command >}}
+tdl up -p /path/to/file --to router.txt
+{{< /command >}}
+
 ## Custom Parameters
 
 Upload with 8 threads per task, 4 concurrent tasks:
@@ -38,17 +98,17 @@ Custom caption is based on [expression](/reference/expr).
 List all available fields:
 
 {{< command >}}
-tdl up -p ./downloads --caption -
+tdl up -p /path/to/file --caption -
 {{< /command >}}
 
 Custom simple caption:
 {{< command >}}
-tdl up -p ./downloads --caption 'File.Name + " - uploaded by tdl"'
+tdl up -p /path/to/file --caption 'FileName + " - uploaded by tdl"'
 {{< /command >}}
 
 Write styled message with [HTML](https://core.telegram.org/bots/api#html-style):
 {{< command >}}
-tdl up -p ./downloads --caption  \
+tdl up -p /path/to/file --caption  \
 'FileName + `<b>Bold</b> <a href="https://example.com">Link</a>`'
 {{< /command >}}
 
@@ -79,15 +139,7 @@ func main() {
 {{< /details >}}
 
 {{< command >}}
-tdl up -p ./downloads --caption caption.txt
-{{< /command >}}
-
-## Filter
-
-Upload files except specified extensions:
-
-{{< command >}}
-tdl up -p /path/to/file -p /path/to/dir -e .so -e .tmp
+tdl up -p /path/to/file --caption caption.txt
 {{< /command >}}
 
 ## Filters

docs/content/zh/guide/upload.md

@@ -19,10 +19,70 @@ tdl up -p /path/to/file -p /path/to/dir
 
 {{< include "snippets/chat.md" >}}
 
+## 指定聊天
+
+上传到指定的聊天：
+
 {{< command >}}
 tdl up -p /path/to/file -c CHAT
 {{< /command >}}
 
+上传到论坛型聊天的指定主题：
+
+{{< command >}}
+tdl up -p /path/to/file -c CHAT --topic TOPIC_ID
+{{< /command >}}
+
+## 消息路由
+
+通过基于[表达式](/reference/expr)的消息路由，将文件上传到不同的聊天：
+
+{{< hint warning >}}
+`--to` 标志与 `-c/--chat` 和 `--topic` 标志冲突，只能使用其中一个。
+{{< /hint >}}
+
+列出所有可用字段：
+
+{{< command >}}
+tdl up -p /path/to/file --to -
+{{< /command >}}
+
+如果 MIME 包含 `video` 则上传到 `CHAT1`，否则上传到 `收藏夹`：
+
+{{< hint info >}}
+必须返回一个字符串或结构体作为目标聊天，空字符串表示上传到 `收藏夹`。
+{{< /hint >}}
+
+{{< command >}}
+tdl up -p /path/to/file \
+--to 'MIME contains "video" ? "CHAT1" : ""'
+{{< /command >}}
+
+如果 MIME 包含 `video` 则上传到 `CHAT1`，否则回复 `CHAT2` 的消息/主题 `4`：
+
+{{< command >}}
+tdl up -p /path/to/file \
+--to 'MIME contains "video" ? "CHAT1" : { Peer: "CHAT2", Thread: 4 }'
+{{< /command >}}
+
+如果表达式较复杂，可以传递文件名：
+
+{{< details "router.txt" >}}
+像使用 `switch` 一样编写表达式：
+
+```javascript
+MIME contains "video" ? "CHAT1" :
+FileExt contains ".mp3" ? "CHAT2" :
+FileName contains "chat3" > 30 ? {Peer: "CHAT3", Thread: 101} :
+""
+```
+
+{{< /details >}}
+
+{{< command >}}
+tdl up -p /path/to/file --to router.txt
+{{< /command >}}
+
 ## 自定义参数
 
 使用每个任务8个线程、4个并发任务上传：
@@ -38,17 +98,17 @@ tdl up -p /path/to/file -t 8 -l 4
 列出所有可用字段：
 
 {{< command >}}
-tdl up -p ./downloads --caption -
+tdl up -p /path/to/file --caption -
 {{< /command >}}
 
 自定义简单的标题：
 {{< command >}}
-tdl up -p ./downloads --caption 'File.Name + " - uploaded by tdl"'
+tdl up -p ./path/to/file --caption 'FileName + " - uploaded by tdl"'
 {{< /command >}}
 
 以[HTML](https://core.telegram.org/bots/api#html-style)格式编写带有样式的消息：
 {{< command >}}
-tdl up -p ./downloads --caption  \
+tdl up -p /path/to/file --caption  \
 'FileName + `<b>Bold</b> <a href="https://example.com">Link</a>`'
 {{< /command >}}
 
@@ -79,7 +139,7 @@ func main() {
 {{< /details >}}
 
 {{< command >}}
-tdl up -p ./downloads --caption caption.txt
+tdl up -p /path/to/file --caption caption.txt
 {{< /command >}}
 
 ## 过滤器