About URL Translations

The ultimate destination of your HTML document is a location on a Web server (see also About Publishing and URLs). Cosmo Create helps you to author your document so that you can easily transfer it to any location on any Web server and still preserve all links. The mechanism Cosmo Create uses is called URL Translations.

For example, URL Translations on your project root directory work in this way:

When creating links to other files on your system, try to copy or move those files into subdirectories of your project root directory to keep your document portable and publishable. See also About Publishing.

If you plan to link to locations on your Web server, the Server Root translation of the Preferences window in the URL Translation tab dialog must be accurate. When you create a link to a location on the Web server, always start the link with / and provide a full pathname that does not include the path of the server root.

For example, if the server root is /var/www/htdocs and you want to link to the file /var/www/htdocs/fred/home.html, the link is to /fred/home.html. The path /fred/home.html is said to be "relative" to the server root /var/www/htdocs.