Creating Effective JavaHelp (Java Series) - Softcover

Lewis, Kevin

Softcover

ISBN 10: 1565927192 ISBN 13: 9781565927193

Publisher: O′Reilly, 2000

Synopsis

Effective, instantly available online help is a requirement for today's interactive applications. Until now, Java application developers have been forced to develop their own help system. That's no longer necessary. With the release of JavaHelp™, there is a complete and standard online help system for the Java™ platform.Creating Effective JavaHelp covers the main features and options of JavaHelp. It shows how to create a basic JavaHelp system, prepare help topics, and deploy the help system in an application. Written for all levels of Java developers and technical writers, the book takes a chapter-by-chapter approach to building concepts. It imparts a complete understanding of how to create usable JavaHelp systems and integrate them into Java applications and applets.Topics covered include:

• Understanding JavaHelp
• Creating your first HelpSet
• Planning the JavaHelp project
• Preparing Help topics
• Creating HelpSet data and navigation files
• Enhancing the HelpSet
• Using the JavaHelp API for advanced presentation options
• Deploying the help system to your users
• Using third-party help-authoring tools

About this title

Review

With the new JavaHelp standard from Sun, Java programmers can now deliver online help that rivals traditional help systems on other platforms (such as Windows). Aimed at Java developers and technical writers, Creating Effective JavaHelp provides a very concise guide to creating help systems using this new standard. Even before HTML was widely used, help systems provided hyperlinks and browsing capabilities. The author does a good job at first orienting the reader to JavaHelp and how it relates to earlier help systems. There's also a useful short section on project planning for online help. The author next shows how the JavaHelp standard uses XML to structure the layout of content (for such options as navigation and the table of contents). (Help content itself is organised into HTML pages.) The author works through a sample help system from Sun and shows you how to create a simple custom help system to illustrate these concepts. For developers, the author turns toward the JavaHelp APIs, which allow a program to call up context-sensitive help at run-time. Other sections show off how to take advantage of more advanced help features, like using secondary windows to display content or using embedded help within custom applications. The book ends with reference material on relevant XML tags, plus the JavaHelp API itself. Chances are JavaHelp won't change the way you create help systems. (As the author notes, third party tools will actually let you deploy help systems to JavaHelp automatically.) This compact text points out the differences and advantages of JavaHelp for creating online help on the Java platform. Whether you are a technical writer, developer, or project manager, you'll want a copy of Creating Effective JavaHelp to see the future of online help for the next generation of Java applications. --Richard Dragan, amazon.com Topics covered:

• Overview of the JavaHelp help system, JavaHelp vs. other help systems, standalone, context-sensitive and embedded help
• Deploying JavaHelp
• HelpSet basics
• Map and navigation files
• Project planning guide for creating help systems
• Help topics
• XML basics for HelpSet navigation and table of contents (TOC) files
• Popup and secondary windows
• Customizing stopwords
• Using the JavaHelp API: implementing context-sensitive and embedded help, third-party help authoring tools, reference for HelpSet, LightWeight Component Tags and the JavaHelp API

About the Author

Kevin Lewis holds a master's degree in technical and professional writing from Northeastern University in Boston. He has worked extensively with many online help systems and was one of the first help authors to work with JavaHelp. He offers training services in several online help technologies. Kevin has published articles on message-box design and on version-control systems for technical documents.

Edition details

• Publisher: O′Reilly
• Publication date: 2000
• ISBN 10: 1565927192
• ISBN 13: 9781565927193
• Binding: Paperback
• Language: English
• Edition number: 1
• Number of pages: 171