Skip to content

Commit

Permalink
Add References
Browse files Browse the repository at this point in the history
  • Loading branch information
c4yg70 committed Apr 2, 2019
1 parent a632ddd commit 60c3f9f
Show file tree
Hide file tree
Showing 31 changed files with 2,366 additions and 62 deletions.
6 changes: 5 additions & 1 deletion OneMinute/BasicComponents.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,8 @@
# BasicComponets
# 基本组件设置

## 一行代码登录SEU-Wlan
curl -3 'https://w.seu.edu.cn/portal/login.php' -d 'username=your_username' -d 'password=your_password'

## Nginx
Set Nginx Installed by a Prebuilt CentOS/RHEL Package from the OS Repository
```
Expand Down Expand Up @@ -37,6 +40,7 @@ Start the Nginx
```
$ service nginx start
```

### Nginx容器
重载配置
```
Expand Down
228 changes: 220 additions & 8 deletions Reference/SEUITEDocReference.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,15 +3,15 @@
本规范适用于所有SEUITE文档,若文档内有特殊要求,以文档内为准

## RFC2119
关键字"必须","禁止","被要求","应当","不应","推荐","可以","可选"均遵循[RFC 2119](http://tools.ietf.org/html/rfc2119)要求,我们对原文进行了翻译和本地化,你可以在[RFC2119中文译本](/Reference/RFC2119)中找到相关内容
关键字"必须","禁止","被要求","应当","不应","推荐","可以","可选"均遵循 [RFC 2119](http://tools.ietf.org/html/rfc2119) 要求,我们对原文进行了翻译和本地化,你可以在 [RFC2119中文译本](/Reference/RFC2119) 中找到相关内容

### SEUITE对RFC2119使用的解释

在SEUITE文档中,原目录中关键字 "SHALL" 与 "SHALL NOT" 无中文对应译名,故在SEUITE文档中舍弃不用

## 写作风格

SEUITE 使用微软写作格式指南中推荐的方式写作,具体参见[Microsoft Style Guide](https://docs.microsoft.com/en-us/style-guide/welcome/)
SEUITE 使用微软写作格式指南中推荐的方式写作,具体参见 [Microsoft Style Guide](https://docs.microsoft.com/en-us/style-guide/welcome/)

## 文件名

Expand All @@ -21,18 +21,218 @@ SEUITE 使用微软写作格式指南中推荐的方式写作,具体参见[Mic

## 标点符号

**可以**参考国家标准GB/T 15834-2011《标点符号用法》
**可以**参考国家标准 GB/T 15834-2011《标点符号用法》

### SEUITE对标点符号使用的要求

- 以下标点符号**必须**使用半角符号
- 单引号 ' 和双引号 "
- 中括号 [ ]
- 以下标点符号**必须**使用半角符号
- 单引号 ' 和双引号 "
- 中括号 [ ]
- 空格
- 标点符号之间不应加上空格
- 同一内容块中的同一标点符号应格式一致
- 如需使用中文引号,请以 "「" 和 "」" 表示
- 标点符号之间不应加上空格
- 全角和半角字符间应加入空格
- 同一内容块中的同一标点符号应格式一致
- 代码块中**禁止**使用全角符号

# 文本

## 字间距

(1)全角中文字符与半角英文字符之间,应有一个半角空格。

```
错误:本文介绍如何快速启动Windows系统。
正确:本文介绍如何快速启动 Windows 系统。
```

(2)全角中文字符与半角阿拉伯数字之间,有没有半角空格都可,但必须保证风格统一,不能两种风格混杂。

```
正确:2011年5月15日,我订购了5台笔记本电脑与10台平板电脑。
正确:2011 年 5 月 15 日,我订购了 5 台笔记本电脑与 10 台平板电脑。
```

半角的百分号,视同阿拉伯数字。

```
正确:今年我国经济增长率是6.5%。
正确:今年我国经济增长率是 6.5%。
```

(3)英文单位若不翻译,单位前的阿拉伯数字与单位间不留空格。

```
错误:一部容量为 16 GB 的智能手机
正确:一部容量为 16GB 的智能手机
```

(4)半角英文字符和半角阿拉伯数字,与全角标点符号之间不留空格。

```
错误:他的电脑是 MacBook Air 。
正确:他的电脑是 MacBook Air。
```

## 句子

(1)避免使用长句。

不包含任何标点符号的单个句子,或者以逗号分隔的句子构件,长度尽量保持在 20 个字以内;20~29 个字的句子,可以接受;30~39 个字的句子,语义必须明确,才能接受;多于 40 个字的句子,任何情况下都不能接受。

```
错误:本产品适用于从由一台服务器进行动作控制的单一节点结构到由多台服务器进行动作控制的并行处理程序结构等多种体系结构。
正确:本产品适用于多种体系结构。无论是由一台服务器(单一节点结构),还是由多台服务器(并行处理结构)进行动作控制,均可以使用本产品。
```

逗号分割的长句,总长度不应该超过 100 字或者正文的 3 行。

(2)尽量使用简单句和并列句,避免使用复合句。

```
并列句:他昨天生病了,没有参加会议。
复合句:那个昨天生病的人没有参加会议。
```

(3)同样一个意思,尽量使用肯定句表达,不使用否定句表达。

```
错误:请确认没有接通装置的电源。
正确:请确认装置的电源已关闭。
```

(4)避免使用双重否定句。

```
错误:没有删除权限的用户,不能删除此文件。
正确:用户必须拥有删除权限,才能删除此文件。
```

## 写作风格

(1)尽量不使用被动语态,改为使用主动语态。

```
错误:假如此软件尚未被安装,
正确:假如尚未安装这个软件,
```

(2)不使用非正式的语言风格。

```
错误:Lady Gaga 的演唱会真是酷毙了,从没看过这么给力的表演!!!
正确:无法参加本次活动,我深感遗憾。
```

(3)不使用冷僻、生造或者文言文的词语,而要使用现代汉语的常用表达方式。

```
错误:这是唯二的快速启动的方法。
正确:这是仅有的两种快速启动的方法。
```

(4)用对“的”、“地”、“得”。

```
她露出了开心的笑容。
(形容词+的+名词)
她开心地笑了。
(副词+地+动词)
她笑得很开心。
(动词+得+副词)
```

(5)使用代词时(比如“其”、“该”、“此”、“这”等词),必须明确指代的内容,保证只有一个含义。

```
错误:从管理系统可以监视中继系统和受其直接控制的分配系统。
正确:从管理系统可以监视两个系统:中继系统和受中继系统直接控制的分配系统。
```

(6)名词前不要使用过多的形容词。

```
错误:此设备的使用必须在接受过本公司举办的正式的设备培训的技师的指导下进行。
正确:此设备必须在技师的指导下使用,且指导技师必须接受过由本公司举办的正式设备培训。
```

## 英文处理

(1)英文原文如果使用了复数形式,翻译成中文时,应该将其还原为单数形式。

```
英文:⋯information stored in random access memory (RAMs)⋯
中文:……存储在随机存取存储器(RAM)里的信息……
```

(2)外文缩写可以使用半角圆点(`.`)表示缩写。

```
U.S.A.
Apple, Inc.
```

(3)表示中文时,英文省略号(``)应改为中文省略号(`……`)。

```
英文:5 minutes later⋯
中文:5 分钟过去了⋯⋯
```

(4)英文书名或电影名改用中文表达时,双引号应改为书名号。

```
英文:He published an article entitled "The Future of the Aviation".
中文:他发表了一篇名为《航空业的未来》的文章。
```

(5)第一次出现英文词汇时,在括号中给出中文标注。此后再次出现时,直接使用英文缩写即可。

```
IOC(International Olympic Committee,国际奥林匹克委员会)。这样定义后,便可以直接使用“IOC”了。
```

(6)专有名词中每个词第一个字母均应大写,非专有名词则不需要大写。

```
“American Association of Physicists in Medicine”(美国医学物理学家协会)是专有名词,需要大写。
“online transaction processing”(在线事务处理)不是专有名词,不应大写。
```

## 数值范围

表示数值范围时,用``连接。参见《标点符号》一节的“连接号”部分。

带有单位或百分号时,两个数字都要加上单位或百分号,不能只加后面一个。

```
错误:132~234kg
正确:132kg~234kg
错误:67~89%
正确:67%~89%
```

## 代码规范

https://google.github.io/styleguide/
Expand All @@ -52,3 +252,15 @@ SEUITE的版本管理遵照[SemVer2.0](http://semver.org/)要求进行,我们
- Alpha版(内部测试版):一般只在软件开发组织内部运行,不对外公开。主要是开发者自己对产品进行测试,检查产品是否存在缺陷、错误,验证产品功能与说明书、用户手册是否一致。  
- Beta版(外部测试版):非正式版本,免费发送给具有典型性的用户,让用户测试该软件的不足之处及存在问题,以便在正式发行前进一步改进和完善。该版本一般可通过Internet免费下载。  
- Demo版(演示版):演示正式软件的部分功能的非正式版本,用户可以从中得知软件的基本操作,该版本一般可通过Internet免费下载。        

# 参考链接

- [产品手册中文写作规范](http://wenku.baidu.com/view/23cc1a6527d3240c8447efbf.html), by 华为
- [写作规范和格式规范](http://docs.daocloud.io/write-docs/format), by DaoCloud
- [技术写作技巧在日汉翻译中的应用](http://www.hitachi-tc.co.jp/company/thesis/thesis.pdf), by 刘方
- [简体中文规范指南](https://www.lengoo.de/documents/styleguides/lengoo_styleguide_ZH.pdf), by lengoo
- [文档风格指南](https://open.leancloud.cn/copywriting-style-guide.html), by LeanCloud
- [豌豆荚文案风格指南](https://docs.google.com/document/d/1R8lMCPf6zCD5KEA8ekZ5knK77iw9J-vJ6vEopPemqZM/edit), by 豌豆荚
- [中文文案排版指北](https://github.com/sparanoid/chinese-copywriting-guidelines), by sparanoid
- [为什么文件名要小写?](http://www.ruanyifeng.com/blog/2017/02/filename-should-be-lowercase.html), by 阮一峰

16 changes: 16 additions & 0 deletions Templates/Bug 提交.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
## 问题

> 描述问题
> (截图)
## 重新步骤

> 描述重现步骤
1.
2.
3.

## 运行环境

> 机型、操作系统
20 changes: 20 additions & 0 deletions Templates/Bugs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
## 基本环境

* 浏览器:
* 操作系统:
* 访问链接:

## 问题描述

* 现象:
* 问题:

## 重现步骤

1.
2.
3.

## 预期效果

* 正常现象:
Loading

0 comments on commit 60c3f9f

Please sign in to comment.