Genshi XML Template Reference¶

Genshi’s XML templating language is used in Bundler for templated bundles. The language is described in depth at Genshi. The XML schema reference follows.

Genshi Tags¶

group py:genshiElements¶

Most Genshi templating directives can be used either as standalone elements or as attributes on existing elements. This element group defines the standalone tags.

Elements:

element py:with¶

Attributes:

Name	Description	Values	Required	Default
`py:vars`	A semicolon-delimited list of variables to define and their values.	`string`	Yes	None

Any arbitrary child elements allowed

Text content:

Any

element py:replace¶

Attributes:

Name	Description	Values	Required	Default
`py:value`	The value to replace the contents with.	`string`	Yes	None

Any arbitrary child elements allowed

Text content:

Any

element py:choose¶

Attributes:

Name	Description	Values	Required	Default
`py:test`	If `test` is set, the child `py:when` directives are tested for equality to the value of the expression.	`string`	No	None

Child elements:

element py:when¶

The when directive is used inside py:chooseType or choose to handle a single specific condition.

Attributes:

Name

Description

Values

Required

Default

py:test

The statement giving the value to test

string

Yes

None

Any arbitrary child elements allowed

Text content:

Any
element py:otherwise¶

Any arbitrary child elements allowed

Text content:

Any

Text content:

Any

element py:for¶

Attributes:

Name	Description	Values	Required	Default
`py:each`	The loop iterator	`string`	Yes	None

Any arbitrary child elements allowed

Text content:

Any

element py:if¶

Attributes:

Name	Description	Values	Required	Default
`py:test`	The statement giving the value to test	`string`	Yes	None

Any arbitrary child elements allowed

Text content:

Any

element py:match¶

Attributes:

Name	Description	Values	Required	Default
`py:path`	XPath expression to search for in the template.	`string`	Yes	None
`py:buffer`	Whether the matched content should be buffered in memory. Buffering can improve performance a bit at the cost of needing more memory during rendering. Buffering is required for match templates that contain more than one invocation of the `select()` function. If there is only one call, and the matched content can potentially be very long, consider disabling buffering to avoid excessive memory use.	`true` \| `false`	No	`true`
`py:once`	Whether the engine should stop looking for more matching elements after the first match. Use this on match templates that match elements that can only occur once in the stream, such as the <head> or <body> elements in an HTML template, or elements with a specific ID.	`true` \| `false`	No	`false`
`py:recursive`	Whether the match template should be applied to its own output. Note that once implies non-recursive behavior, so this attribute only needs to be set for match templates that don’t also have once set.	`true` \| `false`	No	`true`

Any arbitrary child elements allowed

Text content:

Any

element py:def¶

Attributes:

Name	Description	Values	Required	Default
`py:function`	The function prototype	`string`	Yes	None

Any arbitrary child elements allowed

Text content:

Any

Genshi Attributes¶

attributeGroup py:genshiAttrs¶

Most Genshi templating directives can be used either as standalone elements or as attributes on existing elements. This attribute group defines the attribute directives.

Name	Description	Values	Required	Default
`py:attrs`	attrs directive	`string`	No	None
`py:choose`	choose directive	`string`	No	None
`py:content`	content directive	`string`	No	None
`py:def`	def directive	`string`	No	None
`py:for`	for directive	`string`	No	None
`py:if`	if directive	`string`	No	None
`py:match`	match directive	`string`	No	None
`py:otherwise`	The `otherwise` directive is used inside `py:chooseType` or `choose` to handle all conditions not handled by a `py:when`.	`string`	No	None
`py:replace`	replace directive	`string`	No	None
`py:strip`	strip directive	`string`	No	None
`py:when`	The `when` directive is used inside `py:chooseType` or `choose` to handle a single specific condition.	`string`	No	None
`py:with`	with directive	`string`	No	None

Genshi XML Template Reference¶

Genshi Tags¶

Genshi Attributes¶

Table Of Contents

Previous topic

Next topic

This Page

Navigation

Genshi XML Template Reference¶

Genshi Tags¶

Genshi Attributes¶

Table Of Contents

Previous topic

Next topic

This Page

Quick search

Navigation