Theming

Intro

The current best-practice way to theme a Plone site is by using an engine called “Diazo”. This allows designers to design a theme in just plain, flat HTML, CSS and JavaScript.

The way to do this is to use plone.app.theming. If you need to integrate Plone with other back-end servers, legacy systems, or any webservice, you can use Diazo to all combine it in a unified look & feel.

• Create a Plone 5 theme product (addon)
  • Introduction
  • Create a product to handle your Diazo theme
  • Override Plone BrowserViews with jbot

• Plone App Theming Manual
  • Introduction
  • What is a Diazo theme?
  • Using the control panel
  • Reference
• Diazo theme engine guide
  • Introduction
  • Quickstart
  • Installation
  • Basic syntax
  • Advanced usage
  • Compilation
  • Deployment
  • Contributing to this documentation
  • Contributing to Diazo
  • Recipes

• Resource Registry
  • Introduction To Plone 5 Resources
  • Resources
  • Bundles
  • Controlling Resource And Bundle Rendering
  • Aggregate Bundles For Production
  • Diazo Bundles
  • Migrating Older Add-ons
• Barceloneta Theme
  • Structure
  • Register LESS Resources
  • Using the barceloneta theme only for the backend

An older (Plone 4.2) quick guide which may help to understand Diazo better:

• Quick Test Recipe
  • Ingredients
  • Procedure

Using Diazo is also possible as a standalone service.

Normally the Diazo theme transformation is running inside the Plone process. You can compile the Diazo rules to low level XSLT and let a webserver do the actual transformation, or run the Diazo transformations in a WSGI enabled service.

If you want this advanced stand alone set up, please take a look at documentation on www.diazo.org, especially the Compilation and Deployment chapters.

General information CSS and other resources in Plone:

• Front-end: templates, CSS and JavaScript
  • TAL Page Templates
  • CSS
  • Resource folders
  • Skin layers
  • DTML

Note

Up to version 4.1, Plone was using an older style of theming. Using that is not considered best practice anymore.

See older versions of these docs if you need the information.