Re: Implementing Help
Re: Implementing Help
- Subject: Re: Implementing Help
- From: Jerry Krinock <email@hidden>
- Date: Sat, 08 Apr 2006 08:12:17 -0700
- Thread-topic: Implementing Help
on 06/04/08 07:42, Nik Youdale at email@hidden wrote:
> I have been trying and trying and for the life of me can not figure
> out how to implement help in a cocoa application....
> ...has any tips on how to implement an html help system for
> a cocoa application?
Getting Apple Help to work requires several things to be set in your app,
your package, and your Help .html files. If any one of these things are
wrong, Apple Help "just doesn't work". You get no error messages, no clues
and it is very frustrating. You just have to keep checking everything out
until you find the problem. Keep trying with an open mind you will get it!
Some common pitfalls....
Info.plist must have a CFBundleHelpBookFolder string key with the name of
the Help Book folder that is in your app's Resources folder.
That folder must have ONLY ONE file with this tag in its <head>:
<META NAME="AppleTitle" content="My App's Help"
HTTP-EQUIV="Content-Style-Type">
"My App's Help" can be any name you want.
What makes this even more difficult is that sometimes, after you find and
fix the problem, Apple Help Viewer will not recognize the fix because it may
have cached the broken data somewhere and still be using it. So, if you're
SURE everything is correct and are at your wit's end, try my Bigger Hammer
Apple Help Viewer Reset Procedure:
1. Quit Apple Help Viewer.
2. Delete these two files:
~/Library/Preferences/com.apple.help
~/Library/Preferences/com.apple.helpviewer
3. Delete this folder:
~/Library/Caches/com.apple.helpui
4. To improve the likelihood of this working, log out, and to improve it
even more, restart your Macintosh.
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Cocoa-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden