我使用voodoopad创建帮助文档，如here所述。基本上我有一个运行脚本构建阶段，告诉voodoopad将我的文档导出为html。voodoopad文档被设置为在导出时运行hiutil来创建帮助索引。
在注意到我的许多帮助锚不起作用后，我将其追溯到hiutil。当我在从voodoopad导出的html上运行hiutil时，会出现一堆错误：
Zach-iMac:Desktop zach$ hiutil -a --create Help/ --file Help/Help.helpindex -1 -vvv
index.html -- Parse error: The operation couldn’t be completed. (NSXMLParserErrorDomain error 76.)
index.html -- Parse error: Error 76, Description: (null), Line: 14, Column: 8
index.html -- Finished parsing
每个文件都会重复这些错误。第14行第8列是头标签的结尾。每个文件的第一部分基本相同：
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="Content-Style-Type" content="text/css">
<meta name="AppleTitle" content="VideoBuffet Help">
<meta name="AppleIcon" content="appicon16.png">
<title>Index</title>
<meta name="Generator" content="Cocoa HTML Writer">
<meta name="CocoaVersion" content="1138.23">
<style type="text/css">
p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px 'Lucida Grande'}
</style>
</head>
<body>
这个确切的html过去在hiutil中工作得很好。自上次运行以来，我升级到了Mountain Lion和Xcode 4.5。
还有人在用hiutil吗？它对你有用吗？
最佳答案
如果在HTML文件顶部使用此序言：
并通过http://validator.w3.org/#validate_by_upload+with_options
并修复所有问题，直到验证器返回成功，它应该与hiutil 1.3一起工作。不管怎样对我来说是这样。
另见http://lists.apple.com/archives/apple-help-authoring/2012/Sep/msg00018.html