Transform your Oracle Tutor Documents to Your Corporate Standard

Posted by mary.keane on Oracle Blogs See other posts from Oracle Blogs or by mary.keane
Published on Fri, 19 Mar 2010 01:00:00 -0800 Indexed on 2010/03/19 9:21 UTC
Read the original article Hit count: 474

You have all of your company's processes documented in Oracle Tutor, and now you want to get the HTML files to reflect your company's corporate look and feel. How are you going to do this without having an HTML guru to change every HTML page?

The good news is you do not need to be an HTML expert to make minor changes to your documents. All Tutor HTML files are attached to a group of style sheets, so any changes you make to the style sheets will immediately be reflected in all of your HTML documents.

If you want to give it a try, here's what you do (please note that these tips are applicable to release Oracle Tutor 12.2 and greater):

Navigate to your Tutor HTML directory, and copy into a draft folder a representative group of HTML files (don't forget the flowchart image files that are associated with the procedures). You'll also need to copy the following files:

tutor.css
tutor_notabs.css
tutor_scripts.js
tutor_tabs.css
flow_icon.gif

Here's the default look to the Oracle Tutor desk manual.

desk_manual_image.gif

Let's say I want to use my company's corporate style in the HTML documents. At Oracle, we use Oracle Red (FF0000), Oracle Black (000000), and Oracle Gray (666666). So I want to incorporate those colors into the Tutor HTML files.

I open tutor.css from the draft folder in a text editor. My preference is to use Notepad, but there are others. Make sure, however, that it is a text editor, and not a word processing program.

I want to change the headings to Oracle Red. The desk manual title is listed as the DMPAGETITLE, so I find that in tutor.css. The style names in the style sheets are descriptive, but sometimes you may have to experiment to find the right style (this is why you're working in a draft folder).

dmtitle.gif

I change the color attribute to FF00000, and then I save the document. Now I look at one of the desk manuals in my draft folder.

Thumbnail image for deskmanualchange.gif

I've successfully changed the title of the desk manual, so, now that I have more confidence that I can do this, I start changing other styles. I need to make changes in the tutor_tabs.css file as well, so I open that document. Then I look at one of the procedures.

procred.gif

Oops! All that red is distracting, and the users may not be able to follow their procedures. So I go back to the corporate style guide, and I find some shades of gray that have been approved. So I use that, and it is now more readable.

betterproc.gif

It's good enough for a first draft, and I would show it to my colleagues at this point to get their input.

On my next blog, I'll discuss how to change the flowchart colors to match your corporate look and feel.

Have you used the cascading styles sheets to change the look of your Tutor documents? If so, let us know what you've done in your post.

Mary R. Keane
Senior Development Manager, Oracle Tutor & UPK Content

© Oracle Blogs or respective owner

Related posts about Tutor Tips

Related posts about Oracle Tutor