mirror of
				https://github.com/nonebot/nonebot2.git
				synced 2025-11-04 00:46:43 +00:00 
			
		
		
		
	📝 Docs: 升级到 Docusaurus V3 (#2956)
This commit is contained in:
		@@ -71,14 +71,14 @@ alc = Alconna(".rd{roll:int}")
 | 
			
		||||
assert alc.parse(".rd123").header["roll"] == 123
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
Bracket Header 类似 python 里的 f-string 写法,通过 "{}" 声明匹配类型
 | 
			
		||||
Bracket Header 类似 python 里的 f-string 写法,通过 `"{}"` 声明匹配类型
 | 
			
		||||
 | 
			
		||||
"{}" 中的内容为 "name:type or pat":
 | 
			
		||||
`"{}"` 中的内容为 "name:type or pat":
 | 
			
		||||
 | 
			
		||||
- "{}", "{:}" ⇔ "(.+)", 占位符
 | 
			
		||||
- "{foo}" ⇔ "(?P<foo>.+)"
 | 
			
		||||
- "{:\d+}" ⇔ "(\d+)"
 | 
			
		||||
- "{foo:int}" ⇔ "(?P<foo>\d+)",其中 "int" 部分若能转为 `BasePattern` 则读取里面的表达式
 | 
			
		||||
- `"{}"`, `"{:}"` ⇔ `"(.+)"`, 占位符
 | 
			
		||||
- `"{foo}"` ⇔ `"(?P<foo>.+)"`
 | 
			
		||||
- `"{:\d+}"` ⇔ `"(\d+)"`
 | 
			
		||||
- `"{foo:int}"` ⇔ `"(?P<foo>\d+)"`,其中 `"int"` 部分若能转为 `BasePattern` 则读取里面的表达式
 | 
			
		||||
 | 
			
		||||
## 参数声明(Args)
 | 
			
		||||
 | 
			
		||||
@@ -321,7 +321,7 @@ opt2 = Option("--foo", default=OptionResult(value=False, args={"bar": 1}))
 | 
			
		||||
- `keep_crlf`: 命令解析时是否保留换行字符
 | 
			
		||||
- `compact`: 命令是否允许第一个参数紧随头部
 | 
			
		||||
- `strict`: 命令是否严格匹配,若为 False 则未知参数将作为名为 $extra 的参数
 | 
			
		||||
- `context_style`: 命令上下文插值的风格,None 为关闭,bracket 为 {...},parentheses 为 $(...)
 | 
			
		||||
- `context_style`: 命令上下文插值的风格,None 为关闭,bracket 为 `{...}`,parentheses 为 `$(...)`
 | 
			
		||||
- `extra`: 命令的自定义额外信息
 | 
			
		||||
 | 
			
		||||
元数据一定使用 `meta=...` 形式传入:
 | 
			
		||||
 
 | 
			
		||||
@@ -96,7 +96,7 @@ class Other(Segment):
 | 
			
		||||
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
:::tips
 | 
			
		||||
:::tip
 | 
			
		||||
 | 
			
		||||
或许你注意到了 `Segment` 上有一个 `children` 属性。
 | 
			
		||||
 | 
			
		||||
@@ -291,7 +291,7 @@ msg.extend([Text("text")])
 | 
			
		||||
 | 
			
		||||
这里额外说明 `UniMessage.template` 的拓展控制符
 | 
			
		||||
 | 
			
		||||
相比 `Message`,UniMessage 对于 {:XXX} 做了另一类拓展。其能够识别例如 At(xxx, yyy) 或 Emoji(aaa, bbb)的字符串并执行
 | 
			
		||||
相比 `Message`,UniMessage 对于 `{:XXX}` 做了另一类拓展。其能够识别例如 At(xxx, yyy) 或 Emoji(aaa, bbb)的字符串并执行
 | 
			
		||||
 | 
			
		||||
以 At(...) 为例:
 | 
			
		||||
 | 
			
		||||
@@ -305,7 +305,7 @@ UniMessage(At("user", "123"))
 | 
			
		||||
UniMessage(At("user", "123"))
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
而在 `AlconnaMatcher` 中,{:XXX} 更进一步地提供了获取 `event` 和 `bot` 中的属性的功能:
 | 
			
		||||
而在 `AlconnaMatcher` 中,`{:XXX}` 更进一步地提供了获取 `event` 和 `bot` 中的属性的功能:
 | 
			
		||||
 | 
			
		||||
```python title=在AlconnaMatcher中使用通用消息段的拓展控制符
 | 
			
		||||
from arclet.alconna import Alconna, Args
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user