帮助文档制作简介

龚建政帮助文档的制作简介目前，MFC中常用的帮助文档有.HLP和.CHM这两种格式。下面简单介绍一下使用MicrosoftHelpWorkshop制作.HLP的过程。帮助文档的制作简介MicrosoftHelpWorkshop是一款专业的制作HLP文件的软件。HCW.exe在*:\ProgramFiles\MicrosoftVisualStudio\Common\Tools文件夹中，也可以通过单击开始→MicrosoftVisualC++6.0→MicrosoftVisualC++6.0Tools→HelpWorkshop.exe打开。帮助文档的制作简介由于帮助文件的文本内容包含了一些如脚注、隐藏文本等特殊格式，甚至还必须放入图片，RTF文件格式正好可以针对不同的文本设置上述特殊格式，因此编辑帮助文件文本内容时必须存成RTF文件格式。在介绍HCW之前，先了解一下RTF文件的编辑。帮助文档的制作简介1．另存为RTF格式的文档由于只有RTF格式的文件能够制作成帮助文件，因此帮助文件的文本格式为Word文档形式，需要保存为RTF文档的格式，然后再进行编辑。打开Word格式的文档，在“文件”菜单中选择“另存为”命令，弹出“另存为”对话框，在“保存类型”下拉列表框中选择“RTF格式（*.rtf）”，然后在选择完文件的保存路径之后保存RTF格式的文件。帮助文档的制作简介2．编辑文本标题打开RTF格式的文档，按照Word排版的格式给文档排版，如设置文档的一级、二级标题，设置字体的大小、颜色等。帮助文档的制作简介3.设置分页在HLP文件中的每一页在RTF文件中对应为每一个主题，为了分开每个主题，我们把它们之间用分页符分开。和Word编辑普通文档一样，只要中“插入”菜单中选择“分隔符”并在弹出的小窗口中选择“分页符即可（一般Word的默认选择就是“分页符”）。快捷键：Ctrl+Enter帮助文档的制作简介4.设置脚注对每一个主题，我们需要在其开头设置脚注。在“插入”菜单中选择“脚注与尾注”，会弹出一个对话框，从“插入”项中选择“脚注”、在“编号方式”项中选择“自定义标记”并在后面的文本框中输入你想插入的脚注标记，按下确定后就在脚注后输入脚注内容。帮助文档的制作简介不同的脚注代表不同的意义，常用的脚注标记及意义如下：1、#脚注：上下文字符串脚注，用于唯一的标识一个主题，相当于ID号。2、$脚注：标题脚注，用于定义主题的题目，该题目将显示在历史列表和书签中代表该主题。3、K脚注：关键字脚注，用于定义主题的关键字，该关键字将出现在索引列表中代表该主题。4、+脚注：浏览顺序脚注，用于定义主题的浏览顺序号，每一主题浏览的前后顺序将根据它区分。帮助文档的制作简介5.设置热点在HLP中，可以看到带下划线或点划线的绿色文字，我们称之为“热点”。通过鼠标点击“热点”可以跳转到相应的主题或弹出相应的主题。在编写主题文件时使用三种特特殊格式的字符定义“热点”，它们为：带双下划线的正文为跳转“热点”；带下划线的正文为弹出“热点”；隐藏正文紧跟在带双下划线的正文或带下划线的正文之后，用于指定相应的跳转或弹出的目标主题的上下文字符串。在Word的“格式”菜单下的“字体”选项中可以选择这些特殊格式。帮助文档的制作简介至此我们的RTF文件基本已经完成，但离完整HLP帮助文件的建立还只是走了一半的路。在编写完主题文件后，还需要通过HelpWorkshop创建工程文件。帮助文档的制作简介打开HCW后，可以看到如下界面：这是英文原版的，如果觉得有必要，也可以搜索下载汉化版。帮助文档的制作简介选择“File”菜单中的“New”命令。在对话框中选择“HelpProject”，单击“OK”按钮，在弹出的对话框中输入.hpj文件的文件名（本节中以DEMO.hpj为例），同时选择保存文件的位置，单击“保存”按钮保存.hpj文件，随后弹出如图所示的“DEMO.hpj”窗口。帮助文档的制作简介帮助文档的制作简介单击右边的“Options”按钮，在弹出的对话框中我们可以设置文件的属性。包括文件标题、压缩率、排序、各种文件信息、搜索支持、宏定义、字体信息等等。帮助文档的制作简介单击“Files”按钮，加入需要编译的RTF文件，注意软件只支持导入RTF文件。帮助文档的制作简介单击“窗口（Windows…）”按钮，在弹出对话框中设置窗口名称和窗口属性。以下的按钮分别是：“位图（Bitmaps…）”、“映射（Maps…）”、“别名（Alias…）”、“设置（Config…）”、“数据文件（DataFiles…）”，如有需要可以一一设置。帮助文档的制作简介然后建立目录文件，“File”→“New”，选择“HelpContents”，“OK”。帮助文档的制作简介在如图所示的窗口中的“Defaultfilename”文本框中输入“DEMO.HLP”，在“Defaulttitle”文本框中输入“帮助文档DEMO”。帮助文档的制作简介单击“AddAbove…”，弹出如下窗口：帮助文档的制作简介先选择“Heading”，添加几个标题帮助文档的制作简介添加完标题后，在每个标题下添加相应的主题。标题下也可以添加下一级标题。选中“标题1”，单击“AddBelow…”，在“TopicID”文本框中输入该主题项目所对应RTF文件中的脚注标号。帮助文档的制作简介按照以上步骤设计完成的标题和主题项目，完成设置之后即可选择“File”菜单中的“SaveAs”命令，将这个设置好的结构存储为一个帮助主题文件DEMO.cnt。帮助文档的制作简介返回hpj文件的窗口，将制作完成的帮助主题文件DEMO.cnt添加到如图所示的“Options”对话框“Files”页面下的“Contentsfile”文本框中。帮助文档的制作简介单击主窗口下面的“SaveandCompile”按钮，或单击，HelpWorkshop程序会自动保存帮助工程文件，并且同时将此工程文件编译成“帮助文档DEMO.hlp”帮助文件。帮助文档的制作简介VC中调用HLP文件将编译得到的.hlp文件和.cnt目录拷贝到工程目录和Debug文件夹下，添加“查看帮助”的消息函数响应：ShellExecute(NULL,open,HCW.hlp,NULL,NULL,SW_SHOWNORMAL);完成！帮助文档的制作简介ShellExecute的功能是运行一个外部程序（或者是打开一个已注册的文件、打开一个目录、打印一个文件等等），并对外部程序有一定的控制。ShellExecute函数原型及参数含义如下：ShellExecute(HWNDhwnd,//父窗口句柄（如：NULL，Handle等）LPCSTRlpOperation,//操作类型（如：open）*要加英文双引号LPCSTRlpFile,//要进行操作的文件或路径LPCSTRlpParameters,//当lpOperation为“explore”时指定要传递的参数，通常设为NULLLPCSTRlpDirectory,//指定默认目录，通常设为NULLINTnShowCmd//文件打开的方式，以通常方式还是最大化或最小化显示，一般为SW_SHOWNORMAL)帮助文档的制作简介