next up previous contents
Next: Adding and Removing Files Up: Editing a Web Site Previous: Updating Your Working Copy   Contents

Cross-platform and Consistency Considerations

There are a few precautions you must observe to ensure the site is usable on all platforms and in situations beyond the web-server, such as when loaded onto a laptop for a trade show demonstration. Here are the precautions:

CVS folders
The folders in each directory called CVS contain important version control information that is automatically generated. You should not remove these folders or edit their contents by hand.
No Symbolic Links
UNIX developers may be tempted to create symbolic links between files. To assure that developers (and web servers) on non-UNIX platforms can work with the project, do not create symbolic links in your working copy of the site. If you do create symbolic links and upload them to the site repository, they will be silently ignored.
Naming Conventions
As mentioned in our Guidelines for \ensuremath{W^3} Projects, limit filenames to the Macintosh-friendly length of 32 characters. Do not use MiXEd-cAsE, under__scored, or Capitalized names for files or folders. Use a simple-hyphen to separate multi-word-filenames.
Relative URL's
Within any HTML/hyperlinks you create, use relative URL addresses (such as ../classes/cvs-101.html) which do not begin with an absolute path. Absolute URL addresses (/school/classes/cvs-101.html) are much pickier about where and how they are served, and make it difficult to port our web projects onto other computers.


next up previous contents
Next: Adding and Removing Files Up: Editing a Web Site Previous: Updating Your Working Copy   Contents

copyright © 1997-1999 sean dreilinger.