3

こちら で説明されているように、Voodoopad を使用してヘルプ ドキュメントを作成しています。基本的に、Voodoopad にドキュメントを html としてエクスポートするように指示する Run Script ビルド フェーズがあります。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 は head タグの終了です。すべてのファイルの最初の部分は基本的に同じです。

<!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を使用していますか?それはあなたのために働いていますか?

4

2 に答える 2

3

このプロローグを HTML ファイルの先頭で使用する場合:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http ://www.w3.org/1999/xhtml">

http://validator.w3.org/#validate_by_upload+with_optionsのようなバリデーターを介して HTML を実行します。

バリデーターが成功を返すまですべての問題を修正します。hiutil 1.3 で動作するはずです。とにかくそれは私のためにしました。

http://lists.apple.com/archives/apple-help-authoring/2012/Sep/msg00018.htmlも参照してください。

于 2012-11-09T14:14:29.647 に答える
1

適切な答えではありませんが、私の回避策は、Lion (1.2) に同梱されているバージョンの hiutil を使用してヘルプ インデックスを作成することです。

私はこれにあまり満足していませんが、今のところそれで十分です。誰かがこの問題を抱えていて、その方法を知りたい場合は、それに関する私のブログ投稿を読むことができます。

更新: 投稿されたrdar://12326432

更新: Apple から聞いたところ、これはバグ #11981648 (現時点ではまだ未解決) の重複です。

于 2012-09-19T04:43:13.840 に答える