HTML Document Conversion: Naming Conventions

Developing a Coherent Naming Convention

Before you can start to develop a set of related documents, you must first come up with a standard naming convention. This is especially important for very large documents with multiple images and associations. With multiple people working on the conversion process, it is important that the naming be consistent.

You should also decide on a directory structure. I've found it best to crate one directory for the HTML pages, a sub directory for related images or attachments, and a third directory for icons (if any). The Directory names have their first letter in Caps (in Unix). All file names I try to keep to 8 letters for portability and simplicity.

1. Divide document into logical sections.
2. Take inventory of all attached graphics and images.
3. Take note of all expected in-document anchors.
4. For small documents, make a Map of what documents will be linked and how.

   Make names as clear as possible

   Make the first letter of a Directory Upper Case.

   Make all File Names Lower Case.

5. Document all names or describe naming convention in detail so that others working on the conversion process will not be confused.

Last updated on: Thu Jun 15 10:05:40 PDT 1995