2012-09-18 4 views
3

J'utilise Voodoopad pour créer mes documents d'aide, comme décrit here. Fondamentalement, j'ai une phase de construction de script Run qui dit à Voodoopad d'exporter mon document en HTML. Le doc Voodoopad est défini pour exécuter hiutil pour créer l'index d'aide lors de l'exportation. Après avoir remarqué que beaucoup de mes ancres d'aide ne fonctionnaient pas, je l'ai retracé à hiutil. Quand je lance hiutil sur le html exporté de VoodooPad, je reçois un tas d'erreurs:hiutil ne pas indexer correctement dans Mountain Lion?

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 

Ces erreurs sont répétées pour chaque fichier. La ligne 14, colonne 8 est la fermeture de l'étiquette de tête. La première partie de chaque fichier est fondamentalement le même:

<!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> 

Ce code HTML exact utilisé pour travailler très bien avec hiutil. Depuis la dernière fois que j'ai couru cela j'ai mis à jour vers Mountain Lion et Xcode 4.5.

Est-ce que quelqu'un d'autre utilise hiutil, et cela fonctionne-t-il pour vous?

Répondre

3

Si vous utilisez ce prologue en haut de votre fichier 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" >

et exécuter votre code HTML grâce à un validateur comme http://validator.w3.org/#validate_by_upload+with_options

et de résoudre tous les problèmes jusqu'à ce que le validateur renvoie le succès, il devrait fonctionner avec hiutil 1.3. Cela a fait pour moi de toute façon.

Voir aussi http://lists.apple.com/archives/apple-help-authoring/2012/Sep/msg00018.html

+0

Oui, je vois maintenant que le balisage exporté à partir VoodooPad n'a pas été valide. Changer le doctype en XHML 1.0 comme vous l'avez dit, et corriger quelques erreurs dans le balisage exporté a fait l'affaire. Merci d'avoir répondu! – zpasternack

1

Ce n'est pas une bonne réponse, mais ma solution consiste à utiliser la version de hiutil fournie avec Lion (1.2) pour créer mon index d'aide. Je ne suis pas très content de ça, mais ça ira pour le moment. Si quelqu'un a ce problème, et veut apprendre à le faire, vous pouvez read my blog post about it.

Mise à jour: posté rdar://12326432

Mise à jour: Je l'ai entendu d'Apple c'est un double de bug # 11981648 (ce qui est encore ouvert à ce moment).