HTML Help Workshop - 如何将 HTML 页面中的标题 link 指向目录中的主题

Question

我正在尝试将 HTML 文档中的 link 标题添加到 HTML Help Workshop 中的目录（目录的 Table）。

例如，我有一个主标题 <h1>Settings</h1>，我想将其显示为目录中的一个文件夹。我还有一些子主题，例如 <h2>Settings Icon & Page</h2>，我想将其显示在该部分的主要主题下方。

我还想找到一种方法，一旦用户在已编译的帮助文件中单击该主题，页面就会跳转到该主题。

有人可以告诉我这是否可行以及如何解决这个问题吗？

这举例说明了我正在努力实现的目标。

Answer 1

不建议从标题创建目录 - 每个主题使用单个 HTML 文件。如果你想真正使用 "Automatically create contents file" 请参阅下面的信息。

请注意，HTML Help Workshop 是免费的，也是一个很好的学习工具，但有点过时了——已有 20 年历史了。我建议使用像 FAR HTML 这样的（低价）工具来创建 CHM 帮助文件。请看一下 Successor of / Alternative to HTML Help Workshop.

通过 HTML Help Workshop 构建 Table 内容 (TOC) 非常耗时。

如果您想了解如何创建主题文件、索引文件和内容文件，请阅读文档。例如，这里是 MSDN 上的一个子主题，它描述了如何在 HTML Help Workshop 中创建目录文件：

Create a Table of Contents File

让我们看看我是否可以更清楚地说明这一点并推荐一些步骤：

您创建了一组 HTML 帮助文件。每个 HTML 文件是一个个人帮助主题。
这些文件几乎可以包含 HTML 支持的任何内容。这组 HTML 文件很可能并且很典型地可以在 Internet Explorer 中浏览，例如，无需在 HTML Help Workshop 中执行任何操作。显然还没有 table 的内容 (TOC) 或索引，但是您将拥有一个可以在任何网络浏览器中查看的基本 HTML 网站。
HTML 文件的格式和内容完全由您决定，但它应该只包含 HTML、CSS 和可选的 JavaScript。你可以先关注HTML，等你发现基本的HTML可能还不够，再关注CSS。
然后您将添加 HTML 个超链接 to/from 个相关主题。这些 URL 都是相对的。现在您只需单击超链接即可在 Web 浏览器中查看所有主题。使用相对 URL 将允许您将文件的整个目录结构移动到任何地方，链接仍然有效。
现在您可以将在前面的步骤中创建的 HTML 帮助主题文件包含到您的 HTML Help Workshop 项目中。

您知道 - 创建帮助文件 (CHM) 有一个学习曲线。从用户的角度来看，大多数作品都是好的内容。

为了节省时间，我真正推荐的是 Rob Chandler 的共享软件工具 FAR HTML。您可以在外面用您喜欢的 HTML-Editor 做任何事情，并将 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
启动 HTML帮助向导 1.x 请参阅主菜单：创作 > 帮助向导
准备好了..

从标题创建目录（不推荐）

例如，如果一个主题文件包含以下内容：

<html>
<body>

<h1>Main Heading<h1>
...
<h2>Second-Level Heading</h2>
...
<h3>Third-Level Heading</h3>
...
</body>
</html>

然后，当您使用 HTML Help Workshop 编译并选择 "Automatically create contents file" 时，您应该构建一个内容文件，其中 "Second-Level Heading" 是 sub-heading 的 "Main Heading" 和 "Third-Level Heading" 是 "Second-Level Heading" 的 sub-heading。

但是，如果另一个主题中的主标题被标记为而非，那么这将在 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 Help Workshop 的一些屏幕截图，其中包含您可能需要使用的选项：

HTML Help Workshop - 如何将 HTML 页面中的标题 link 指向目录中的主题

HTML Help Workshop - How do I link headings in a HTML page to topics in the TOC

html

chm

html-help-workshop