(完整版)文档撰写规范V2.3.1

联想MS知识库文档模板规范V2.3联想MS知识库文档模板规范技术中心技术工具与知识管理处2011/12/20

通用格式要求题目部分：标题：使用黑色宋体四号字居中呈现。注：在MS知识库创建为：其他：标题和正文之间空一行，空行部分通过硬回车完成。正文部分：基本要求：全文以黑色宋体五号字，左对齐呈现。全文回车使用硬回车。分段标题：文档内分标题以黑色宋体五号字加粗，左对齐撰写。示例：适用范围：文档内分标题和上一个段落中间空一行。层级关系：正文部分如果需要用标号体现步骤和层级关系，统一使用如下示例所示的编号规则，缩进为子编号比上级编号向右两个单位，和文字中间使用半角空格。可以使用Word中的相同样式的自动编号（和文字的空格可省略）。示例：11.11.1.1图片部分：图片尺寸：横向像素数不能超过480，纵向不限。图片尽可能保证相关界面的完整性。图片清晰度：截图原图（96dpi）横向尺寸（像素数）小于或等于480的，文档中原大（不能放大）使用。截图原图横向尺寸（像素数）大于400的，优先无缩放剪裁到横向尺寸480使用。如剪裁无法保证图片信息完整，可少量等纵横比缩小使用，缩放结果横向尺寸（像素数）等于或小于480。且横向和纵向尺寸（分辨率）分别不能低于原横向和纵向尺寸（分辨率）的80%。以保证图片清晰度。图片格式：图片采用JPG或GIF格式。图片编号：插入图片编号需以阿拉伯数字标号。前后加中文圆括号，在图片下方居中。图片位置：图片在文档中居中显示。图片上下各空一行。图片内容：图片中内容强调部分请使用矩形红色框提示。图片中需隐藏部分请使用白色矩形框覆盖。图片示例：（图1）句式语法部分：语句中的英文单词中文语句中的英文单词、数字前后加中文半角空格。示例：如何清理InternetExplorer浏览器缓存？缩写规范英文缩写全部用大写表示。示例：ADSL，VPN等错误：Adsl，vpn等商品正式名称文档中出现的软件名称或产品名称全部使用全称（商品正式名称），不能使用缩写或者简写。示例：Windows7，WindowsXP，昭阳K46A等错误：Win7，winxp，k46等引用的文字正文中引用软件、硬件产品标识中的文字，需前后加双引号。示例：点击“控制面板”内容结构部分常见问题文档模板题目题目简要描述主要的问题现象，结构为“问题现象”加“的解决方案”。次要和中间环节的现象描述在题目中阐述，避免标题过长。示例：Windows7系统下ADSL自动断线的解决方案错误：Windows7系统下ADSL连接一段时间之后会自动断线的解决方案故障现象详细阐述故障现象、发生条件、所处环境等。尽量以图文并茂的形式呈现。原因分析（此项目为选填项）。对故障原因进行简单判断和分析，判断过程需要有前后递进逻辑关系。解决方案详细阐述故障解决过程，尽量图文并茂表现，步骤完整，不能有跳步现象。应具有较强的指导性。备注（此项目为选填项）主要阐述作者需要补充说明的部分。维护范例Windows7系统下ADSL自动断线的解决方案故障现象：Windows7系统下ADSL连接一段时间之后会自动断线。原因分析：（选填）可能原因为启用了“闲置自动断线功能”导致。解决方案：打开“控制面板”－“网络和Internet”－“网络和共享中心”－“更改适配器设置”。（图1）（图1）在宽带连接上点右键，选择“属性”。（图2）（图2）选择“选项－挂断前空闲时间”，设置为“从不”即可。（图3）（图3）备注：（选填）操作指导文档模板题目题目包含操作对象和本文介绍的操作方法所要达到的目的。如“InternetExplorer浏览器”为说明对象，“清理缓存”为所要达到目的。适用范围此部分主要阐述说明对象对于此文档的使用范围。如软件版本、系统环境、硬件配置、网络环境等。要点分析（此项目为选填项）。主要阐述本文操作后达到的效果，及操作过程中涉及的知识点，发生原因。操作步骤此部分阐述使说明对象达到指定目的具体实施过程，是文档最重要部分。需详细说明完整步骤。尽可能做到图文并茂，通俗易懂。备注（此项目为选填项）主要阐述作者补充说明，需单独强调和请读者留意的内容呈现。维护范例清理InternetExplorer浏览器缓存的操作方法适用范围：InternetExplorer全版本要点分析（选填）：为了提高访问网页的速度，InternetExplorer浏览器会采用累积式加速的方法，将你曾经访问的网页内容（包括图片以及cookies文件等）存放在电脑里。这个存放空间，我们就称它为IE缓存。以后我们每次访问网站时，InternetExplorer会首先搜索这个目录，如果其中已经有访问过的内容，那InternetExplorer就不必从网上下载，而直接从缓存中调出来，从而提高了访问网站的速度。操作步骤：打开InternetExplorer，选择“工具—internet选项”，切换到“高级”选项卡，找到“关闭浏览器时清空internet临时文件夹”，将其选中，点击确定即可。备注（选填）：维修案例文档模板题目题目包含故障对象和故障现象，必须指出该案例的特殊性，如问题产生的特定环境、简要的导致原因等。示例：“LenovoG460连接AC电源适配器不加电”错误：“LenovoG460不加电”涉及产品如果此案例涉及硬件产品，阐述所涉及的硬件厂商、产品型号、产品系列，要求与商品名相同，不能缩写或改写。多个产品的情况下，不同的厂商、产品型号、产品系列都独占一行；如果此案例涉及系统或软件产品，阐述此系统或软件的全称及版本号，要求与原名相同，不能缩写或改写。多个产品的情况下，不同的产品、版本单独占一行故障现象详细阐述故障现象、发生条件、所处环境等。尽量以图文并茂的形式呈现。维修过程主要呈现维修检测过程（先软后硬、先外后内、先连线后部件），可以按照检测思路按顺序撰写，尽量做到图文并茂。更换部件尽量写明部件名称、编号，替换系统、软件版本尽量写明下载地址，方便其他工程师参考。案例总结（此项目为选填项）对本案例的处理思路、解决方案进行总结阐述。维护范例LenovoG460连接AC电源适配器不加电涉及产品：LenovoG460故障现象：一台LenovoG460，主机编号CB04765039，接AC电源适配器的情况下不加电，用电池开机正常。开机状态下连接AC电源适配器自动断电。维修过程：根据用户报修问题，更换AC电源适配器测试，故障依旧。把用户电脑的AC电源适配器放在同一型号的电脑测试，开机正常。故AC电源适配器好无故障，故障源在主机部件。更换主机电源接口线测试，故障排除，所以锁定故障为电源接口线。次日更换时发现屏轴压着电源接口线导致短路，用户新购机，20天内15天外，只能选择维修，断定可能出厂时组装不到位导致，用户未维修过，维修时看见易碎贴完好。案例总结：屏轴压着电源接口线短路导致接AC电源适配器的情况下不加电，更换电源接口线解决。用户手册文档模板题目题目包含厂商名称+产品名称+“用户手册”结构，或厂商名称+产品名称+“配置”结构，产品名称使用全称（正式名称），不能使用缩写或者简写。如产品名称中可以标识出厂商，则可以不填写厂商名称适用产品填写适用的产品硬件产品，阐述所涉及的硬件厂商、产品型号，产品系列，要求与商品名相同，不能缩写或改写。多个产品的情况下，不同的厂商产品、产品型号、产品系列都独占一行。系统或软件产品，阐述此系统或软件的全称及版本号，要求与原名相同，不能缩写或改写。多个产品的情况下，不同的产品、版本单独占一行。示例：LenovoV470系列LenovoV570系列LenovoB470系列LenovoB570系列文件信息文件名称：完整文件名（包含扩展名），需与下载的附件名一致，如“V470&V570&B470&B570UserGuideV1.0(10.12.13)_web.pdf”；文件版本：大写字母V+半角空格+版本号（阿拉伯数字），如“V1.3”；文件大小：以兆（M）或字节（K）为单位，如“3.1M”；文件格式：填写文件的扩展名，如“.pdf”。备注（此项目为选填项）主要阐述作者需要补充说明的部分。维护范例LenovoV470/V570/B470/B570用户手册适用产品：LenovoV470系列LenovoV570系列LenovoB470系列LenovoB570系列文件信息：文件名称：V470&V570&B470&B570UserGuideV1.0(10.12.13)_web.pdf文件版本：V1.0文件大小：2.85M文件格式：.pdf备注（选填）：技术通报文档模板题目题目包含通报编号和通报题目，中间用半角空格分割。故障现象详细阐述故障现象、发生条件、所处环境等。尽量以图文并茂的形式呈现。解决方案详细阐述故障解决过程，尽量图文并茂表现，步骤完整，不能有跳步现象。应具有较强的指导性。适用产品填写适用的产品硬件产品，阐述所涉及的硬件厂商、产品型号，产品系列，要求与商品名相同，不能缩写或改写。多个产品的情况下，不同的厂商产品、产品型号、产品系列都独占一行。系统或软件产品，阐述此系统或软件的全称及版本号，要求与原名相同，不能缩写或改写。多个产品的情况下，不同的产品、版本单独占一行。备注（此项目为选填项）主要阐述作者需要补充说明的部分。光盘镜像文档模板题目题目包含适用厂商名称、产品名称、光盘内容概述。产品名称使用全称（商品正式名称），不能使用缩写或者简写。适用项目适用产品填写适用的产品硬件产品，阐述所涉及的硬件厂商、产品型号，产品系列，要求与商品名相同，不能缩写或改写。多个产品的情况下，不同的厂商产品、产品型号、产品系列都独占一行。系统或软件产品，阐述此系统或软件的全称及版本号，要求与原名相同，不能缩写或改写。多个产品的情况下，不同的产品、版本单独占一行。镜像内容阐述详细的光盘内容，如有多张光盘内容不同，需写明每张光盘的内容。文件信息以表格形式呈现文件名称、文件大小、备注信息。示例：文件名称大小备注备注（此项目为选填项）主要阐述作者需要补充说明的部分。维护范例ThinkStationE20Windows7Professional64bit简体中文系统恢复光盘（withoffice2010starter）使用项目：所有项目适用产品：ThinkStationE20（4219、4220、4221,、4222、4215）镜像内容：ThinkStationE20Windows7Professional64bit简体中文系统恢复光盘（withoffice2010starter）文件信息：文件名称大小备注DISK171Y7100.iso3.21GDISK289Y0840.iso4.34GDISK389Y0841.iso1.93GDISK489Y6527.iso1.15GAdditionalSoftwareRecoveryDisc（表1）备注（选填）：工具下载文档模板题目题目包含适用产品厂商名称、产品名称、附件内容和版本，之间用半角空格隔开。使用全称（商品正式名称），不能使用缩写或者简写。如产品名称中可以标识出厂商，则可以不填写厂商名称。示例：联想万全T350G7/T280G3BIOSV1.13/BMCV1.00适用产品填写适用的产品硬件产品，阐述所涉及的硬件厂商、产品型号，产品系列，要求与商品名相同，不能缩写或改写。多个产品的情况下，不同的厂商产品、产品型号、产品系列都独占一行。系统或软件产品，阐述此系统或软件的全称及版本号，要求与原名相同，不能缩写或改写。多个产品的情况下，不同的产品、版本单独占一行。示例：联想万全TR350G7Rack主机联想万全TR350G7塔式主机使用方法（此项目为选填项）详细说明使用方法，如BIOS下载，要详细描述刷新方法，尽量图文并茂。更新明细逐条阐述此版本附件的更新内容，如是初始版本，填写“无更新”。文件信息文件名称：填写完整文件名（包含扩展名），需与下载的附件名一致。BIOS版本：大写字母V+半角空格+版本号（阿拉伯数字）。文件大小：填写文件大小，以兆（M）或字节（K）为单位。备注（此项目为选填项）主要阐述作者需要补充说明的部分。维护范例联想万全T350G7/T280G3BIOSV1.13/BMCV1.00适用产品：联想万全TR350G7Rack主机联想万全TR350G7塔式主机使用方法：刷新BIOS，进入0349\\bios目录下，运行flash.bat，等待刷新结束。刷新BMC，进入0349\\bmc目录下，运行flash.bat，等待刷新结束。更新明细：无更新文件信息：文件名称：3049.rarBIOS版本：BIOSV1.13BMCV1.00文件大小：2.57M备注：该BMC只能在888-011405和888-011404上刷新，不能在低版本主板上刷新。低版本BIO