Page History

...

Builder is a highly visual theme which contains several javascripts, images and other components to render pages. This page lists various ways to improve the performance of the theme on your Confluence installation.

Logo Size

Issue: Pages load slow due to large logo
Affects: Anyone with a logo that's huge

We've encountered some cases of clients using huge logos - not their on-screen size (width and height) but their file size.

The logo shown at the top of this page is about 14.6KB - not perfect, but good enough for our needs.

If your logo is bogger than about 20KB, you should seriously consider trimming it down.

Solution

There are various techniques for reducing the file size of logos:

• Use a different image format: JPEG, GIF or PNG all give different results and one will generally be smaller than the others
• If you are using JPEG compression, try reducing the quality of the image – significant reductsions in file size can be made for only minor loss in image quality
• If you are using a GIF image, try reducing the number of colours in the image

Generally, it's a case of trial and error to find the best settings.

If you've found your logo to be huge and are having trouble shrinking it down, send it to Adaptavist and we'll see what we can do.

Large Style Sheet

Issue: Large stylesheet being loaded on every single page
Affects: Themes where the style sheet hasn't been put in to an external file

Builder comes with a default style sheet showing all the various settings we've used to improve content design and even resolve a few issues with the inbuilt stylesheets that come with Confluence.

Because the style sheet is editable in the CSS Custom Styles setting, it makes it relatively easy for you to alter it and add your own styles, etc.

However, that style sheet gets embedded in to each page that uses the Builder theme and as such increases the file size of the page.

Solution

To resolve this issue, follow the instructions in our tutorial on Creating CSS Files which shows how to move the style sheet in to a separate file that can then be referenced by the theme thus ensuring the style sheet is only loaded once after which it can be cached by your web browser.

Resource Servlet Caching

Issue: Menu takes up to 20 seconds to load
Affects: All versions of Builder running on Confluence 2.1.x

...

From Confluence 2.2 onwards, our recommended alterations have become part of Confluence which will massively improve performance of the servlet for a wide range of plugins.

Solution

If you are using Confluence 2.1.x, it is possible to manually apply a patch if you have access to a friendly Java developer - for more information, please see our Conditional GET patch instructions.

...

As we added more and more macro sections and tutorials, the "Macros" menu became huge and started to make page rendering in our user guide slower and slower.

Solution

There is no specific solution, other than to limit the size of the menus generated with macros. Obviously, that depends on which macros you are using.

...

If you use macros within footers, extra processing will usually be required on the server whilst those macros go off and get additional information from the database, etc.

Solution

Use the cache macro (available here) to cache your footer.

...