ZANACMS Docs

Design and CSS

ZANACMS separates website content from layout and CSS. This makes it possible to update system files without losing design customisations.

Safe CSS changes

Global custom CSS โ€” applied across all layouts โ€” can be placed in:

/layout/supercustom.css

Layout-specific custom CSS can be placed in:

/layout/<family>/<design>/custom.css

Both files are loaded after the supplied layout CSS and are not overwritten by updates. Do not change core CSS files such as zp.css or zpsuper.css directly, as they can be overwritten during an update.

Supplied HTML designs

Supplied HTML designs currently include html/water, html/just-the-docs, html/z-airy and html/z-airy.blue. They use the generic HTML layout generator and a design.html template under /layout/html/<design>/.

The supplied html/z-airy design is included for preview and evaluation purposes. Use on a public or private website requires a valid design license.

HTML layouts can use ~~ZCOL2~~ for a sidebar. The admin sidebar editor is shown only when the active design has design.ini with columns=2. Only set columns=2 when the design should accept editable sidebar content; the default is columns=1. If a sidebar image is selected in the editor, ZANACMS renders it before the sidebar text with class col2img. The selected image applies to all language versions of the sidebar.

The supplied global CSS contains:

.col2img {
	width:100%;
	height:auto;
}

Use /layout/supercustom.css or the layout custom.css file for local visual adjustments. The normal pageimg remains separate from col2img.

Own HTML design

To create a completely custom design, add a new design folder, for example:

/layout/html/-owndesign/

A custom design folder is yours entirely. Because you are not modifying an existing supplied design, you do not need custom.css to protect your changes from updates โ€” the whole design directory is already separate.

More details