About Foundry

Placeholder

Layout templates

Placeholder

CSS files

Placeholder

Templates Tags Reference

aside

Description

Generates a HTML5 aside element.

See also

• http://www.w3.org/TR/html5/sections.html#the-aside-element

body

Description

Generates the HTML body element.

See also

div

Description

Generates a HTML div element.

See also

divIfNotEmpty

Description

Generates a HTML div element, but only if the content is not empty.

See also

footer

Description

Creates a HTML5 footer element.

See also

head

Description

Creates the HTML head element which may contain meta data and stylesheets etc. It also generates some meta data like the generator meta information or the language meta information.

See also

header

Description

Generates a HTML5 header element.

See also

main

Description

Generates a HTML5 main element.

See also

meta

Description

Generates a meta data field in in the head element.

See also

nav

Description

Generates a HTML5 nav element.

See also

script

Attributes

absolute

If set to true the path in the src is used as it is.

src

The path of the script to include. If the absolute> attribute is not set (or not set to true the path is interpreted relative to the theme directory. For example the path of a script included using

                <script type="text/javascript" src="scripts/example.js"/>
                

in the a theme named my-theme at the server http://www.example.org is altered to the absolute path http://www.example.org/themes/published-themedir/itb/scripts/example.js. If the absolute attribute is set to true the path is not altered. One usecase for an absolute path is to load an script from a content delivery network.

type

The type of the script. Usally this is text/javascript. If the attribute is not set in the layout template, it is automatically set to text/javascript.

Description

Used to include a script (usally a JavaScript). The script is either provided a content of the element or as an external file. Embedded scripts should only be used for small parts of code, like the code for activating jQuery plugins for some elements. Everything which is longer than five or six lines should be put into a external file in the scripts directory of the theme.

See also

section

Description

Generates a HTML5 section element.

See also

span

Description

Generates a span element.

See also

title

Description

Generates the title in the HTML head.

See also

The overall structure of foundry

Placeholder

Foundry Coding Style

This document describes the coding conventions for the Foundry theming engine.

Naming

The naming rules described here apply to all names: Names of layout elements, XSL template names, EXSLT functions, files, ids and classes (in the class attribute).

Use the dash "-" to separate parts of a name instead of camel case or the underscore. For example: get-setting instead of getSetting or set_setting.

Names should be lowercase.

Namespace declarations

In the XSL files, XML namespaces are only defined at the <xsl:stylesheet> element. The XSL namespace is the first one is declared first. The other namespace follow in alphabetic order (ordered by their prefix).

Indention, line length and formating

Indention is done using spaces. Indention depth is four (4) spaces per level.

Try to keep the line length below 100 characters per line. Because of some restrictions of XML this will be possible in every case.

Insert a line break after each attribute of an XML element. The first attribute is on the same line as the element. For example write

<xsl:param name=example-param"
           select="'example'"/>
        

instead of

<xsl:param name=example-param" select="'example'"/>
        

The documentation system of Foundry

Placeholder