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 wrote:
> Our app is complex,
> years in developm
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.
O
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 thi
On May 7, 2014, at 12:00 PM, Kirk 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
___
Cocoa-dev m
On May 7, 2014, at 2:06 PM, Todd Heberlein wrote:
>
> On May 7, 2014, at 6:53 AM, Bill Cheeseman 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 (P
> 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: https://git
On May 7, 2014, at 6:53 AM, Bill Cheeseman 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 book, and it did hel
en Thomases)
> 3. Re: How to convert a UTF-8 byte offset into an NSString
> characteroffset? (Uli Kusterer)
> 4. Re: Help with Help (Uli Kusterer)
> 5. Resizing last column of NSTableView when it touches window
> border (Jakob Egger)
> 6. Re: Help with Help (
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
o
On May 7, 2014, at 9:44 AM, Jakob Egger 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. The documentat
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 u
On 29 Apr 2014, at 19:52, Gordon Apple 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.
> Unfortunately, this has
On 30 Apr 2014, at 00:52, Gordon Apple 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:
http://www.techwr-l.com/frequently-asked-questions.html#subs
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
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.
Unfortunately, this has been proven to be difficult to maintain. We¹ve
looked
On Wed, 1 Jul 2009 12:02:16 +1000, Graham Cox 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
>'untitled' with a bl
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
'untitled' with a blank content, but AHLookupAnchor returns noErr (0).
I
17 matches
Mail list logo
