《用户手册编写规范》

索菱有限公司

用户手册编写规范

QB 版本：1.0

文件基本信息

修改历史记录

1. 目的 (1)

2. 适用范围 (1)

3. 用户（操作）手册内容 (1)

3.1. 引言 (1)

3.1.1. 编写目的 (1)

3.1.2. 定义 (1)

3.1.3. 参考资料（可选） (1)

3.1.4. 文档综述（可选） (1)

3.2. 软件概述 (1)

3.2.1. 目标 (1)

3.2.2. 功能 (1)

3.2.3. 性能（特色） (1)

3.3. 产品运行环境 (1)

3.3.1. 硬件环境 (1)

3.3.2. 支持软件 (1)

3.4. 产品安装 (2)

3.4.1. 安装条件 (2)

3.4.2. 安装步骤 (2)

3.4.3. 安装配置方法 (2)

3.5. 使用说明 (2)

3.5.1. 产品界面介绍 (2)

3.5.2. 帮助操作说明 (3)

3.5.3. 操作说明 (3)

3.6. 用户常见问题说明（可选） (3)

3.7. 热键和快捷键一览表 (3)

4. 用户手册排版规则 (3)

4.1. 封面 (3)

4.2. 目录 (3)

4.3. 一级标题 (3)

4.4. 二级标题 (3)

4.5. 三级标题 (3)

4.6. 正文 (3)

1. 目的

通过对本公司公司产品的用户（操作）手册编写进行基本规范，使用户（操作）手册的编写达到标准化。

2. 适用范围

适用于本公司各类产品用户（操作）手册的编写。

本标准指定可选内容可视产品的性质进行选择。

在产品用户（手册）的具体编写时，可不按本标准的排列方式（顺序）和相应的目录。

3. 用户（操作）手册内容

3.1. 引言

3?1?1?编写目的

阐明编写用户（操作）手册的目的，指明读者对象。

3?1?2?定义

列出用户（操作）手册中使用的专门术语的定义和缩写词的原意、适用范围。

3.1.3. 参考资料（可选）

列出有关参考资料的名称、作者、标题、发表日期、出版单位或资料来源。

3.1.

4. 文档综述（可选）

描述文档其余部分的内容和组织结构。

3.2. 软件概述

3?2?1?目标

描述产品所能达到的目标。

3?2?2?功能

描述产品的主要功能。

3?2?3?性能（特色）

描述产品的主要性能（特色）。

3?3?产品运行环境

3?3?1?硬件环境

描述软件系统运行时所需的硬件最小配置。

3?3?2?支持软件

1）.描述操作系统名称和版本号。

2） .如有数据库管理系统的话，描述数据库系统的名称及版本号。

3） .如有其它必要的支持软件的话，描述其它软件的名称及版本号。

3.4.产品安装

3?4?1?安装条件

列出该产品安装所需的软硬件环境和系统配置等前提条件和注意事项。

3.4.1.1. 硬件环境和配置要求

说明该系统对硬件及其配置的要求。

3.4.1.2. 软件环境和配置要求

说明系统对软件运行环境的要求，可包括：对操作系统、数据库、其它所需外来软件产品和配置的要求等。3.4.1.3. 安装注意事项

列出安装时需特别给予注意的一些事宜，如对软件版本的要求或对不同平台的不同的定制文件的要求等。

3?4?2?安装步骤

简要说明安装的步骤，各相关软硬件安装的顺序。

3?4?3?安装配置方法

详细说明所需各项安装的详细方法、步骤和注意事项。

3.4.3.1. 硬件环境的安装和配置（可选）

说明产品所需硬件环境的安装和配置方法及其注意事项。

3.4.3.2. 操作系统的安装和配置

说明产品所需操作系统的安装和对网络等进行配置的方法及其注意事项，如需安装补丁”也要给出安装说明和特别的提示。

3.4.3.3. 数据库系统的安装和配置（可选）

说明产品使用的数据库产品的安装和设置方法及其注意事项，如需安装补丁”也要给出安装说明和特别的提示。

3.4.3.4. 其它所需软件的安装和配置（可选）

若安装、调试或使用产品时，需要其它外来软件产品的支持，应列出其安装配置的方法和注意事项。

3.4.3.5. 项目应用软件的安装和配置

3.4.3.5.1. 应用软件的安装

详细列出该产品的安装详细步骤和注意事项，包括用户、环境、口令等等方面设置的要求，同时应说明备份保护机制。3.4.3.52 应用数据库的创建（可选）

详细描述产品应用数据库的创建、设置和初始化的步骤与方法，说明数据备份机制等需要注意的问题。

3.4.36调试与验证

为了确保安装的正确性和适用性，应作一些相应的调试和验证，应给出相应的调试与验证的方法和要求

3.5. 使用说明

3.5.1. 产品界面介绍

详细对产品界面进行描述，包括功能菜单、工具条、指令图标等。

3.5.2. 帮助操作说明

详细描述产品的在线帮助的使用方法。

3.5.3. 操作说明

1）.详细描述产品各功能的操作方法；

2） .详细描述产品所产生文件的保存方式（格式）；

3） .详细描述产品与第三方同类产品的数据交换方式。

3.6. 用户常见问题说明（可选）

详细描述对用户常见问题（由于用户操作经验和操作方法而引起的）的处理方法。

3.7. 热键和快捷键一览表

按字母顺序或按功能逐个列出热键和快捷键的名称和功能说明。

4. 用户手册排版规则

4.1. 封面

1）产品名称：X＞系统。字体为黑体、小初；

2）公司名称：杭州浙大大天信息有限公司。字体为黑体、三号；

3）出版日期：xxxx年 %＞月。字体为黑体、小四号；

4.2. 目录

1）目录，字体为黑体、三号；

2）目录列表：字体为宋体，五号。

4.3. 一级标题

第一章”字体为宋体、小一、灰色—5%底纹、加粗。

4.4. 二级标题

第一节”字体为宋体、小一、灰色—5%底纹、加粗。

4.5. 三级标题

“1.1.1” ：字体为宋体、三号、加粗。

4.6. 正文

1）提示文字：操作系统。字体为宋体、小四、加粗。

2）所有文字行距1.5倍行距。

3）段首缩进：2个字符。

4）本节要点：＞本节要点”字体为黑体、小四。

5）要点内容：“■从系统管理员处”字体为宋体、6）表格内文字：宋体、五号。

7）按钮符号：【确认】”。字体为宋体、五号。8）提示格式：

索菱测试点

导航

文件

收音机

音频小四。

提示: 止文。

宋体、五号、加粗: 宋体、五号

视频

AV文件

图片

屏幕

DVD主机

鼠标

接口

视频解码音频解码