Re: PDF file names

Subject: Re: PDF file names
From: Stuart Burnfield <slb -at- westnet -dot- com -dot- au>
To: Caroline Tabach <caroline -dot- tabach -at- gmail -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 06 Sep 2007 22:44:23 +0800

Hi Caroline -

I usually do have the product version number in the PDF file name.

Note that you can put a lot of version information in the metadata. If
you open one of your PDFs in Adobe Reader and select File > Properties
(or press Ctrl-d), you'll see the Document Properties dialog. On the
Description tab there are fields for Title, Author, Subject and
Keywords. A couple of these fields may already have default values.

FrameMaker and AuthorIT (and probably other publishing tools) let you
set a lot of this information in the source document. For example, you
could add the version number to the Title and put the platform and
edition in the Keywords (Enterprise Edition for UNIX/Linux).

If you have Acrobat you can open the PDF and edit the values in the doc
properties directly. You can also set a property (I think it's in the
Open Options) called something like Display Title in Title Bar. When a
customer opens the PDF, instead of just displaying file name the title
bar will display whatever you put in the Title field (e.g. Toaster Oven
User Guide V2.20).

Finally, if the person who creates the CD finds it a lot of work, it
sound like they're manually copying and renaming files. There should be
a build script that copies all the required files from the development
hierarchy on the server to the standard CD folder structure. Ideally
this should be almost a one-step process--simply kick off the buildCD
script then check the return code at the end to confirm that it ended
successfully.

As long as you are disciplined at naming all the PDFs in a standard,
predictable way (e.g. <manualname>_<version>.pdf) this should work well
and will save a lot of time. The build script could be set up so that
you pass it the version number when invoking it:

buildCD -v2.20

... and it plugs the version number into the file name when copying each
PDF.

Let me know if any of this is not clear.

Regards

Stuart

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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-

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.


Follow-Ups:

Previous by Author: Re: Transitioning to Writing Software Docs
Next by Author: Index vs. Search?
Previous by Thread: PDF file names
Next by Thread: Re: PDF file names


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


Sponsored Ads