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.
Subject:Re: Printed & Online Manual, and Help From:Bill Burns <BillDB -at- ILE -dot- COM> Date:Tue, 25 Mar 1997 08:33:00 -0700
Robin Allen writes:
I am starting a new project in a week or so and part of the requirement
is to have an online manual, a printed manual, and online help from a
single source document. We are a service company and customers will use
our web site extensively to place orders, maintain accounts, etc.
8< 8< 8< 8< snip >8 >8 >8 >8
- What tools can I use to create and maintain all of this?
- In what file format should I save the online manual?
- Should I create the manual to be used with some type of reader
Acrobat (which I'm not familiar with)?
I'm doing this very thing right now. We're creating our hardcopy in
FrameMaker. Then I'm importing the file into a Frame template designed
for online use (larger, sans serif fonts, broader kerning and leading,
custom layout with navigation graphics) and printing it to file for use
in Acrobat. So far, the result is pretty good (at least, better than
just slapping the hardcopy online).
I'm going to be trying out a filter from Omni Systems, which supposedly
generates compiler-ready RTF from FrameMaker. If the filter works well
enough, we'll have all three documents from the same source file.
Obviously, the online manual and help will be finished after the content
of the hardcopy is finalized.
You can check out the details on DCL (MIF to RTF) filters at