Re: Help for Help
Re: Help for Help
- Subject: Re: Help for Help
- From: Jessica Kahn <email@hidden>
- Date: Tue, 23 Oct 2001 11:40:17 -0700
Hi Charles,
Thanks for writing in with your experiences. The two additional steps
you had to take should not be necessary, and point to bugs, both of
which I was unaware of. I'd really appreciate it if you'd take a moment
to file those bugs with the BugReporter. The BugReporter is also a good
place for your feedback about adding stub Help information in newly
created Project Builder projects.
Adding Help to the examples would also definitely be beneficial. I'll
put it on the list of to-dos. Believe me, we fill our days around here
with eating our own dog food, so it's not for lack of dog food
consumption that example help hasn't made it into the Appkit examples,
it's just for lack of time. :-)
Thanks again for your feedback, and thanks in advance for your bug
reports...
--Jessica
On Tuesday, October 23, 2001, at 11:26 AM, Charles Bennett wrote:
Two additional things I had to do to get Help to work..
1: I HAD to localize the help folder, so it appeared in
English.lproj/PowerGuardian Help
Just getting it to be in Resources didn't work for me.
2: I HAD to run the Apple Help Indexing Tool found in
/Developer/Documentation/Apple Help
Until then Help would not show up.
I know this belongs in the Project Builder list but
Apple really should build a default Help stub any time a project is
created,
let the developer remove it if it's not wanted..
Actually Apple should eat their own dog food and go back and add Help
to EVERY
non trivial AppKit example, I can't find a SINGLE example that includes
help..
I'd bet if they had to do that, we would have some better help tools
pronto.
The Reply-ALL crossposts.. If this thread continues, perhaps it should
go to
the cocoa list..
chuck
Jessica Kahn wrote:
Could you please take a look inside your built application to make sure
that the entire help folder has been copied into the Resources section
of the bundle?
Also, please check the permissions on that help folder, and its
contents. If it's not readable by the user running the application,
you'll have problems.
Finally, are you quitting Help Viewer before trying your application?
--Jessica
On Tuesday, October 23, 2001, at 10:44 AM, kubernan wrote:
Thx for the response .. but.. I added my help folder as you said.
In fact, i followed these instructions :
------------------
1. Launch Project Builder and choose New Project from the File menu.
2. Choose to create a Carbon or Cocoa Application, and follow along
with the Assistant to finish creation of your project.
3. Click on the Resources group in the file view.
4. From the Project menu, choose Add Files.
5. Navigate to your help book folder, click on it, and hit the Open
button.
6. Make sure the "Create Folder References for any added folders"
radio
button is selected, and hit the Add button.
7. Click on the Targets tab, and then the application's target (in the
upper left), to edit your application's target settings.
8. In the Application Settings panel, set the Identifer for your
application (to something unique, like
com.yourcompany.yourapplication).
9. Hit the Expert button to add the two custom help keys with string
values, CFBundleHelpBookFolder, and CFBundleHelpBookName. These should
be set to the name of the folder you added to your project, and the
AppleTitle defined in your main help file, respectively.
10 - <snip> (Carbon app only)
11. Cocoa applications only: Open up your MainMenu.nib and set the
title of your help menu item to the name of your application, followed
by the word "Help", with command-? as the keyboard shortcut.
12. Hit the build button. Once the build has completed, run your new
application. You should have a working help menu at this point, and
your help book should appear in the Help Center listing.
----------------
...and it appears nothing is working for me.
Other idea ?
Le mardi 23 octobre 2001, ` 06:47, Jessica Kahn a icrit :
Hi,
If you look at the built product that Project Builder produces for
you, is the entire "MyApp Help" folder in the Resources section of
your application somewhere? One of the more confusing points of
getting the help added to your application successfully is that you
need to add the "MyApp Help" folder to the Resources section of your
project as a "folder reference," and if that didn't happen right,
then
the entire folder won't be present in the built application.
--Jess
On Tuesday, October 23, 2001, at 09:13 AM, kubernan wrote:
Hello,
After reading all about how to create Help in PB project for cocoa
app. i still have a problem.
Clicking on Help menu in my application i have only the Help Center
instead of my help book.
I built a folder for my help files named : MyApp Help.
In this folder i have an index.html file with <meta
name="AppleTitle"
content="MyApp Help">
inside.
My help folder is imported in my PB project.
In info.plist i added these two keys :
CFBundleHelpBookFolder with MyApp Help
CFBundleHelpBookName with MyApp Help
Something is missing ?
Thx.
Kub.
_______________________________________________
cocoa-dev mailing list
email@hidden
http://www.lists.apple.com/mailman/listinfo/cocoa-dev
------------------------------------------
10191 Technologies (We build infernal machines, AI tools and more)
<http://www.10191.com>
_______________________________________________
cocoa-dev mailing list
email@hidden
http://www.lists.apple.com/mailman/listinfo/cocoa-dev
_______________________________________________
cocoa-dev mailing list
email@hidden
http://www.lists.apple.com/mailman/listinfo/cocoa-dev