forked from PKUanonym/REKCARC-TSC-UHT
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
为大一小学期 Python 部分添加教程 (PKUanonym#140)
* add files for Python Tutorial * Update README.md
- Loading branch information
1 parent
1dcccfd
commit 0735273
Showing
16 changed files
with
47,765 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
# 审核者须知 | ||
|
||
参考技能文档的[编写者须知](https://docs.net9.org/notes/editor/),除此之外: | ||
|
||
1. 将翻译稿中出现的类似于“书中第 xx 章”的字样删去。 | ||
2. 所以示例代码必须自己完全运行,避免因为 API 过于老旧无法使用。 | ||
|
||
------ | ||
|
||
# 重要事项 | ||
|
||
**正确使用标点符号** | ||
|
||
+ 正确使用**全角**标点符号与**半角**标点符号。汉语请使用全角符号,英语请使用半角符号。 | ||
+ 请在每句话的末尾添加**句号**。 | ||
+ 正确使用**括号**。括号在句中表示对句中前一个元素的解释说明,如 `语法糖(英语:Syntactic sugar)`。括号在句外表示对前面整个句子的解释说明。 | ||
+ 正确使用**分号**,可以使得行文结构更加清晰。 | ||
|
||
**正确进行中文排版** | ||
|
||
+ **中英文之间、中文和数字之间需要增加空格,数字和单位之间不需要增加空格。** | ||
+ 行文中正文与超链接之间需要增加空格。 | ||
+ 全角字符和其他字符之间不加空格。 | ||
+ **专有名词使用正确的大小写。如使用缩写,则该缩写应已成为业界标准。** | ||
|
||
**推荐的代码风格** | ||
|
||
+ 变量使用驼峰命名法、下划线命名法等均可,但需要尽量保证同一篇文档内命名风格统一。 | ||
+ 下列代码风格惯例以 C++ 语言为例: | ||
+ 大括号换行与不换行均可,但需要保证同一篇文档内格式统一。不换行时,其与左侧的右括号之间应当有一个空格。 | ||
+ 关键字 `if`、`for` 等与后续左括号之间应当有一个空格。 | ||
+ 运算符 `+`、`-` 等与左右操作数之间应当各有一个空格,运算符 `.`、`->` 两侧均不应当有空格,逗号 `,` 左侧不应当有空格而右侧应当有空格。 | ||
+ 行内注释起始标记 `//` 与注释文字间应当有一个空格。 | ||
+ 使用 2 个空格或者 4 个空格进行缩进均可,但需要保证同一篇文档内统一。 |
Binary file not shown.
Oops, something went wrong.