Re: Help for Help
Re: Help for Help
- Subject: Re: Help for Help
- From: Charles Bennett <email@hidden>
- Date: Tue, 23 Oct 2001 14:26:42 -0400
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