Help Book einer App. hinzufügen

Heiner · •--> Anmeldedatum: 03.12.2005 Beiträge: 62 Wohnort: Moers

Hallo allerseits,

ich wende mich auch in diesem Forum an jene, die Erfahrung haben mit dem Hinzufügen eines HelpBooks zu einem Programm.
Meine eigenen Versuche waren bisher erfolglos.
Falls sich jemand findet, dann werde ich meine Versuche auch darstellen.

Gruß

Heiner

iScript · •----> Anmeldedatum: 29.03.2001 Beiträge: 1116

Hier mal ein Auszug aus Kevin Bradleys Tutorial auf macscripter.net zu genau diesem Thema:

Somebody Help Me!
Help pages are one of the most overlooked items in Applescript Studio applications, and there's little reason for it. Making a "help book" is actually very easy and installing it into your app requires little from you, the programmer. Most of the help functionality comes from Cocoa anyway, you just need to create the items needed and "plug them in."

Help books are just HTML files contained in their own folder.. Yep, just like a website! You create an index page that will be the "landing zone" when one of your users selects the help menu item in your application. You can add as many or as few pages as you need to explain your application. If you need or want images, just create an images folder in your help book's folder and in your pages use relative URL's to reference them. So for a graphic, you would use href="images/yourgraphic.jpg" rather than a full URL.

In order to convince the Help Viewer that your help book is legit, you must include the following meta tag in the <head> section of your index page:

<meta name="AppleTitle" content="YourAppName Help">

There are other tags for setting the default font, default search font, chapter order and icon (to be used in the list of available help books). But the AppleTitle tag is the only one that must be present.

To provide your users the ability to search your help, you need to index your help pages. To do this, drop your help folder on the Help Indexer application in the Utilities folder of your Developer tools. An index file is created and put into your folder with your HTML files.

Once you've indexed your HTML pages and they work the way you want them to (I suggest viewing them in Safari first), you again use the Add Existing Files... context menu item to add the help folder to your project. When the copy dialog pops up, be sure to mark the "Add folder references" item, or your help won't work. Why? Because one of the pieces of information you must provide XCode is the name of your help folder!

The other information you must provide to XCode is the name of the help book as you want it to appear in Help Viewer. To provide these 2 pieces of information you add 2 keys to the info.plist of your project in this form:

<key>CFBundleHelpBookName</key>
<string>YourApp Help</string>
<key>CFBundleHelpBookFolder</key>
<string>YourApp Help</string>

Your folder name doesn't have to match the name of the help book, but for convenience sake most developers name them the same.

That's it. At this point, re-build your app and try out the help menu item. Thanks to Cocoa's underlying framework, your user can initiate a help session with Help Viewer.

Heiner · Verfasst am: 06.01.2008 - 15:23 Titel:

Hallo iScript,

vielen Dank für Deine schnelle Antwort.
Der Artikel war mir schon bekannt, aber trotzdem lief bei mir nichts - bis ich heute Morgen (zum X-ten-mal) die Einträge kontrolliert habe und dann bemerkte, dass ich den meta-tag "Apple Title" geschrieben habe, statt - wie es richtigerweise heißen muss - "AppleTitle", also zusammengeschrieben.

So kann man sich das Leben auch schwer machen.

Noch einmal vielen Dank

Heiner

thewarriorfromsiata · •-> Anmeldedatum: 07.05.2023 Beiträge: 1

If you're a fan of characters who transform from being hesitant to powerful in a similar way to Red Sonya or if you enjoy realistic fantasy stories, then you'll find The Warrior From Siata appealing.