腾讯云对外发布文档规范

本文档旨在规范腾讯云所有对外文档（包括但不限于产品文档、API文档、SDK文档、白皮书文档等）的基本格式及风格。腾讯云文档书写语法为Markdown，关于Markdown的更多信息，可参考http://wowubuntu.com/markdown/

总体方针	以解决用户问题为目标，注重场景化。遵循5W1H分析法：（What）这是什么产品？（Who）针对哪些客户群体？（Why）我为什么要使用这个产品？这个产品解决什么问题？（When+Where）使用产品的具体场景是什么？（How）怎么使用这个产品？分清读者对象，按不同的类型、不同层次的读者，决定怎样适应他们的需要。
流程	参考《腾讯云文档发布流程》
文档结构	根据统一的内容框架（请参考《产品介绍页基本规范》、《产品文档页基本规范》、《API文档基本规范》）进行内容补充
基本方法论	关注一致性、准确性（上下文、文字、标点符号与图片）把可能使用的名词、缩略语都在文首列出，避免文档中出现从未见过的名词。注意标点的正确使用，截图中出现的文字与说明需保持强一致性。例子：云服务器（又称CVM、CVM实例、云服务器实例、云主机）
基本方法论	清晰、易读关注文档结构，构建易读的索引。多使用图、表，增强易懂性。同时注意图表的清晰度，规范统一的图表风格

1. 字体、颜色规范

腾讯云对外在线文档均由磐石统一编辑发布，采用Markdown编写方式。当前CSS渲染出的默认字体字号如下：

注意：除代码块内文字可更改颜色（请使用html标准颜色如red\blue等），其余规范均不可更改。

腾讯云对外离线文档统一为PDF格式，请使用Markdown编辑器编写，有形如以上的规范。

文档标题有形如下的格式规范，目录从一级开始，最多可到第三级。（三级以上的标题不符合常规阅读需求，请拆分或使用标题内的列表进行相应处理）

标题层级	显示样式	Markdown语法
第一级标题	## 第一级标题	Markdown请注意采用二级‘##’语法，对应Word字号为22.5
第二级标题	### 第二级标题	Markdown请注意采用三级‘###’语法，对应Word字号为17.5
第三级标题	#### 第三级标题	Markdown请注意采用四级‘####’语法，对应Word字号为13

内容列表有形如下的格式规范：

列表层级	显示样式
正文第一级列表	1. 列表项一 2. 列表项二
列表中的第二级列表	1. 列表项一这是一段说明 1) 二级列表项一 2) 二级列表项二
二级列表中的第三级列表	1. 列表项一这是一段说明 1) 二级列表项一这是另一段说明 A. 三级列表项1 B. 三级列表项2 2) 二级列表项二

特殊表达	表达方式	说明
强调	粗体+斜体+前后空格	非普通文字和短语或重要文字和短语的特殊标记。 `</td>`
正文中的参数、表达式或代码	内联代码	必须使用内联代码标识正文中的参数、表达式或代码。Markdown语法为 ``
代码块	文档中出现的完整代码	与正文分开，使用代码块标识。Markdown语法为``` ```
界面标志	【中文方括号】	标识 UI 上的指定内容以便识别。在【云服务器】选项卡中，点击【新建】按钮。
交叉引用/外链	超链接	多使用超链接进行文档间关系的建立。产品文档中引用的链接地址请统一直接拷贝磐石产品文档中的相对路径，/document/product/ +数字路径，例如/document/product/213/6090。
互斥参数	(圆括号 \| 和 \| 竖 \| 线)	代码中，分割线表示必须从中选择一个选项的选项集。 % data = hdfread (start \| stride \| edge)
可选参数	[英文方括号]	代码中，方括号表示完全可选的命令或参数。 ssh [-l, -q] root@10.10.10.10
变量	<箭头括号>	代码中，箭头括号表示必须替换为有效值的变量。 mount /dev/vdb1 %<%your-mountpoint>

例如：改前：对于apt-get下载源，不需要添加软件源，可以直接安装软件包。为了加速软件安装，目前系统已经在内网预先配置了Ubuntu的mirror，这个mirror是官网x86_64的完全镜像，与官网源一致。

改后：对于apt-get下载源，不需添加软件源则可直接安装软件包。为了加速软件安装，腾讯云已在内网预先配置了Ubuntu的x86_64完全镜像，与官方源一致。

*本示例仅供参考此规范中部分条款的使用说明，不保证其对客观事实的描述正确性。