Thanks for that info. I’ll look deeper into it. Sometimes I put out
statements in hope that someone will clarify the issue. Our app is complex,
years in development, and will require a substantial help book, including
videos (maybe the web version), external links, and contextual-help
anchors.
For those interested, I put together a blog entry of my personal notes over the
years on using Apple's Help:
Help on OS X Help
http://www.toddheberlein.com/blog/2014/5/8/help-on-os-x-help
On May 8, 2014, at 10:50 AM, Gordon Apple g...@ed4u.com wrote:
Our app is complex,
years
On 29 Apr 2014, at 19:52, Gordon Apple g...@ed4u.com wrote:
We would like to get a recommendation on the best way to generate a help
system for a fairly complex application. We started by using a simple web
view and created about 120 screens in BBEdit, mostly drill-down outlines.
I'd strongly recommend against using Apple's Help Book application. There are a
few problems with Apple Help:
Problems with Help Books
First of all, they are poorly documented. It is extremely difficult to
structure them in the right way. You can't use HTML5, you have to
On May 7, 2014, at 9:44 AM, Jakob Egger ja...@eggerapps.at wrote:
Problems with Help Books
First of all, they are poorly documented.
I disagree with most of Mr. Egger's comments about Help Book problems, but he
is certainly right that they are still poorly documented.
Wow! That¹s quite an indictment of one of Apple, Inc¹s supposed developer
tools. You¹d think that with $190B cash, they could fix this. One of the
problems I ran into is that I couldn¹t find the indexing tool without going
back to old versions. When I tried to use it, it choked, spewing a litany
so it is more specific
than Re: Contents of Cocoa-dev digest...
Today's Topics:
1. NSWorkspace issue (Varun Chandramohan)
2. Re: NSWorkspace issue (Ken Thomases)
3. Re: How to convert a UTF-8 byte offset into an NSString
characteroffset? (Uli Kusterer)
4. Re: Help
On May 7, 2014, at 6:53 AM, Bill Cheeseman wjcheese...@gmail.com wrote:
As far as I know, the only comprehensive explanation of the new post-Snow
Leopard version of Help Books is Chapter 11 of my book, Cocoa Recipes for Mac
OS X, Second Edition (Peachpit Press 2010).
I used Cheeseman’s
The HTML in the app and on the website is slightly different, I use PHP to
generate the HTML.
A more modern approach would probably be to use a static site generator like
Jekyll, which would allow you to use templates, write in Markdown, etc.
You can use Markdown with PHP:
On May 7, 2014, at 2:06 PM, Todd Heberlein wrote:
On May 7, 2014, at 6:53 AM, Bill Cheeseman wjcheese...@gmail.com wrote:
As far as I know, the only comprehensive explanation of the new post-Snow
Leopard version of Help Books is Chapter 11 of my book, Cocoa Recipes for
Mac OS X, Second
On May 7, 2014, at 12:00 PM, Kirk kirkkere...@gmail.com wrote:
I further note that Apple's own iWork apps use online help pages that open in
Safari.
We use HTML and open Safari when user selects help. Great for our cross
platform products.
-koko
As somebody who did a lot of development work on early versions of Simple Help
Editor, I’d like to point out a misstatement. It does not require one to write
their own HTML. It does a quite capable job of translating styled text into
HTML, but does offer the ability to handle custom HTML for
On 30 Apr 2014, at 00:52, Gordon Apple g...@ed4u.com wrote:
We would like to get a recommendation on the best way to generate a help
system for a fairly complex application.
You might also try techwrl-list, they're the experts on help systems:
It's best to use Apple's help. However, you may want to consider the case where
your app supports a localization that Apple's Help app doesn't and give the
user the option of opening your help pages in the user's web browser. In one
app some time back, the help would show English while the user
On Wed, 1 Jul 2009 12:02:16 +1000, Graham Cox graham@bigpond.com said:
Hi all,
I'm trying to link help buttons in my app to topics in my help book.
I have a simple scheme where the (hidden) title of the button contains
the anchor and I pass it to AHLookupAnchor. The help window opens as
15 matches
Mail list logo