|
"AIR Help" - Cross-Platform Help System -
"AIR Help" is a cross-platform Help format that has been made possible by Adobe's
introduction of the AIRTM (Adobe Integrated Runtime) development technology
(previously code-named Apollo) which lets
you deploy rich Internet applications on the desktop. This means that you should be
able to take your "web help" files, and wrap them up in an AIR application that can
be installed as a Help system. The same AIR application can be installed on Windows,
Mac, and Linux (soon) systems.
The AIR runtime environment includes its own integrated web browser (WebKit), which
means that your Help system will look the same on all supported platforms.
Not only can you wrap up your web help files, but you can also develop highly
interactive applications that leverage HTML, Javascript, Flash, Flex, and Ajax.
The Flex 3 development environment can be used to develop these applications, and
this framework is in the process of going open source.
For more information visit the following URLs:
Adobe has recently released the RoboHelp Packager for Adobe AIR which
lets you generate an AIR Help file from a RoboHelp-generated Help system.
This gives you an AIR-based cross-platform Help system without needing to
develop and manage the underlying ActionScript code yourself.
This is definitely worth looking into!
If you want to create your own version of AIR Help, you'll need to do some
coding and design work. This can be done using the Flex 3 development environment
as well as others (one promising IDE is called Aptana Studio ..
http://aptana.com/studio). You can also
do this coding outside of an IDE and use the command-line compiler to build your
AIR project. Using the AIR SDK (free), you can build AIR applications as part
of an automated publishing pipeline.
The sample files below are provided as a very basic proof of
concept. There are a number of things that need to be worked out before this can be
a truly viable online Help alternative, but as this gets more focus, I'm sure many
people will come up with some nice options.
Prototypes
The first prototype (image to the left) is a very simple use of AIR and Flex, purely as a
container/wrapper for a browser-based Help system. I've tested this by wrapping up
WebWorks Help as well as other "WebHelp" systems .. so far they all work quite nicely.
The content for the first prototype is just a custom frameset-based Help system using the
DITA Reference. Using javaScript and HTML I developed three tabs for the navigation.
The second prototype (image to the right) is a more traditional "Help system" in that it
has a programmatic (tree view) navigation panel on the left, with the content displayed
on the right. The navigation panels are created with an "accordion" widget, but could
have just as easily used a more common tabbed control. I've been adding more features
to this over time. The current version provides the following:
- Multiple XML-defined "Contents" (TOC) panels
- XML-defined "Index" panel
- Full text search that uses multiple (local and remote) search indexes
- Forward, Back, and Home buttons
- The ability to make context-sensitive calls from an external application to display a specific topic
- The ability for an external application to "push" a search query and display the results.
- Position and size of window is preserved between sessions
- Sync with TOC functionality
- Options dialog to set the following: Remote loading of search index on startup; Check for user comments on each topic; Keep help on top.
- "About" dialog
- The ability to add user-comments to each topic (comments are stored on a remote server, and loaded into topic at run-time)
- "Next" and "Previous" browsing through topics based on the TOC ordering.
Gallery
As people develop their own implementations of AIR Help, I'll collect samples for others
to see. Feel free to send in yours (use the contact page).
Community Support
I've started a Yahoo group
("AIR_Help")
for anyone interested in talking about these
issues and sharing Help-related ideas for this new development environment.
Installation
In order to install the AIR application (the Help file in this case), you first need
to install the AIR runtine environment. One of the nice things about AIR is that this runtime
install is very quick and easy, and as far as I know there's no reboot required.
This download is available from Adobe at the following URL:
» http://get.adobe.com/air/
After installing the runtime, you can download and install the AIR application.
To install the application, double-click the AIR file after downloading. You'll get an installation
dialog that tells you the publisher is unverified and the system access is unrestricted
(I believe that later versions of AIR will allow digital signing and a restricted system
access option for a more friendly install. The source is provided for those interested.)
You can choose to install or cancel. If you choose to install,
you'll be prompted for the location to install as well as other options.
Download Prototype Four - This is the current version .. sorry no source available for this one yet.
Download Prototype Three - This is an early version of the "second" prototype shown above (source included).
Download Prototype One - Looks like the "first" prototype described above.
Download AIR Help "Basic" - Instructions and sample files for making a basic "wrapped" AIR Help file.
|
