Fischer-Bayern.de
 FAQFAQ   SuchenSuchen   MitgliederlisteMitgliederliste   BenutzergruppenBenutzergruppen   RegistrierenRegistrieren 
 ProfilProfil   Einloggen, um private Nachrichten zu lesenEinloggen, um private Nachrichten zu lesen   LoginLogin 

Help Book einer App. hinzufügen

 
Neues Thema eröffnen   Neue Antwort erstellen    Fischer-Bayern.de Foren-Übersicht -> AppleScript-Studio Forum
Vorheriges Thema anzeigen :: Nächstes Thema anzeigen  
Autor Nachricht
Heiner
•-->
•-->


Anmeldedatum: 03.12.2005
Beiträge: 62
Wohnort: Moers

BeitragVerfasst am: 05.01.2008 - 21:34    Titel: Help Book einer App. hinzufügen Antworten mit Zitat

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
Nach oben
Benutzer-Profile anzeigen Private Nachricht senden E-Mail senden
iScript
•---->
•---->


Anmeldedatum: 29.03.2001
Beiträge: 1116

BeitragVerfasst am: 06.01.2008 - 11:53    Titel: Antworten mit Zitat

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.
Nach oben
Benutzer-Profile anzeigen Private Nachricht senden E-Mail senden Website dieses Benutzers besuchen AIM-Name
Heiner
•-->
•-->


Anmeldedatum: 03.12.2005
Beiträge: 62
Wohnort: Moers

BeitragVerfasst am: 06.01.2008 - 15:23    Titel: Antworten mit Zitat

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
Nach oben
Benutzer-Profile anzeigen Private Nachricht senden E-Mail senden
Beiträge der letzten Zeit anzeigen:   
Neues Thema eröffnen   Neue Antwort erstellen    Fischer-Bayern.de Foren-Übersicht -> AppleScript-Studio Forum Alle Zeiten sind GMT + 2 Stunden
Seite 1 von 1

 
Gehe zu:  
Du kannst keine Beiträge in dieses Forum schreiben.
Du kannst auf Beiträge in diesem Forum nicht antworten.
Du kannst deine Beiträge in diesem Forum nicht bearbeiten.
Du kannst deine Beiträge in diesem Forum nicht löschen.
Du kannst an Umfragen in diesem Forum nicht mitmachen.


Powered by phpBB © 2001, 2002 phpBB Group
Deutsche Übersetzung von phpBB.de


AppleScript für absolute Starter