Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

imp: 以新的语法规则优化了指令描述,并带上了用例 #209

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

fy0
Copy link
Member

@fy0 fy0 commented Jun 21, 2024

No description provided.

Copy link
Member

@Xiangze-Li Xiangze-Li left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

此 PR 应同时包括对于手册中实际内容的修改

Comment on lines 88 to 89
正常的用例:`.find 火球术`
错误的用例:`.find <火球术>`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
正常的用例:`.find 火球术`
错误的用例:`.find <火球术>`
正确的用例:`.find 火球术`
错误的用例:`.find <查询内容>`

2. 不带有尖括号的内容是字面量,你应该原样输入这里的内容。
3. `[关键字]` 的括号 `[]` 表示此参数可以被省略。
4. `(关键字1|关键字2)` 的圆括号 `()` 搭配竖线 `|` 表示必须在所列各项中选择一个。
3. `<内容1|内容2>` 与`<内容>`类似,表示你可以写两种内容中的一种。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
3. `<内容1|内容2>` `<内容>`类似,表示你可以写两种内容中的一种
3. `<内容1|内容2>` 表示你应以所列出内容的其中一种替换此处内容

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

point:这种写法显然不局限于两个选项,<A|B|C> 也应被视为合法的多选一替换内容

用例:对于 `.log on [<日志名>]`
这是可以的:`.log on` // 继续记录当前的日志
这也是可以的:`.log on 去年6月5日下午4点04开跑的团` // 继续记录指定的日志

5. `[关键字1|关键字2]` 的方括号 `[]` 搭配竖线 `|` 表示可以在所列各项中选择一个,或不选择此项。
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
5. `[关键字1|关键字2]` 的方括号 `[]` 搭配竖线 `|` 表示可以在所列各项中选择一个,或不选择此项
5. `[字面量1|字面量2]` 的方括号 `[]` 搭配竖线 `|` 表示可以在所列各项中选择一个,或省略此项

Comment on lines +103 to +106
用例:对于`.name [cn|en|jp]`
用法1:`.name cn`
用法2:`.name en`
用法3:`.name jp`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
用例:对于`.name [cn|en|jp]`
用法1:`.name cn`
用法2:`.name en`
用法3:`.name jp`
用例:对于`.name [cn|en|jp]`
用法1:`.name cn`
用法2:`.name en`
用法3:`.name jp`
用法4:`.name`
错误用法:`.name kr`

用法2:`.name en`
用法3:`.name jp`

6. `(关键字1|关键字2)` 的竖线 `|` 表示必须在所列各项中选择一个,括号为范围标记,可省略
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
6. `(关键字1|关键字2)` 的竖线 `|` 表示必须在所列各项中选择一个,括号为范围标记,可省略
6. `(字面量1|字面量2)` 的圆括号 `()` 搭配竖线 `|` 表示必须在所列各项中选择一个

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

圆括号不省略是常态,省略是特例

用法3:`.name jp`

6. `(关键字1|关键字2)` 的竖线 `|` 表示必须在所列各项中选择一个,括号为范围标记,可省略
用例:对于`.namednd (精灵|矮人|兽人) [数量]`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
用例:对于`.namednd (精灵|矮人|兽人) [数量]`
用例:对于`.namednd (精灵|矮人|兽人) [<数量>]`

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants