Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

How to create .help file for mac application help?

I am trying to make the help support for my mac application. I made the XHTML, HTML and the .helpIndex file. But I dont know how to make the .help file. My question is what is .help file? and how to make the .help file?

I am studying in the apple classreference for doing this. Below is the stuff I have copied this link

Creating a Basic Help Book

Once you create the HTML files containing your help content, you must organize them into a help book. To do this, create a help book folder and include the following items:

My Question: How to create a help book folder. I cant understand this. I have just create a folder with somename.help and copied the files to it. But that is not working. whether it is the correct way of creating a help folder.

like image 327
Aravindhan Avatar asked Sep 24 '11 08:09

Aravindhan


1 Answers

The .help is the top level folder of your document set not a file. Like a Mac application is really a folder with a .app extension

At a base level you need to create your html based document set like you have done and then add the meta tag named AppleTitle into your top level .html file index.html (SurfWriter.html in the examples)

<head>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title>Foobar Help</title>
  <meta name="AppleTitle" content="Foobar Help">
</head>
  • add CFBundleHelpBookFolder with a value of the name of your folder (Surfwriter.help) to your plist

  • add CFBundleHelpBookName with a value of Foobar Help to your plist (matches the meta tag in your header)

  • add a custom copy phase to put your .help document folder structure into Resources

Should just work after that.

like image 159
Warren Burton Avatar answered Oct 20 '22 20:10

Warren Burton