短篇小说——我不知道为什么name="Keyword"
是用来name="Name"
这里。似乎这两个属性都可用,但这没有记录。我倾向于name="Keyword"
但此时我使用name="Name"
.
您知道 - 为 HTMLHelp 文件 (CHM) 创建良好的索引非常耗时且需要大量工作。由于用户越来越多地使用全文搜索(或 Google),我很少创建复杂的索引。我使用以下带有属性的语法(站点地图片段)name="Name"
:
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Flowers">
<param name="Local" value="Garden/flowers.htm">
</OBJECT>
很久以前的事了,但我记得见过这个属性name="Keyword"
前。经过一番寻找,我的记忆又回来了。
如果您使用 HTMLHelp Workshop (HHW) 将 WinHelp 项目转换为 HTMLHelp,您将获得在索引中生成的这些属性(我再次尝试了这个旧东西)。
<LI> <OBJECT type="text/sitemap">
<param name="Keyword" value="Adresse">
<param name="Name" value="RS485-Bus durchsuchen">
<param name="Local" value="html/sens04xe.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Keyword" value="Baudrate">
<param name="Name" value="Konfiguration der PC-Schnittstelle">
<param name="Local" value="html/sens04xd.htm">
<param name="Name" value="RS485-Interface des Transmitters">
<param name="Local" value="html/sens04xh.htm">
</OBJECT>
使用 HHW 进行索引时,重复的节点信息也经常发生。当然我使用的是 FAR HTML 的功能自动规范化 HHK 文件在这种情况下会导致:
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Adresse">
<param name="Local" value="html/sens04xe.htm">
</OBJECT>
<LI> <OBJECT type="text/sitemap">
<param name="Name" value="Baudrate">
<param name="Name" value="Konfiguration der PC-Schnittstelle">
<param name="Local" value="html/sens04xd.htm">
<param name="Name" value="RS485-Interface des Transmitters">
<param name="Local" value="html/sens04xh.htm">
</OBJECT>
两个 *.hhk 变体都被编译成 CHM,没有错误。用户看不到任何差异。以下屏幕截图(FAR HTML GUI)显示了规范化后的索引编辑器对话框。仅限关键字,例如“Baudraute”分配给两个主题现在有一颗红星。在标准化之前,所有关键字都有一个红星。
当编辑由 HHW 编辑的 HHK 文件时(如上所述),您可能会看到许多带有单个弹出项目的单个文件夹。这些可以减少并简化为单个非弹出条目。您想要保留这些重复信息的唯一原因是您是否使用信息类型——这是一个从未正确完成的 HTMLHelp 1.x 功能。如果有机会,建议您始终标准化 HHK 指数。它减少了文件大小和复杂性,并且在运行时用户没有可见的变化。
我尝试在 1997 年出版的《Official Microsoft HTMLHelp Authoring Kit》一书中查找一些文档,但没有找到。
附加信息:
HTML 内嵌关键字
在 HTMLHelp 项目中,可以使用未记录的函数将索引的关键字集成为 部分中的元语句。以这种方式指定的关键字包含在已编译的帮助系统的索引中。
See: http://www.help-info.de/en/KIT/Creating_Index/create_index.htm#UndocumentedIndex http://www.help-info.de/en/KIT/Creating_Index/create_index.htm#UndocumentedIndex
<html>
<head>
<title>How one grows trees </title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="keywords" content="tree, hole">
<meta name="MS-HKWD" content="oak">
<meta name="MS-HKWD" content="beech">
<meta name="MS-HKWD" content="water">
<meta name="MS-HAID" content="botany">
<link href="../design.css" rel="stylesheet" type="text/css" />
</head>
构建器的 Sphinx 源代码 HTMLHelp
Seems name="Keyword"
在这里进行硬编码(我不会进一步深入name="Name"
cases):
https://github.com/sphinx-doc/sphinx/blob/master/sphinx/builders/htmlhelp.py https://github.com/sphinx-doc/sphinx/blob/master/sphinx/builders/htmlhelp.py