Hyrax Customization user manual

From OPeNDAP Documentation
Revision as of 16:35, 15 July 2010 by Rduncan (talk | contribs) (New page: = Web page customization = Hyrax's public "face" is the web pages that are produced by servlets running in the Tomcat servlet engine. Almost all of these pages can be completely customiz...)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
⧼opendap2-jumptonavigation⧽

Web page customization

Hyrax's public "face" is the web pages that are produced by servlets running in the Tomcat servlet engine. Almost all of these pages can be completely customized by the site administrator by editing a combination of HTML, XSLT, and CSS files.

Where to make the changes

All of the default versions of the HTML, XSLT, and CSS files come bundled with Hyrax in the $CATALINA_HOME/webapps/opendap/docs directory. You can make changes there, but installing new versions of the OLFS software will overwrite your modifications.

However, if the docs directory is copied (preserving its structure) to $CATALINA_HOME/content/opendap/ (creating the directory $CATALINA_HOME/content/opendap/docs), then Hyrax will serve the files from the new location.

Warning
Do NOT remove files from this new directory (Or the old one for that matter). Each file, in its location, is required by Hyrax. You can make changes to the files but you should not rename or remove them.

Nothing inside the $CATALINA_HOME/content directory is (automatically) changed when installing new versions of Hyrax.

The rest of these instructions are written with the assumption that a copy of the docs directory has been made as described above.

What to change

HTML Files

The HTML files provide the static content of a Hyrax server.

File