从单个 html 文件创建的 chm 文件的搜索选项卡

Search tab of chm file created from a single html file

我从使用 asciidoctor 生成的单个 html 文件创建了一个 chm 文件。 chm 文件的内容和索引指向同一 html 文件的特定部分。但是,当我使用 search tab 时,即使所有搜索结果都在文件中突出显示,'Select topic o display' 部分仅列出了 html 文件本身的名称。有没有一种方法可以在搜索选项卡中显示 html 文件中的部分名称?

构建 CHM 帮助文件时,主题最好分成较小的单元和单独的 HTML 文件。

这样,对目录(TOC)Table的赋值就比较容易了。搜索结果一目了然,我推荐这种方法。

当然,您可以从目录跳转到锚标签(见下文)。当您执行搜索时,结果列表是一堆标题从每个文档 <title> 标签中提取的项目。据我测试,您无法更改搜索结果列表中的标题。

我记得如果启用了二进制目录,您可能会看到与相关主题似乎不对应的标题。对于二进制 TOC,主题标题是从 TOC 项目标签而不是文档 <title> 标签中提取的。我怀疑这是 HH 1.x Collections 功能。

*.hhc (TOC) 文件示例:

     <LI><OBJECT type="text/sitemap">
           <param name="Name" value="How to use shortcut links">
           <param name="Local" value="HTMLHelp_Examples/shortcut_link.htm">
         </OBJECT>
     <LI><OBJECT type="text/sitemap">
           <param name="Name" value="How to jump to a anchor">
           <param name="Local" value="HTMLHelp_Examples/Jump_to_anchor.htm#AnchorSample">
         </OBJECT>

如上所述,我建议拆分主题。