53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
|
||
# 文件创建/修改规范
|
||
|
||
## 格式
|
||
|
||
```yaml
|
||
---
|
||
tags: []
|
||
create time: YYYY-MM-DD HH:mm
|
||
---
|
||
|
||
# <标题>
|
||
|
||
## 题面
|
||
[原题题面]
|
||
|
||
## 思路
|
||
[解题思路]
|
||
|
||
## 代码提示
|
||
[伪代码提示]
|
||
|
||
## 技巧
|
||
[可使用的小技巧]
|
||
|
||
## 代码
|
||
[完整解答代码 Go语言版本]
|
||
```
|
||
|
||
## 必填项
|
||
|
||
| 字段 | 格式 | 说明 |
|
||
| ------------- | ------------------ | ------------------ |
|
||
| `tags` | 数组 | 必须存在 `[]`，智能填充相关标签 |
|
||
| `create time` | `YYYY-MM-DD HH:mm` | 当前系统时间 |
|
||
|
||
|
||
## 内容规范【IMPORTANT】
|
||
|
||
- **教学者模式**: 假设你是教学者，你需要先规划如何记录这个知识点，让读者能够容易理解。你也可以穿插问题在文档中，启发学生的思考。（建议使用 Obsidian **原生** `> [!type]` 语法）
|
||
- **图表**: 在【思路】板块，遇到关键概念、流程，仅仅靠文字不容易清晰说明，此时应该使用 Mermaid。避免使用纯文本 ASCII 图表。
|
||
- **风格**: 详略得当，注重实用性。文风严谨但是不失“活人感”，循序渐进，深入浅出。
|
||
|
||
## 附录 Mermaid 规范
|
||
|
||
"All content in the Mermaid code, especially Chinese content, MUST be enclosed exclusively in English double quotes "". Never use Chinese double quotes “” to enclose any content. "
|
||
"Inside English double quotes, no punctuation or special characters are allowed, except for the English comma ,. "
|
||
"Do not use \n for line breaks. "
|
||
"Node IDs MUST be in English. If Chinese text is required for display, it should be placed within double quotes. For example, use A["中文显示文本"] instead of 中文节点["文本"]. "
|
||
"When defining nodes with explanatory information using [], all information inside [] MUST be enclosed in double quotes, like A["Interface MethodSet"]. "
|
||
"For quadrant charts, do not use [label] for points, as this syntax format is incompatible. Points should be defined as A: [x, y]. "
|
||
"When generating requirement diagrams, replace fulfills with SATISFIES (满足) and calls with TRACES (追踪) to meet the required syntax. "
|