-
Notifications
You must be signed in to change notification settings - Fork 20
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
base: main
Are you sure you want to change the base?
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
此 PR 应同时包括对于手册中实际内容的修改
正常的用例:`.find 火球术` | ||
错误的用例:`.find <火球术>` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
正常的用例:`.find 火球术` | |
错误的用例:`.find <火球术>` | |
正确的用例:`.find 火球术` | |
错误的用例:`.find <查询内容>` |
2. 不带有尖括号的内容是字面量,你应该原样输入这里的内容。 | ||
3. `[关键字]` 的括号 `[]` 表示此参数可以被省略。 | ||
4. `(关键字1|关键字2)` 的圆括号 `()` 搭配竖线 `|` 表示必须在所列各项中选择一个。 | ||
3. `<内容1|内容2>` 与`<内容>`类似,表示你可以写两种内容中的一种。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
3. `<内容1|内容2>` 与`<内容>`类似,表示你可以写两种内容中的一种。 | |
3. `<内容1|内容2>` 表示你应以所列出内容的其中一种替换此处内容。 |
There was a problem hiding this comment.
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]` 的方括号 `[]` 搭配竖线 `|` 表示可以在所列各项中选择一个,或不选择此项。 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
5. `[关键字1|关键字2]` 的方括号 `[]` 搭配竖线 `|` 表示可以在所列各项中选择一个,或不选择此项。 | |
5. `[字面量1|字面量2]` 的方括号 `[]` 搭配竖线 `|` 表示可以在所列各项中选择一个,或省略此项。 |
用例:对于`.name [cn|en|jp]` | ||
用法1:`.name cn` | ||
用法2:`.name en` | ||
用法3:`.name jp` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
用例:对于`.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)` 的竖线 `|` 表示必须在所列各项中选择一个,括号为范围标记,可省略 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
6. `(关键字1|关键字2)` 的竖线 `|` 表示必须在所列各项中选择一个,括号为范围标记,可省略 | |
6. `(字面量1|字面量2)` 的圆括号 `()` 搭配竖线 `|` 表示必须在所列各项中选择一个。 |
There was a problem hiding this comment.
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 (精灵|矮人|兽人) [数量]` |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
用例:对于`.namednd (精灵|矮人|兽人) [数量]` | |
用例:对于`.namednd (精灵|矮人|兽人) [<数量>]` |
No description provided.