Apple Help development

Apple hardware/software and related topics.
Forum rules
Any posts concerning pirated software or offering to buy/sell/trade commercial software are subject to removal.
User avatar
porter
Posts: 2917
Joined: Wed Nov 01, 2006 11:37 pm
Location: NZ

Apple Help development

Unread postby porter » Mon Mar 29, 2010 1:26 pm

Does any one have any experience creating Apple Help Books?

It looks like a pile of crap to me.

I can create the HTML viewable by Safari no problem, but try as I may I can't arrange it into a book recognized by Apple Help Viewer. Eg I have a directory XXXX.help/Contents/Resources and the various xxxx.plist files. Even if I take an Apple provided help book and just copy it into another directory the Apple Help Viewer just shows an empty page when I view it.

What is the point of a help viewer that can't view help?

I have copied the Bluetooth.help to another directory and it says

Code: Select all

Help Viewer does not know how to handle the selected URL

The selected URL is: file:///Volumes/data/helptest/Bluetooth.help/


So there must be some external reference requirement to the directory?

( Tiger, Leopard )
Land of the Long White Cloud and no Software Patents.

User avatar
PymbleSoftware
Posts: 1887
Joined: Tue Jul 15, 2008 5:48 pm
Location: P.O. Box 121, Pymble, Sydney, NSW 2073, Australia.
Contact:

Re: Apple Help development

Unread postby PymbleSoftware » Mon Mar 29, 2010 2:37 pm

porter wrote:Does any one have any experience creating Apple Help Books?

It looks like a pile of crap to me.

I can create the HTML viewable by Safari no problem, but try as I may I can't arrange it into a book recognized by Apple Help Viewer. Eg I have a directory XXXX.help/Contents/Resources and the various xxxx.plist files. Even if I take an Apple provided help book and just copy it into another directory the Apple Help Viewer just shows an empty page when I view it.

What is the point of a help viewer that can't view help?

I have copied the Bluetooth.help to another directory and it says

Code: Select all

Help Viewer does not know how to handle the selected URL

The selected URL is: file:///Volumes/data/helptest/Bluetooth.help/


So there must be some external reference requirement to the directory?

( Tiger, Leopard )



No idea, have you tried the apple developer books like:
http://developer.apple.com/mac/library/ ... _help.html
死の神はりんごだけ食べる

開いた括弧は必ず閉じる -- あるプログラマー

:Tezro: :Tezro: :Onyx2R: :Onyx2RE: :Onyx2: :O3x04R: :O3x0: :O200: :Octane: :Octane2: :O2: :O2: :Indigo2IMP: :PI: :PI: :1600SW: :1600SW: :Indy: :Indy: :Indy: :Indy: :Indy:
:hpserv: J5600, 2 x Mac, 3 x SUN, Alpha DS20E, Alpha 800 5/550, 3 x RS/6000, Amiga 4000 VideoToaster, Amiga4000 -030, 733MHz Sam440 AmigaOS 4.1 update 1.

Sold: :Indy: :Indy: :Indy: :Indigo: Tandem Himalaya S-Series Nonstop S72000 ServerNet.

@PymbleSoftware
Current Apps -> https://itunes.apple.com/au/artist/pymb ... d553990081
Cortex ---> http://www.facebook.com/pages/Cortex-th ... 11?sk=info
Minnie ---> http://www.facebook.com/pages/Minnie-th ... 02?sk=info
Github ---> https://github.com/pymblesoftware
Visit http://www.pymblesoftware.com
Search for "Pymble", "InstaElf", "CryWhy" or "Cricket Score Sheet" in the iPad App store or search for "Pymble" or "CryWhy" in the iPhone App store.

User avatar
porter
Posts: 2917
Joined: Wed Nov 01, 2006 11:37 pm
Location: NZ

Re: Apple Help development

Unread postby porter » Mon Mar 29, 2010 3:39 pm

Yes, it looks like you can't have standalone help books, they have to be within another bundle, and if they are in another bundle the user can't easily navigate into it. Sounds like it's not the medium to use for help unless it's help within an application, not help about an application.
Land of the Long White Cloud and no Software Patents.

User avatar
porter
Posts: 2917
Joined: Wed Nov 01, 2006 11:37 pm
Location: NZ

Re: Apple Help development

Unread postby porter » Mon Mar 29, 2010 5:07 pm

Solution: a manpage! :)
Land of the Long White Cloud and no Software Patents.


Return to “Apple”

Who is online

Users browsing this forum: No registered users and 0 guests