Bug 613701

Summary: Repetitive changing of a brand results in wrong document rendering
Product: [Community] Publican Reporter: Jaromir Hradilek <jhradile>
Component: publicanAssignee: Jeff Fearn 🐞 <jfearn>
Status: CLOSED NOTABUG QA Contact: Fedora Extras Quality Assurance <extras-qa>
Severity: medium Docs Contact:
Priority: low    
Version: 1.6CC: jfearn, mmcallis, publican-list, rlandman
Target Milestone: ---   
Target Release: ---   
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-07-27 04:47:16 UTC Type: ---
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Jaromir Hradilek 2010-07-12 15:43:20 UTC
Description of problem:
Changing a brand from "common" to "RedHat" and back again results in wrong rendering of a book.

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

How reproducible:
Always.

Steps to Reproduce:
1. Create a new book typing "publican create --name Broken".
2. In publican.cfg, change the brand from "common" to "RedHat", and build the book typing "publican build --langs=en-US --formats=html-desktop".
3. In publican.cfg, change the brand back to "common", and build the book with the command above once again.
4. Open tmp/en-US/html-desktop/index.html in a web browser.
  
Actual results:
The document appears to combine the brands together: although the title page uses the correct heading and images, chapter and section headings are red instead of blue, example frames are grey instead of orange, etc.

Expected results:
The document should have correct appearance as defined by the current brand.

Additional info:
None at the moment.

Comment 1 Ruediger Landmann 2010-07-12 23:35:42 UTC
This occurs because the Red Hat brand contains an overrides.css file that overrides certain parts of the default.css of the common brand. Since you built the book first with the Red Hat brand, the overrides.css file for that brand was still in the tmp/en-US/html-desktop directory when you built it with the common brand which doesn't contain an overrides.css file.

To work around this, run "publican clean" between builds, or simply delete tmp/en-US/html-desktop/Common_Content/css/overrides.css

Note that this scenario only arises when switching to a brand that lacks an overrides.css from some other brand that includes an overrides.css.

Comment 2 Jeff Fearn 🐞 2010-07-27 04:47:16 UTC
I'm going to close this NOTABUG since all it requires is running 'publican clean'; we can't automatically run clean every build as it breaks a lot of use cases.