Skip to end of metadata
Go to start of metadata

The Skin Editor Resources screen is a file upload and management tool.

Resource Settings

Resource Notation

Any image or text file can be uploaded to the ThemeBuilder Resources, and is then available to a skin using the resource notation.

SkinID::ResourceName

Note the double colon between the skin and file name :: . This tells ThemeBuilder to look in its own resources for the file.

Resource Actions

Once a resource has been uploaded you can perform actions on it to manage that resource. The actions will differ depending on the type of resource.

Note: Text includes CSS, JS etc. You must use the 'Save' button in the Skin Editor after changing any text file in the Resources screen.

Resource TypeIconAction
ImageHover to View in popup
Image, TextClick to Open browser
(or right click to copy image url)
Image, TextClick to Delete
TextHover to Preview contents
TextClick to Open in simple text editor

Upload and Reference an Image File 

Resource Screen

  • Use the 'Browse' button to upload any image from a local folder.
  • The image will start uploading automatically.
  • Once uploaded the image will appear in the Resources list.

See the Image macro for how to use an image in a ThemeBuilder panel or Confluence page.

CSS Usage

Image resources can be used in the ThemeBuilder CSS screen for background images. The code is added with the url in resource notation.

Examples

Add a background image to a HTML div in a panel or page.

.my-background {
	background-image: url("SkinId::ResourceName.ext");
}


Image in Resource screen


CSS screen

 

.my-background {
    background: url("MYSKIN::flying-pig.png") repeat left bottom #CC3300;
    color: #FFFFFF;
    height: 340px;  
}


Div Added to Panel

In your ThemeBuilder skin panel, add this to create the element the CSS will be applied to:

<div class="my-background">
</div>

 

Div Added to Page

You will need the Content Formatting plugin installed to add HTML div's to a page. Use the macro browser to add a 'div' with the class 'my-background'.

Result

The image is added as a background to the div.

 

Example Usage

Text files can be used as additional resources for CSS and JavaScript code, or as a way to hold code separate from your skin that then gets imported into a panel e,g, a place to hold chunks of text that are re-used throughout your skin...

CSS/JS Resource

See Skin Editor - HTML for an example of how to reference a CSS or JS resource file.

New Text Resource - Panel Import

  1. Use the 'New text resource' button top open the text editor.
  2. Add the name of your file in the 'Name' text field and press 'Enter'



  3. A popup will display with the file name in the tab, and a simple text editor. The example shows HTML added in a file called company-address.txt.
    The text file extension can be used as this will be imported into a panel that outputs XML/HTML.



  4. In the Panel Editor use the Import macro to include the contents of the resource in your panel. Use resource notation to reference the file.



        <ac:macro ac:name="import">
          <ac:parameter ac:name="import">MYSKIN::company-address.txt</ac:parameter>
        </ac:macro>  

Result

Output HTML

<p>My Company</p>
<p>The Building</p>
<p>The Street</p>
<p>The Town</p>
<p>The District</p>
<p>The Code</p>

 

Notes

You will need to click the 'Save' button to apply any changes made in the 'Resource' screen.

  • No labels