信息技术有限公司用户手册编制规范(1)

用户手册编制规范中科海鑫信息技术有限公司2004.2i版权声明《用户手册编制规范》的版权归中科海鑫信息技术有限公司所有。未经中科海鑫信息技术有限公司的书面准许，不得将本规范的任何部分以任何形式、采用任何手段(电子的或机械的，包括照相复制或录制)、或为任何目的，进行复制或扩散。(c)Copyright2000中科海鑫信息技术有限公司。版权所有，翻制必究。是中科海鑫信息技术有限公司的注册商标。Microsoft、word是MicrosoftCorporation的注册商标。Windows是MicrosoftCorporation的商标。i前言用户手册对于任何产品都是不可缺少的组成部分。一个好的产品没有一份完备的用户手册，也不能算作一个完备的产品。对于软件产品来说更是如此，没有用户手册的软件不能算产品，没有好的用户手册，就不可能算好产品。也就是说，一个好的软件产品除了具备与市场对路的思想、良好的用户界面、完备的测试之外，还必须有一本适合用户使用的用户手册。本规范手册不仅指明了软件用户手册的内容，而且规定了中科海鑫信息技术有限公司软件用户手册的统一版面、格式。本规范手册就是按本规定编写的，但由于本规范手册内容的局限性，很难以样本的形式表现软件用户手册中可能出现的各种情况，所以请大家认真阅读本规范手册的内容。我们希望中科海鑫信息技术有限公司的相关人员，能够按照本规范手册编写自己的软件用户手册，做好我们的软件产品化工作。由于时间仓促，编者水平有限，希望大家能够提出宝贵意见，以逐步完善本规范手册的内容。i阅读指南〖手册目标〗本手册主要对中科海鑫信息技术有限公司软件产品的用户手册所应包含的内容及版面格式作一个初步的统一规定。由于实际情况千变万化，本规定很难一次做到面面俱到，需要逐渐完善。〖阅读对象〗本手册是为中科海鑫信息技术有限公司的所有软件开发人员和软件用户手册编写人员所编写的。由于本手册中的格式规定部分是根据MicrosoftWindows下的Word的功能而编写的，所以中科海鑫信息技术有限公司的软件用户手册应该使用MicroSoftWord排版。〖手册构成〗本手册基本上由两部分组成：1.第1章，“关于用户手册排版格式的规定”，规定了用户手册标题及编号的格式。2.第2章，“用户手册的内容”，规定了用户手册所应包含内容较为详细的清单。另外，本手册基本上是按“用户手册格式的统一规定”编写的一个样本。〖手册约定〗本手册遵循以下约定：1.所有标题均使用黑体字。2.如果标题后跟有“〖条件〗”字样，说明该标题下正文所要求的内容是在一定条件下必须的。【注意】的意思是请读者注意那些需要注意的事项。【警告】的意思是请读者千万注意某些事项，否则将造成严重错误。i目录第1章用户手册格式规定·················································································1-1§1.1标题及编号······················································································1-1§1.1.1章标题的设置·······································································1-1§1.1.2节标题的设置·······································································1-1§1.1.3小节标题的设置····································································1-1§1.1.4项目符号和编号的设置····························································1-2§1.1.5其它编号的设置····································································1-3§1.2正文及页眉页脚的排版······································································1-4§1.2.1正文排版·············································································1-5§1.2.2版面设置·············································································1-5§1.2.2.1版面设置···································································1-5§1.2.2.2关于页眉、页脚的设置·················································1-5§1.2.2.3注意与警告································································1-5第2章用户手册的内容····················································································2-1§2.1用户手册的目标················································································2-4§2.2用户手册的内容················································································2-4§2.2.1封面···················································································2-4§2.2.2二封···················································································2-4§2.2.3版权声明·············································································2-4§2.2.4前言···················································································2-4§2.2.5阅读指南·············································································2-5§2.2.6目录····················································································2-5§2.2.7基础知识介绍〖条件〗····························································2-5§2.2.8系统安装及启动····································································2-6§2.2.9系统操作说明·······································································2-7§2.2.91CAD软件···································································2-7§2.2.92其它软件···································································2-9§2.2.10系统及数据维护··································································2-9§2.2.11例题〖条件〗····································································2-10§2.2.12各种附录·········································································2-10§2.3用户手册的风格··············································································2-111-1第1章用户手册格式的规定§1.1标题及编号一般情况下，用户手册用章、节来划分其内容，必要时还可引入小节、小小节的概念。§1.1.1章标题的设置每章的编号用阿拉伯数字表示，采用“第1章”、“第2章”、……的形式表示章的编号，章的编号后面空一个半角的格，然后是这一章的标题。1.章必须另起一页开始打印。2.章的编号和标题采用左对齐的格式放在行的左边，左缩进为0。3.章的编号和标题中汉字采用黑体小三号字，章的编号和标题总长度不能超过一行。4.章的编号和标题行距取最小值、12磅，段前、段后分别取24磅。§1.1.2节标题的设置节的编号格式为“§x.y”。其中，x为章的号码，y为节的号码，用阿拉伯数字表示。节的编号后面空一个半角的格，然后是这一节的标题。1.原则上每一节另起一页开始打印，但对于每章的第一节，如果章标题下无说明文字，可以将其与章标题放于一页之中。2.节的编号和标题采用左对齐的格式放在行的左边，左缩进为0。3.节的编号和标题中汉字采用黑体四号字，节的编号和标题总长度不能超过一行。4.节的编号和标题行距取最小值、12磅，对于与章标题处于同页的要将其段前、段后均取12磅，否则段前取24磅、段后取12磅。§1.1.3小节标题的设置小节的编号格式为“§x.y.z”。其中x为章的号码，y为节的号码，z为小节号码，用阿拉伯数字表示。小节的编号后面空一个半角的格，然后是这一小节的标题。用户手册编制规范1-21.小节不必另起一页开始打印。2.小节的编号和标题采用左对齐的格式放在行的左边，左缩进0.74CM。3.小节的编号和标题中汉字采用黑体小四号字，小节的编号和标题总长度不能超过一行。4.小节的编号和标题行距取最小值、12磅，段前取12磅。【注意】1.如果有必要，还可以在小节下面划分更小的节，我们暂且称之为小小节。2.对于小小节的各种规定与小节一致，为保持版面清晰，小小节不再相对于小节向右缩进。3.在用户手册中，系统提示信息采用幼圆五号字，其余所有的数字及字母采用Arial字体，字号与相应的汉字相同。在本规范中提到的字体如无特殊注明，均指汉字字体。4.用户手册中，行距均取最小值、12磅。§1.1.4项目符号和编号的设置在章、节、小节、小小节里面均可以含有项目符号和编号。1.编号1)编号序列相对于与之对应的标题向右缩进0.74CM。2)编号的格式是“n.”，其中n为阿拉伯数字。3)对于有名编号序列名称采用五号黑体汉字，其后面的内容采用五号宋体汉字；对于无名编号序列中的内容字体同有名编号序列。4)编号序列里还允许采用二级编号序列，其格式规定如下：“n)”，其中n为阿拉伯数字。5)二级编号相对于与之对应的一级编号向右缩进0.74CM。6)其它规定和一级编号序列一致。7)编号