Bug 867951

Summary: Guides in rhevm-doc builds appear without branding.
Product: Red Hat Enterprise Virtualization Manager Reporter: Stephen Gordon <sgordon>
Component: rhevm-docAssignee: Stephen Gordon <sgordon>
Status: CLOSED NEXTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 3.1.0CC: acathrow, dyasny, thildred
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-11-01 14:05:07 UTC Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Stephen Gordon 2012-10-18 16:23:04 UTC
Description of problem:

The guides depend on common branding content from the publican-redhat brand. We don't distribute this, so rhevm-doc is going to need to:

- Bundle a couple of key css and image files.
- Rewrite paths as appropriate (we already do this to kill the javascript TOC, need to extend it).

Version-Release number of selected component (if applicable):

All versions, but need to fix for RC.

Comment 1 Stephen Gordon 2012-10-18 16:27:51 UTC
Looking at my 3.0 install the branding was there in that version of rhevm-doc, I think this has been introduced as a result of the fact that we now build with Publican 3. It handles the branding slightly differently.

Comment 2 Stephen Gordon 2012-10-18 16:49:53 UTC
I think the correct solution is for:

rhevm-doc to own:

/usr/share/ovirt-engine/doc/common/
/usr/share/ovirt-engine/doc/common/en-US

rhevm-doc-ja-JP to own:

/usr/share/ovirt-engine/doc/common/ja-JP

...and so on.

Comment 3 Stephen Gordon 2012-10-23 13:56:18 UTC
Ok, I have a fix for en-US. rhevm-doc now packages and owns the CSS and images required for proper "branding". These deploy under these folders (common refers to the 'common' brand, 'RedHat' refers to the Red Hat brand that further overrides this):

/usr/share/ovirt-engine/doc/common/en-US
/usr/share/ovirt-engine/doc/RedHat/en-US

For rhevm-doc-ja-JP I belive the appropriate action will be to provide symlinks:

/usr/share/ovirt-engine/doc/common/ja-JP -> /usr/share/ovirt-engine/doc/common/en-US 
/usr/share/ovirt-engine/doc/RedHat/ja-JP -> /usr/share/ovirt-engine/doc/RedHat/en-US

Comment 4 Stephen Gordon 2012-10-23 20:34:27 UTC
rhevm-doc-ja-JP-3.1.0-6  is the first build of the Japanese version to include the branding fix.