Diazo theme engine guide

di-az-o (also di-az-o-type)

noun

a copying or coloring process using a diazo compound decomposed by ultraviolet light

Diazo allows you to apply a theme contained in a static HTML web page to a dynamic website created using any server-side technology. With Diazo, you can take an HTML wireframe created by a web designer and turn it into a theme for your favourite CMS, redesign the user interface of a legacy web application without even having access to the original source code, or build a unified user experience across multiple disparate systems, all in a matter of hours, not weeks.

When using Diazo, you will work with syntax and concepts familiar from working with HTML and CSS. And by allowing you seamlessly integrate XSLT into your rule files, Diazo makes common cases simple and complex requirements possible.

Contents:

• Introduction
• Quickstart
• Installation
• Basic syntax
  • Rule directives
    • <theme />
    • <notheme />
    • <replace />
    • <before /> and <after />
    • <drop />
    • <strip />
    • <merge />
    • <copy />
  • Order of rule execution
  • Behaviour if theme or content is not matched
• Advanced usage
  • Conditional rules
    • Conditions based on content nodes
    • Conditions based on paths
    • Conditions based on arbitrary parameters
    • Condition grouping and nesting
    • Multiple, conditional themes
  • Modifying the theme on the fly
  • Modifying the content on the fly
  • Inline XSL directives
  • Doctypes
  • XInclude
  • Including external content
    • Using the XSLT document() function.
    • Using a Server Side Include directive
    • Using an Edge Side Includes directive
• Compilation
  • Absolute prefix
  • Custom parameters
  • Testing the compiled theme
  • Compiling the theme in Python code
• Deployment
  • Plone
  • WSGI
  • Nginx
    • Including external content with SSI
  • Varnish
  • Apache
• Contributing to this documentation
• Contributing to Diazo

• Recipes
  • Drop empty tags
  • Insert wrapping element
  • Adding an attribute to elements
  • Modifying an attribute
  • Modifying text
  • Create an unordered list from a series of elements
  • Contributing a recipe