Question

我正在尝试将HTML文档中的标题链接到HTML Help Workshop中的TOC（目录）。

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

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

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

这给出了我想要实现的一个例子。

Answer 1

不建议从标题创建TOC - 为每个主题使用单个HTML文件。如果您想真正使用“自动创建内容文件”，请参阅以下信息。

请注意，HTML Help Workshop是免费的，是一个很好的学习工具，但有点过时 - 二十年前。我建议使用像FAR HTML这样的（低价）工具来创建CHM帮助文件。请查看Successor of / Alternative to HTML Help Workshop。

通过HTML Help Workshop构建目录（TOC）非常耗时。

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

Create a Table of Contents File

让我们看看我是否可以更清楚地推荐一些步骤：

您可以创建一组HTML帮助文件。每个HTML文件都是个人帮助主题。
文件几乎可以包含HTML支持的任何内容。例如，在HTML帮助研讨会中没有做任何事情，这一组HTML文件很可能在Internet Explorer中可浏览。显然，目前还没有任何目录（TOC）或索引，但您将拥有一个可在任何Web浏览器中查看的基本HTML网站。
HTML文件的格式和内容完全取决于您，但它应该只包含HTML，CSS和可选的JavaScript。在您发现基本HTML可能不够之后，您可以先关注HTML，然后再关注CSS。
然后，您将向相关主题添加HTML超链接。这些网址都是相对的。现在，您只需单击超链接即可在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
启动HTMLHelp 1.x向导，请参阅主菜单：创作＆gt;帮助向导
准备好了......

从标题创建TOC （不推荐）

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

<html>
<body>

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

然后，当您使用HTML Help Workshop编译并选择“自动创建内容文件”时，您应该构建一个内容文件，其中“二级标题”是“主标题”和“第三个标题”的子标题“标题标题”是“二级标题”的子标题。

如果另一个主题中的主标题被标记为而不是，那么这将占用TOC层次结构中与上面示例中显示的标题相同的位置。因此，确定标题在TOC中出现的位置的因素不是它是否被标记为元素，元素或其他;相反，它是相对于同一主题文件中其他标题的标题级别。

您需要一个锚标记，用于从单个HTML文件中的TOC跳转到特殊子主题。 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页面中的标题链接到TOC中的主题

1 个答案: