ThemeBuilder Debugging Tools
When building a new skin, it can be helpful to check Display Debug Comment. This will display extra information when viewing HTML sources or using a tool such as Firebug in Firefox. You can do this by following the steps below:
- Click the Confluence Administration icon, and select General Configuration
- Click Edit Skins in the ThemeBuilder section of the left sidebar.
- Click the Options tab within the skin you want to edit.
- Select the Display Debug Comment checkbox 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.
Note: If this is the first parameter in a page address, use a
? to preface, and if there are other parameters, use &.Then, "http://domain/page" becomes "http://domain/page?skin=root".
- 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.