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:Converting publications to Web pages From:burgamw1 <burgamw1 -at- TEOMAIL -dot- JHUAPL -dot- EDU> Date:Fri, 16 Jun 1995 15:09:39 EST
In answer to LaVonna's question:
We've recently converted a large document (three sections and five appendixes)
to Web pages for distribution inside the firewall. I was able to break the
document up into several chunks (separate html or gif files): one for each
section and appendix, one for the table of contents, and one for each figure.
The table of contents has two parts: a general list of contents by section or
appendix title and a detailed table of contents that includes each subsection.
Each title or subsection is linked to the appropriate file, so that users can
bring up the part of the document they're interested in from the table of
contents. The figures can be accessed from their citations in the text, which
are linked to the figure gif files.
I did a minimal amount of rewriting to accommodate the links. For example,
"Figures 1 through 3 show" had to be converted to "Figure 1, Figure 2, and
Figure 3 show" so that readers could easily access all three figures.
It's not perfect. One of the sections is much longer than the other two and
probably should have been broken into two parts. The text in some of the figures
is hard to read. When we have time (ha ha), we'll redo those figures.
The internal customer is satisfied. He wanted to be able to easily update the
document without having to print and send change pages to about 300 people
internally. I haven't had any feedback yet from the users, but it's early days.
Murrie Burgan, Johns Hopkins University Applied Physics Laboratory
murrie -dot- burgan -at- jhuapl -dot- edu