不建议从标题创建目录 - 为每个主题使用单个 HTML 文件。如果您想真正使用“自动创建内容文件”,请参阅下面的信息。
请注意,HTML Help Workshop 是免费的,是一个很好的学习工具,但有点过时了——20 年了。我建议使用 FAR HTML 之类的(低价)工具来创建 CHM 帮助文件。请看Successor of / Alternative to HTML Help Workshop。
通过 HTML Help Workshop 构建目录 (TOC) 非常耗时。
如果您想了解如何创建主题文件、索引文件和内容文件,请阅读文档。例如,下面是 MSDN 上的一个子主题,描述了如何在 HTML 帮助研讨会中创建 TOC 文件:
Create a Table of Contents File
让我们看看我是否可以让这个更清楚并推荐一些步骤:
- 您创建了一组 HTML 帮助文件。每个 HTML 文件都是一个
个人帮助主题。
- 这些文件几乎可以包含 HTML 支持的任何内容。例如,这组 HTML 文件很有可能且典型地可以在 Internet Explorer 中浏览,而无需在 HTML 帮助研讨会中执行任何操作。显然还没有任何目录 (TOC) 或索引,但您将拥有一个可在任何网络浏览器中查看的基本 HTML 网站。
- HTML 文件的格式和内容完全由您决定,但它应该只包含 HTML、CSS 和可选的 JavaScript。您可以先关注 HTML,然后在发现基本的 HTML 可能还不够之后再关注 CSS。
- 然后,您将添加与相关主题之间的 HTML 超链接。 URL 都是相对的。现在,您只需单击超链接即可在 Web 浏览器中查看所有主题。使用相对 URL 将允许您将文件的整个目录结构移动到任何地方,并且链接仍然有效。
- 现在您将在前面的步骤中创建的 HTML 帮助主题文件包含到您的 HTML Help Workshop 项目中。
您知道 - 创建帮助文件 (CHM) 有一个学习曲线。从用户的角度来看,大多数工作都是好的内容。
我真正建议节省一些时间的是 Rob Chandler 的共享软件工具 FAR HTML。您可以在外部使用您喜欢的 HTML 编辑器进行任何操作,并将 FAR HTML 放入您的工作流程中,这些向导非常棒。
一个提示 - 开始时不要查看 FAR 的所有选项。
-
将您的 HTML 文件放到项目文件夹的结构化子文件夹中,例如
welcome.htm
design.css
First_Steps\download.htm
First_Steps\starting_program.htm
How_to_extend\extend_menu.htm
How_to_extend\power_function.htm
images\gui_screenshot.jpg
将这些文件拖放到 FAR
- 启动 HTMLHelp 1.x 向导,请参阅主菜单:创作 > 帮助向导
- 准备好了..
从标题创建目录(不推荐)
例如,如果一个主题文件包含以下内容:
<html>
<body>
<h1>Main Heading<h1>
...
<h2>Second-Level Heading</h2>
...
<h3>Third-Level Heading</h3>
...
</body>
</html>
然后,当您使用 HTML Help Workshop 编译并选择“自动创建内容文件”时,您应该构建一个内容文件,其中“二级标题”是“主标题”和“三级标题”的子标题Level Heading”是“Second-Level Heading”的子标题。
但是,如果另一个主题中的主标题被标记为而不是,那么这将在 TOC 层次结构中占据与上面示例中显示的标题相同的位置。因此,决定标题出现在 TOC 中的位置的因素不是它是否被标记为元素、元素或其他任何东西。相反,它是相对于同一主题文件中其他标题的标题级别。
您需要一个锚标记来从 TOC 跳转到单个 HTML 文件中的特殊子主题。 TOC(站点地图)文件,例如foobar.hhc 需要这样的部分:
<LI><OBJECT type="text/sitemap">
<param name="Name" value="How to jump to a second anchor">
<param name="Local" value="HTMLHelp_Examples/Jump_to_anchor.htm#SecondAnchor">
</OBJECT>
HTML 帮助研讨会的一些屏幕截图以及您可能想要使用的选项: