Setting URL Translation Preferences

If you are unfamiliar with URL translations, see About URL Translations. To learn more about publishing on the Web, see Publishing a Document on the Web and About Publishing and URLs.

By default, Cosmo Create automatically translates URLs when you create links, and it assumes that the server root is /var/www/htdocs and the project root directory is the directory from which you started Cosmo Create.

To change these default behaviors and to add custom URL translations, follow these steps:

1. Select File > Preferences

   The Preferences window appears.

2. Click the URL Translation tab on the Preferences dialog tab deck.

3. Specify which behavior you want to change.
   • To stop Cosmo Create from translating URLs when you create links, click to remove the checkmark from the box next to Translate URLs when creating links.

   • To change the value of the server root path, change the information in the field next to Server Root. Do not change the field below the Server Root field (i.e., keep the / as the only item in the field).

   • To change the value of the project root directory, change the information in the field next to Project Root. Do not change the field below the Project Root field (i.e., keep the field empty).

   • To add a custom translation, click the Add button, then enter the full pathname of the directory on your system in the User Defined field, and enter the pathname that the directory will have on the web server in the --> field.

   • To remove a custom translation, click to select it, then click the Delete button.

4. Save the preference values now displayed, or cancel your changes.
   • Click OK to save the changes for this file only and to close the window.

   • Click Save to save the changes for all Cosmo Create documents and to keep the window open. This saves the general and publishing preferences.

   • Click Cancel to close the window. If this is the first button you click in this window, no changes are made. If you first clicked OK or Save, those changes are made.

Cosmo Create saves the preferences in the file .cosmocreate/cosmocreate-preferences in your home directory. See the cosmocreate(1) man page for more details.