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.
I'm setting up processes for the doc department of a small software
company. We use FrameMaker, Paint Shop Pro, and WebWorks. Much of our
documentation gets translated, currently to one language, but possibly to
more later. We provide our documentation as PDF files and WebWorks files
that are included with the software builds. We don't provide hard copy of
anything. We'd like to minimize the size of our FrameMaker files, and
especially of the PDF files, since the PDF files actually get
distributed.
The current question that I've been working on is standards for graphics. I
did some research on-line, including the techwr-l archives, about what the
options are and what the consequences are of the various options. There
isn't a lot of definitive information, but this is what I've come up with:
* Graphics should be linked, not embedded
* Format should be GIF
* We don't need to save the Paint Shop Pro files after the GIF is created
* DPI should be 72
* Graphics should be in a standard subdirectory for each document (meaning
all the graphics for a document go in a sub-directory of the FrameMaker
files, and the subdirectory should always have the same name for every
document)
* The filenames for graphics do not need to reflect the language (same
filename regardless of the language, but they'll be in different directories)
* Try to use short names, to avoid having them munged if we need to zip
everything
If anyone has any experience that suggests that any of those is actually a
bad idea, or has other suggestions that might be better, please let me know.
One thing that I don't really like is that the graphics always need to be
resized to make them small enough to fit the page. I tried resizing in
Paint Shop Pro, but then the screen shots were unreadable. Does anyone have
any suggestions about how to resolve that problem? Do I need to just resign
myself to resizing in FrameMaker every time I place a screen shot?
Thanks,
-Ami
-----------------------------------------------------------------
Ami Wright
"Technical" tech writer
American with international experience
www.amiwright.com
-----------------------------------------------------------------
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-