TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Nancy Allison wondered: <<Do any of you use PDFs for your online help?
Is it possible to link to topics within a PDF for context-sensitive
help?>>
I don't, but it's definitely possible.
Whether you would want to do this is a very different question;
choosing PDF sacrifices the ability to let users choose the window
size and the typeface/size font combination that works best for them,
which is an important consideration in online help. If you do opt for
PDF, make sure that you optimize it for onscreen use (as I did in my
book); there are few things quite so annoying as having to constantly
scroll through and zoom in/out when the PDF is designed for printing
(portrait format, small fonts) rather than on-screen display.
<<PDFs are attractive to me, for use as an online help system, because
you can control the display of special characters in them. You can be
sure what your end user will see.>>
In most cases, you should be able to control these characters simply
by specifying the correct character set (in the HTML header) and the
correct HTML entities for these characters in that character set.
Details: http://www.w3.org/TR/html4/sgml/entities.html
------------------------------------------------------------------------
Geoff Hart (www.geoff-hart.com)
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
------------------------------------------------------------------------
Effective Onscreen Editing: http://www.geoff-hart.com/books/eoe/onscreen-book.htm
------------------------------------------------------------------------
Free Software Documentation Project Web Cast: Covers developing Table of
Contents, Context IDs, and Index, as well as Doc-To-Help
2009 tips, tricks, and best practices. http://www.doctohelp.com/SuperPages/Webcasts/
Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.com/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-