PDFs as online help?

Subject: PDFs as online help?
From: Geoff Hart <ghart -at- videotron -dot- ca>
To: TECHWR-L Writing <techwr-l -at- lists -dot- techwr-l -dot- com>, Nancy Allison <maker -at- verizon -dot- net>
Date: Wed, 08 Jul 2009 10:41:16 -0400

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-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
PDFs as online help?: From: Nancy Allison

Previous by Author: I don't even know how to google for this forgotten term?
Next by Author: Colons and translation?
Previous by Thread: RE: PDFs as online help?
Next by Thread: Re: PDFs as online help?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads