Paint your system documentation in your company colors to further enhance user adoption
By user10246598 on Apr 29, 2011
To further enhance your documentation adoption, brand your documents to meet company standards, departmental specifics or project names and graphics. Furthermore, being able to distribute the same documentation with a relevant look and feel throughout the company subsidiaries or departments leverages the documentation effort while reinforcing the idea that this documentation belongs to these organizations.
With Oracle UPK, style categories can be created allowing you to customize everything from logo, colors and icons up to the way the information is presented in the printed documentation. Once a style category is made available and has been customized, it can be applied at the time of publishing, allowing you to publish the same content outline in distinct appropriate styles. Reinforcing specific projects, applications, subsidiaries, departments or company events identity in the systems testing, training and support documentation are some of the areas where this ability can reinforce the sense of belonging.
All style component files are grouped together into a styles folder in the UPK System library. Oracle UPK comes delivered with only one styles folder. Use the copy, paste special (duplicate) function and rename this folder to create additional styles folders and start customizing your content. (Please refer to Content Development reference manual in Publishing Content / Customize publishing styles). You will have the ability to replace graphic files, change colors and font styles files (CSS), or edit the Office documents template files used by UPK for publishing. Once your new styles folder has been created, open it in the library: it will display an icon for each document template output that can be published. Double-click the desired icon, and you will then have access to all the files that together form the publishing style for this specific output. You will be able to open and edit these files or to drag and drop your custom files from a Windows Explorer window to replace the existing ones. Please be aware that the preceding text is a generic description of the process and that because each UPK output can be customized in distinct ways, you will have to follow the customization guidelines available for each documentation output (Please refer to Content Development reference manual in Publishing Content / Customize publishing styles / Customize the Player, Customize the Presentation Format, Customize the HP Quality Center Output & Customize Document Formats).
While you may want to apply distinct custom changes per available output, chances are that you would like to use the same logo throughout all your documentation in a given styles folder. Oracle UPK Developer 3.6.1 provides you with a specific function to do it. Create your custom logo file (GIF, JPEG or PNG) and use the use the Customize Logo command on the Tools menu. It will prompt you for the category (The styles folder) to be customized, and for the location where the custom logo file has been stored. This command will launch a batch process in which all of the individual document tempates will be altered with the custom logo you have provided. After a few minutes you will have the ability to select the your custom style category at the time of publishing to have the custom logo be displayed in your published documentation (Please refer to Content Development reference manual in Publishing Content / Customize publishing styles / Use the Customize Logo Tool).
Special thanks to Jean Jacques Bouet, Principal Sales Consultant - Paris, France for this entry (firstname.lastname@example.org)