【问题标题】:HTML Help Workshop - How do I link headings in a HTML page to topics in the TOCHTML 帮助研讨会 - 如何将 HTML 页面中的标题链接到 TOC 中的主题
【发布时间】:2017-10-25 21:47:16
【问题描述】:

我正在尝试将 HTML 文档中的标题链接到 HTML 帮助研讨会中的 TOC(目录)。

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

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

如果可行,请告诉我如何解决这个问题?

这提供了一个我想要实现的示例。

【问题讨论】:

    标签: html chm html-help-workshop


    【解决方案1】:

    不建议从标题创建目录 - 为每个主题使用单个 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

    让我们看看我是否可以让这个更清楚并推荐一些步骤:

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

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

    我真正建议节省一些时间的是 Rob Chandler 的共享软件工具 FAR HTML。您可以在外部使用您喜欢的 HTML 编辑器进行任何操作,并将 FAR HTML 放入您的工作流程中,这些向导非常棒。

    一个提示 - 开始时不要查看 FAR 的所有选项。

    1. 将您的 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
      
    2. 将这些文件拖放到 FAR

    3. 启动 HTMLHelp 1.x 向导,请参阅主菜单:创作 > 帮助向导
    4. 准备好了..

    从标题创建目录(不推荐)

    例如,如果一个主题文件包含以下内容:

    <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(站点地图)文件,例如foob​​ar.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 帮助研讨会的一些屏幕截图以及您可能想要使用的选项:

    【讨论】:

    • 一如既往地感谢您的帮助,您提供的信息非常丰富! +1
    猜你喜欢
    • 1970-01-01
    • 2010-12-29
    • 1970-01-01
    • 2017-10-15
    • 1970-01-01
    • 2010-09-12
    • 1970-01-01
    • 1970-01-01
    • 2021-07-20
    相关资源
    最近更新 更多