ThemeBuilder for Confluence Server and DC

ThemeBuilder Debugging Tools

When building a new skin, it can be useful to check Display Debug Comment. This will display extra information when viewing html source or using a tool such as Firebug in Firefox. You can do this by following the steps below:

  1. Go to the Confluence Administration icon, and select General Configuration

  2. Click on Edit Skins in the ThemeBuilder section of the left sidebar.

  3. Click the Options tab within the skin you want to edit.

  4. Check the Display Debug Comment box at the bottom of the editing options.

Example Output:

<!--
userAgent: 'Mozilla/5.0 (Windows NT 6.1; WOW64; rv:26.0) Gecko/20100101 Firefox/26.0'
skin : 'com.adaptavist.confluence.theme.engine.skins.model.Skin@aff33d2b'
skinId : 'TEST2'
spaceName : 'test2'
currentURL : '%2Fconfluence%2Fdisplay%2FTES%2FForm%2BMail%2BOne'
contextPath : '/confluence'
action name : 'viewpage' ********* Builder data *********
adaptavist.builder.sitemeshPage: com.opensymphony.module.sitemesh.parser.TokenizedHTMLPage@4c6291ee
adaptavist.builder.helper: com.atlassian.confluence.themes.PageHelper@6cc6f949
adaptavist.builder.actualPageTitle: Form Mail One
adaptavist.builder.mode: view
adaptavist.builder.context: page
adaptavist.builder.decorator: page
adaptavist.builder.pageContext: com.atlassian.confluence.renderer.PageContext@cbf72858 Current
adaptavist.builder.skinId: TEST2 Latched
adaptavist.builder.skinId: null
Flags in order of priority:
REQUEST flags - with-sidebar(true) myflag(true) without-sidebar(false) login(false)
SESSION flags - none
USER flags - none
PAGE flags - none
SPACE flags - none
GLOBAL flags - none
********* Flag Logic *********
Setting with-sidebar to false
Setting without-sidebar to true
Setting login to false
Decorator is one of globa/profile/search/login/unknown
In edit mode
Setting with-sidebar to true
Setting without-sidebar to false
Setting login to false
-->

See the Debug section on the Skin Editor - Options page for more information.

Set Skin by URL

You can also add a query string to the end of the page address to force Confluence to use any skin when ThemeBuilder is the theme for that space. For example, add 'skin=root' to see how that space will display in the default ThemeBuilder skin.

If this is the first parameter in a page address, use a ? to preface, and if there are other parameters, use &.

Press Enter, and reload the page to see the page with the default skin.

Remove the query string, and reload the page to see the page with the skin you set through ThemeBuilder.

This is a great tool for comparing small changes against the default ThemeBuilder skin, and it’s also good for troubleshooting if you are not sure if something in your work has broken the current skin.