Customizing your Tutor documents with Headers and Footers
By mkeane on Jun 30, 2010
In previous entries, I've covered how to enhance the readability of your Tutor documents by customizing the associated style sheets and the flowchart colors. In this entry, I will cover how to add logos as well as links to the company intranet and other helpful web sites. This is done by editing a header and footer file and setting up Author and Publisher to attach these files to each Tutor document.
The Tutor Author directory contains the HeaderFooter directory. Within this directory are two text files: footer.txt and header.txt.
It's helpful to understand what happens with these two files during the HTML conversion within Tutor. If the "Include HTML Header" option is selected within Author and Publisher, then the text from the header.txt file is copied into the header section of each HTML file during conversion.
This is the default header.txt file that is included in Tutor Author and Publisher. Even though header.txt and footer.txt are text files, the information contained within these files is HTML code.
When a Tutor document is converted to HTML with this header, the following HTML document is created.
Glancing at the header.txt file shows that the link to the Document Register will not work as it is not complete (DOCREG_???.xls).
Below is an example of how I edited the header.txt file so that the link to the Document Register is now correct.
I have also updated the logo to link to the Oracle.com webpage, and I've used a link to the Oracle logo. By using a link, if there is any kind of change to the logo, it will automatically be updated on my Tutor documents. Below is the HTML document after I have changed the header.txt to point to the Oracle.com site and include the Oracle logo.
With some small changes to the HTML code in the header and footer text files, you can transform the look of all of your Tutor documents on your company site.
Just remember that all the Tutor documents will need to be reconverted to HTML in order to pick up any changes to the header and footer text files, so it's best if these changes are done at the start of a Tutor implementation.
Remember, your Tutor documents can reflect your corporate standards in font, layout, color scheme, and logos with careful customization of the cascading style sheets, flowcharts, and header/footer text files.
- Mary R. Keane, Senior Development Manager, Oracle Tutor