3472 lines
122 KiB
HTML
3472 lines
122 KiB
HTML
<!DOCTYPE html
|
|
SYSTEM "about:legacy-compat">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" id="site">
|
|
|
|
<head>
|
|
<meta name="generator" content=" "></meta>
|
|
|
|
<title>
|
|
Foundry Documentation
|
|
|
|
</title>
|
|
|
|
<meta http-equiv="content-type" content="text/html;charset=utf-8"></meta>
|
|
|
|
<link href="/home/jensp/pwi/libreccm/ccm/trunk/ccm-sci-bundle/web/themes/foundry/images/favicon.png" type="image/png" rel="shortcut icon"></link>
|
|
</head>
|
|
|
|
<body><span id="top"></span><a href="#startcontent" accesskey="S" class="nav-hide" title="">Skip navigation</a>
|
|
|
|
<header>
|
|
The Foundry Theming Engine for LibreCCM
|
|
|
|
</header>
|
|
|
|
<div>
|
|
|
|
<h1>The Foundry Theming Enine for LibreCCM</h1>
|
|
|
|
<p>Jens Pelzetter</p>
|
|
|
|
</div>
|
|
|
|
<nav>
|
|
|
|
|
|
<ul class="chapter-list">
|
|
|
|
<li class="chapter-entry">
|
|
<a href="#overview">
|
|
Overview
|
|
</a>
|
|
|
|
|
|
<ul class="section-list">
|
|
|
|
<li class="section-entry">
|
|
<a href="#overview">
|
|
Overview
|
|
</a>
|
|
|
|
</li>
|
|
<li class="section-entry">
|
|
<a href="#this-manual">
|
|
This manual
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
<li class="chapter-entry">
|
|
<a href="#user-manual">
|
|
User Manual
|
|
</a>
|
|
|
|
|
|
<ul class="section-list">
|
|
|
|
<li class="section-entry">
|
|
<a href="#about-foundry">
|
|
About Foundry
|
|
</a>
|
|
|
|
</li>
|
|
<li class="section-entry">
|
|
<a href="#layout-templates">
|
|
Layout templates
|
|
</a>
|
|
|
|
</li>
|
|
<li class="section-entry">
|
|
<a href="#css-files">
|
|
CSS files
|
|
</a>
|
|
|
|
</li>
|
|
<li class="section-entry">
|
|
<a href="#template-tags-reference">
|
|
Templates Tags Reference
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
<li class="chapter-entry">
|
|
<a href="#developer-manual">
|
|
Developer Manual
|
|
</a>
|
|
|
|
|
|
<ul class="section-list">
|
|
|
|
<li class="section-entry">
|
|
<a href="#foundry-structure">
|
|
The structure of Foundry
|
|
</a>
|
|
|
|
</li>
|
|
<li class="section-entry">
|
|
<a href="#coding-style">
|
|
Coding style
|
|
</a>
|
|
|
|
</li>
|
|
<li class="section-entry">
|
|
<a href="#doc-system">
|
|
The documentation system of Foundry
|
|
</a>
|
|
|
|
</li>
|
|
<li class="section-entry">
|
|
<a href="#function-reference">
|
|
XSL Templates and Function references
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
|
|
</nav>
|
|
|
|
<main id="startcontent">
|
|
|
|
<h1>
|
|
Foundry Documentation
|
|
|
|
</h1>
|
|
|
|
|
|
<article id="overview">
|
|
|
|
|
|
<h1>
|
|
Overview
|
|
|
|
</h1>
|
|
|
|
|
|
|
|
|
|
<section id="overview">
|
|
|
|
|
|
<h1>
|
|
Overview
|
|
|
|
</h1>
|
|
|
|
|
|
<main xmlns="">
|
|
Placeholder
|
|
|
|
</main>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section id="this-manual">
|
|
|
|
|
|
<h1>
|
|
This manual
|
|
|
|
</h1>
|
|
|
|
|
|
<main xmlns="">
|
|
Placeholder
|
|
|
|
</main>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
</article>
|
|
|
|
|
|
<article id="user-manual">
|
|
|
|
|
|
<h1>
|
|
User Manual
|
|
|
|
</h1>
|
|
|
|
|
|
|
|
|
|
<section id="about-foundry">
|
|
|
|
|
|
<h1>
|
|
About Foundry
|
|
|
|
</h1>
|
|
|
|
|
|
<main xmlns="">
|
|
Placeholder
|
|
|
|
</main>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section id="layout-templates">
|
|
|
|
|
|
<h1>
|
|
Layout templates
|
|
|
|
</h1>
|
|
|
|
|
|
<main xmlns="">
|
|
Placeholder
|
|
|
|
</main>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section id="css-files">
|
|
|
|
|
|
<h1>
|
|
CSS files
|
|
|
|
</h1>
|
|
|
|
|
|
<main xmlns="">
|
|
Placeholder
|
|
|
|
</main>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section id="template-tags-reference">
|
|
|
|
|
|
<h1>
|
|
Templates Tags Reference
|
|
|
|
</h1>
|
|
|
|
|
|
|
|
|
|
|
|
<section id="fragment-layout" class="template-tag">
|
|
|
|
<h1>
|
|
fragment-layout
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
Root element for generating a HTML fragment instead of a complete HTML document.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="page-layout" class="template-tag">
|
|
|
|
<h1>
|
|
page-layout
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
Root element of a template. Generates the
|
|
<code><html></code> root element.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="content-item" class="template-tag">
|
|
|
|
<h1>
|
|
content-item
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
This tags inserts the HTML representation of the current content item, either
|
|
as greeting item or normal item.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
The HTML representation of a content item is defined using special templates
|
|
with the <code>contentitem-layout</code> element as root. Usually these templates
|
|
are located in the <code>templates/content-items</code> folder. Which template is
|
|
used for a particular content item is defined by the <code>conf/templates.xml</code>
|
|
file. In this file there is a <code>content-items</code> below the
|
|
<code>templates</code> element. The association between templates and
|
|
content items is described by the <code>content-item</code> elements in the
|
|
<code>content-items</code> element. The <code>content-item</code> has four
|
|
optional attributes (at least on must be present) which are used to limit the
|
|
content items for which a template is used. The four attributes are:
|
|
|
|
</p>
|
|
|
|
<dl>
|
|
|
|
<dt>
|
|
<code>oid</code>
|
|
|
|
</dt>
|
|
|
|
<dd>
|
|
Limit the use of the template to a specific content item, identified by its
|
|
OID (the OID of the master version). Can't be used in combination with the other
|
|
attributes.
|
|
|
|
</dd>
|
|
|
|
<dt>
|
|
<code>content-section</code>
|
|
|
|
</dt>
|
|
|
|
<dd>
|
|
The name of the content section to which the item belongs. Can be used
|
|
in combination with the <code>category</code> and <code>content-type</code>
|
|
attributes.
|
|
|
|
</dd>
|
|
|
|
<dt>
|
|
<code>category</code>
|
|
|
|
</dt>
|
|
|
|
<dd>
|
|
The template is only used for the content item if the item is viewed as
|
|
item of the category. The category is set as a path contains the names
|
|
the categories.
|
|
|
|
</dd>
|
|
|
|
<dt>
|
|
<code>content-type</code>
|
|
|
|
</dt>
|
|
|
|
<dd>
|
|
The content-type of the item.
|
|
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
<foundry:doc-see-also>
|
|
|
|
<foundry:doc-link href="#layout-templates">The template system</foundry:doc-link>
|
|
|
|
</foundry:doc-see-also>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="show-page-title" class="template-tag">
|
|
|
|
<h1>
|
|
show-page-title
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:foundry="http://foundry.libreccm.org">
|
|
Outputs the title of the current page. For a content item, this is
|
|
the title of the content item. For more details please refer to
|
|
the documentation of the <code>foundry:title</code> function.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="show-text" class="template-tag">
|
|
|
|
<h1>
|
|
show-text
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:foundry="http://foundry.libreccm.org">
|
|
Outputs a static text which is retrieved from the
|
|
<code>static-texts/global.xml</code> file in the layout file. The key is the content
|
|
of the element. If at least one of the attributes <code>id</code>, <code>class</code>
|
|
or <code>with-colorset</code> is present at the attribute, the text is wrapped in a
|
|
<code>span</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Attributes</h2>
|
|
|
|
<dl>
|
|
|
|
<dt>
|
|
id
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
|
|
</dd>
|
|
<dt>
|
|
class
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
|
|
</dd>
|
|
<dt>
|
|
with-colorset
|
|
|
|
</dt>
|
|
<dd>
|
|
<code xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:foundry="http://foundry.libreccm.org">span</code>
|
|
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="a" class="template-tag">
|
|
|
|
<h1>
|
|
a
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
Generates a HTML <code>a</code> element. There are some differences to the
|
|
<code>a</code> element in HTML. First, there two attribute for the URL:
|
|
|
|
</p>
|
|
|
|
<dl>
|
|
|
|
<dt>
|
|
<code>href-property</code>
|
|
|
|
</dt>
|
|
|
|
<dd>
|
|
The name of a property of the current object which contains the URL for the
|
|
link.
|
|
|
|
</dd>
|
|
|
|
<dt>
|
|
|
|
<dt>
|
|
<code>href-static</code>
|
|
|
|
</dt>
|
|
|
|
<dd>
|
|
A static URL.
|
|
|
|
</dd>
|
|
|
|
</dt>
|
|
|
|
</dl>
|
|
|
|
<p>
|
|
The third variant for providing an URL is to call the template with a href
|
|
parameter in the XSL.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Attributes</h2>
|
|
|
|
<dl>
|
|
|
|
<dt>
|
|
download
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Value for the HTML5 <code>download</code> attribute.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
href-property
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
The name of a property (aka the name of an XML element in the data-tree)
|
|
containing the URL of the link.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
href
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
A static URL for the link.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
href-lang
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
The language of the target of the link.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
rel
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
The relationship of the linking document with the target document.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
title-static
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
A key which identifies the translated title in <code>lang/global.xml</code>.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
title
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Static, not translated title of the link.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
type
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Value for the <code>title</code> attribute of the link.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/text-level-semantics.html#the-a-element" title="http://www.w3.org/TR/html5/text-level-semantics.html#the-a-element">
|
|
http://www.w3.org/TR/html5/text-level-semantics.html#the-a-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="aside" class="template-tag">
|
|
|
|
<h1>
|
|
aside
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a HTML5 <code>aside</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/sections.html#the-aside-element" title="http://www.w3.org/TR/html5/sections.html#the-aside-element">
|
|
http://www.w3.org/TR/html5/sections.html#the-aside-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="body" class="template-tag">
|
|
|
|
<h1>
|
|
body
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates the HTML <code>body</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/sections.html#the-body-element" title="http://www.w3.org/TR/html5/sections.html#the-body-element">
|
|
http://www.w3.org/TR/html5/sections.html#the-body-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="dd" class="template-tag">
|
|
|
|
<h1>
|
|
dd
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
A definition of term in a definition list.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/grouping-content.html#the-dd-element" title="http://www.w3.org/TR/html5/grouping-content.html#the-dd-element">
|
|
http://www.w3.org/TR/html5/grouping-content.html#the-dd-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="div" class="template-tag">
|
|
|
|
<h1>
|
|
div
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a HTML <code>div</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/grouping-content.html#the-div-element" title="http://www.w3.org/TR/html5/grouping-content.html#the-div-element">
|
|
http://www.w3.org/TR/html5/grouping-content.html#the-div-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="divIfNotEmpty" class="template-tag">
|
|
|
|
<h1>
|
|
divIfNotEmpty
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a HTML <code>div</code> element, but only if the content is not empty.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="#div" title="#div">
|
|
#div
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="dl" class="template-tag">
|
|
|
|
<h1>
|
|
dl
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
Generates a definition list.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/grouping-content.html#the-dl-element" title="http://www.w3.org/TR/html5/grouping-content.html#the-dl-element">
|
|
http://www.w3.org/TR/html5/grouping-content.html#the-dl-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="dt" class="template-tag">
|
|
|
|
<h1>
|
|
dt
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
A term in a definition list.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/grouping-content.html#the-dt-element" title="http://www.w3.org/TR/html5/grouping-content.html#the-dt-element">
|
|
http://www.w3.org/TR/html5/grouping-content.html#the-dt-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="footer" class="template-tag">
|
|
|
|
<h1>
|
|
footer
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Creates a HTML5 footer element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/sections.html#the-footer-element" title="http://www.w3.org/TR/html5/sections.html#the-footer-element">
|
|
http://www.w3.org/TR/html5/sections.html#the-footer-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="head" class="template-tag">
|
|
|
|
<h1>
|
|
head
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Creates the HTML <code>head</code> 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.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/document-metadata.html#the-head-element" title="http://www.w3.org/TR/html5/document-metadata.html#the-head-element">
|
|
http://www.w3.org/TR/html5/document-metadata.html#the-head-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="header" class="template-tag">
|
|
|
|
<h1>
|
|
header
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a HTML5 <code>header</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/sections.html#the-header-element" title="http://www.w3.org/TR/html5/sections.html#the-header-element">
|
|
http://www.w3.org/TR/html5/sections.html#the-header-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="main" class="template-tag">
|
|
|
|
<h1>
|
|
main
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a HTML5 <code>main</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/grouping-content.html#the-main-element" title="http://www.w3.org/TR/html5/grouping-content.html#the-main-element">
|
|
http://www.w3.org/TR/html5/grouping-content.html#the-main-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="meta" class="template-tag">
|
|
|
|
<h1>
|
|
meta
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a meta data field in in the <code>head</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="#head" title="#head">
|
|
#head
|
|
</a>
|
|
|
|
</li>
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/document-metadata.html#the-meta-element" title="http://www.w3.org/TR/html5/document-metadata.html#the-meta-element">
|
|
http://www.w3.org/TR/html5/document-metadata.html#the-meta-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="nav" class="template-tag">
|
|
|
|
<h1>
|
|
nav
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a HTML5 <code>nav</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/sections.html#the-nav-element" title="http://www.w3.org/TR/html5/sections.html#the-nav-element">
|
|
http://www.w3.org/TR/html5/sections.html#the-nav-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="script" class="template-tag">
|
|
|
|
<h1>
|
|
script
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
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.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Attributes</h2>
|
|
|
|
<dl>
|
|
|
|
<dt>
|
|
absolute
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
If set to <code>true</code> the path in the <code>src</code> is used as it is.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
src
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
The path of the script to include. If the <code>absolute></code> attribute is not
|
|
set (or not set to <code>true</code> the path is interpreted relative to the
|
|
theme directory. For example the path of a script included using
|
|
|
|
</p><pre xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
<script type="text/javascript" src="scripts/example.js"/>
|
|
</pre><p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
in the a theme named <code>my-theme</code> at the server
|
|
<code>http://www.example.org</code> is altered to the absolute path
|
|
<code>http://www.example.org/themes/published-themedir/itb/scripts/example.js</code>.
|
|
If the <code>absolute</code> attribute is set to <code>true</code> the path is not
|
|
altered. One usecase for an absolute path is to load an script from a content delivery
|
|
network.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
<dt>
|
|
type
|
|
|
|
</dt>
|
|
<dd>
|
|
|
|
<p xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
The type of the script. Usally this is <code>text/javascript</code>. If the attribute
|
|
is not set in the layout template, it is automatically set to
|
|
<code>text/javascript</code>.
|
|
|
|
</p>
|
|
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/scripting-1.html#the-script-element" title="http://www.w3.org/TR/html5/scripting-1.html#the-script-element">
|
|
http://www.w3.org/TR/html5/scripting-1.html#the-script-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="section" class="template-tag">
|
|
|
|
<h1>
|
|
section
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a HTML5 <code>section</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/text-level-semantics.html#the-span-element" title="http://www.w3.org/TR/html5/text-level-semantics.html#the-span-element">
|
|
http://www.w3.org/TR/html5/text-level-semantics.html#the-span-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="span" class="template-tag">
|
|
|
|
<h1>
|
|
span
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Generates a <code>span</code> element.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/text-level-semantics.html#the-span-element" title="http://www.w3.org/TR/html5/text-level-semantics.html#the-span-element">
|
|
http://www.w3.org/TR/html5/text-level-semantics.html#the-span-element
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="title" class="template-tag">
|
|
|
|
<h1>
|
|
title
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
|
|
<p>
|
|
Generates the title in the HTML head. The other elements are allowed in the
|
|
<code><title></code> tag:
|
|
|
|
</p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<code>show-text</code>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<code>show-page-title</code>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>See also</h2>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<a href="http://www.w3.org/TR/html5/document-metadata.html#the-title-element" title="http://www.w3.org/TR/html5/document-metadata.html#the-title-element">
|
|
http://www.w3.org/TR/html5/document-metadata.html#the-title-element
|
|
</a>
|
|
|
|
</li>
|
|
<li>
|
|
<a href="#show-text" title="#show-text">
|
|
#show-text
|
|
</a>
|
|
|
|
</li>
|
|
<li>
|
|
<a href="#show-page-title" title="#show-page-title">
|
|
#show-page-title
|
|
</a>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="load-css-files" class="template-tag">
|
|
|
|
<h1>
|
|
load-css-files
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:ui="http://www.arsdigita.com/ui/1.0">
|
|
Invokes the foundry CSS loader. The CSS loader will parse the file
|
|
<code>conf/css-files.xml</code> to determine for which CSS an
|
|
<code><link></code> element should be added to the HTML output. For a full
|
|
explanation please refer to the <a href="#user_css-files">CSS files section</a>.
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
</article>
|
|
|
|
|
|
<article id="developer-manual">
|
|
|
|
|
|
<h1>
|
|
Developer Manual
|
|
|
|
</h1>
|
|
|
|
|
|
|
|
|
|
<section id="foundry-structure">
|
|
|
|
|
|
<h1>
|
|
The structure of Foundry
|
|
|
|
</h1>
|
|
|
|
|
|
<main xmlns="">
|
|
Placeholder
|
|
|
|
</main>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section id="coding-style">
|
|
|
|
|
|
<h1>
|
|
Coding style
|
|
|
|
</h1>
|
|
|
|
|
|
<main xmlns="">
|
|
|
|
<p>
|
|
This document describes the coding conventions for the Foundry theming engine.
|
|
|
|
</p>
|
|
|
|
<h2>Naming</h2>
|
|
|
|
<p>
|
|
The naming rules described here apply to all names: Names of layout elements,
|
|
XSL template names, EXSLT functions, files, ids and classes (in the
|
|
<code>class</code> attribute).
|
|
|
|
</p>
|
|
|
|
<p>
|
|
Use the dash "-" to separate parts of a name instead of camel case or the
|
|
underscore. For example: <code>get-setting</code> instead of <code>getSetting</code> or
|
|
<code>set_setting</code>.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
Names should be lowercase.
|
|
|
|
</p>
|
|
|
|
|
|
<h2>Namespace declarations</h2>
|
|
|
|
<p>
|
|
In the XSL files, XML namespaces are only defined at the
|
|
<code><xsl:stylesheet></code> element. The XSL namespace is the first one is
|
|
declared first. The other namespace follow in alphabetic order (ordered by their
|
|
prefix).
|
|
|
|
</p>
|
|
|
|
|
|
<h2>Indention, line length and formating</h2>
|
|
|
|
<p>
|
|
Indention is done using spaces. Indention depth is four (4) spaces per level.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
Try to keep the line length below 100 characters per line. Because of some restrictions
|
|
of XML this will be possible in every case.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
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
|
|
|
|
</p>
|
|
<pre>
|
|
<xsl:param name=example-param"
|
|
select="'example'"/>
|
|
</pre>
|
|
<p>
|
|
instead of
|
|
|
|
</p>
|
|
<pre>
|
|
<xsl:param name=example-param" select="'example'"/>
|
|
</pre>
|
|
</main>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section id="doc-system">
|
|
|
|
|
|
<h1>
|
|
The documentation system of Foundry
|
|
|
|
</h1>
|
|
|
|
|
|
<main xmlns="">
|
|
Placeholder
|
|
|
|
</main>
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
<section id="function-reference">
|
|
|
|
|
|
<h1>
|
|
XSL Templates and Function references
|
|
|
|
</h1>
|
|
|
|
|
|
|
|
|
|
|
|
The version of Foundry. Kept in sync with the version of CCM, so the first version
|
|
was be 2.2.3.
|
|
|
|
|
|
|
|
The path the to theme file. This path is used at several points to load files which are
|
|
part of the theme, like CSS files, images and fonts.
|
|
|
|
|
|
|
|
The context prefix in which CCM is installed. If CCM is installed into the ROOT context
|
|
of the servlet container, this variable will be empty.
|
|
|
|
|
|
|
|
The path on which the CCM dispatcher Servlet is mounted. Usually this is CCM
|
|
|
|
|
|
|
|
This variables stores the XML created by CCM for later access.
|
|
|
|
|
|
|
|
This variables stores the XML definition of the Foundry documentation.
|
|
|
|
|
|
|
|
Activate double click protection on buttons?
|
|
|
|
|
|
|
|
Activate double click protection on links?
|
|
|
|
|
|
|
|
The language to use as negotiated by CCM.
|
|
|
|
|
|
|
|
The languages supported by this theme. They are configured in
|
|
conf/global.xml using the <supported-languages>
|
|
element. Example for german and english:
|
|
|
|
<?xml version="1.0"?>
|
|
<foundry:configuration>
|
|
…
|
|
<supported-languages default="de">
|
|
<language locale=de">
|
|
<language locale=en">
|
|
</supported-languages>
|
|
…
|
|
</foundry:configuration>
|
|
|
|
|
|
|
|
|
|
The language to use by theming engine for static texts etc. The language is determined
|
|
as follows:
|
|
|
|
If the negotiated language is also in the supported-languages
|
|
If not the language which set by the default attribute of the
|
|
<supported-languages> is used, but only if this language
|
|
is in the supported languages.
|
|
Otherwise the first of the supported languages is used.
|
|
|
|
|
|
|
|
|
|
The name of the user agent (browser) which is used to access CCM.
|
|
|
|
|
|
|
|
Helper functions for generating the name of the colorset class.
|
|
|
|
|
|
|
|
Helper functions for retrieving the name of the content type of the current content item
|
|
from the result tree XML.
|
|
|
|
|
|
|
|
Helper template for processing arrows/links for sorting items.
|
|
|
|
|
|
|
|
Helper template for processing additional attributes in the data tree XML. They copied
|
|
literally from the XML the HTML.
|
|
|
|
|
|
|
|
The name of the template file to process.
|
|
|
|
|
|
This template is the entry point for the template parser.
|
|
|
|
|
|
|
|
Helper template for setting the id and class attributes
|
|
on a HTML element.
|
|
|
|
|
|
|
|
A helper template for generating the
|
|
<link rel="stylesheet" href="..."/> elements for loading the CSS
|
|
files.
|
|
|
|
|
|
The name of the CSS file to load
|
|
|
|
|
|
The media for which the file should be loaded. If no set, the CSS file is used for all
|
|
media types.
|
|
|
|
|
|
|
|
<section id="foundry:boolean" class="function">
|
|
|
|
<h1>
|
|
Function foundry:boolean
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
A helper function for evaluating certain string values to boolean. This function has
|
|
two purposes. First it simplifies some expressions. for example if you have a
|
|
template tag with a attribute containing a (pseudo) boolean value (attribute values
|
|
are always treated as strings) you would have to write something like:
|
|
|
|
</p>
|
|
<pre>
|
|
...
|
|
<xsl:if test="./@attr = 'true'">
|
|
...
|
|
</xsl:if>
|
|
...
|
|
</pre>
|
|
<p>
|
|
Using <code>foundry:boolean</code> this can be simplified to
|
|
|
|
</p>
|
|
<pre>
|
|
...
|
|
<xsl:if test="foundry:boolean(./@attr)">
|
|
...
|
|
</xsl:if>
|
|
...
|
|
</pre>
|
|
<p>
|
|
The more important purpose is to make the usage of boolean values more user
|
|
friendly, especially in the templates. Using <code>foundry:boolean</code> no only
|
|
<code>true</code> is evaluated to boolean <code>true</code>. A number of other
|
|
strings is also evaluated to <code>true</code>:
|
|
|
|
</p>
|
|
|
|
<ul>
|
|
|
|
<li>
|
|
<code>true</code>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<code>TRUE</code>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<code>yes</code>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<code>YES</code>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<code>t</code>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<code>T</code>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<code>y</code>
|
|
|
|
</li>
|
|
|
|
<li>
|
|
<code>Y</code>
|
|
|
|
</li>
|
|
|
|
</ul>
|
|
|
|
<p>
|
|
All other values are evaluated to <code>false</code>.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
value
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The value to evaluate.
|
|
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
boolean
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The evaluated boolean value.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:message" class="function">
|
|
|
|
<h1>
|
|
Function foundry:message
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
A helper function used by the other message functions like
|
|
<code>foundry:message-warn</code>. Concatenates the message level with the message.
|
|
|
|
</p>
|
|
|
|
<p>
|
|
This function should not be used directly. Use the other message functions instead.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
level
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<td>
|
|
message
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
xs:string
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
A message string of the form <code>[Foundry $level] $message</code> with
|
|
<code>$level</code> and <code>$message</code> replaced by the values of the
|
|
parameters.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:message-info" class="function">
|
|
|
|
<h1>
|
|
Function foundry:message-info
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
Helper function to generate an info message. This function be used together with
|
|
<code><xsl:message></code> to output a message in the CCM log. Example:
|
|
|
|
</p>
|
|
<pre>
|
|
...
|
|
<xsl:message>
|
|
<xsl:message select="foundry:message-info('Hello from Foundry')" />
|
|
</xsl:message>
|
|
</pre>
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
message
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
xs:string
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
A message string of the form <code>[Foundry INFO] $message</code> with
|
|
<code>$message</code> replaced by the value of the parameter.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:message-warn" class="function">
|
|
|
|
<h1>
|
|
Function foundry:message-warn
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
Helper function to generate an info message. This function be used together with
|
|
<code><xsl:message></code> to output a message in the CCM log warning
|
|
the administrator about some things in the theme, for example a missing
|
|
configuration file. Example:
|
|
|
|
</p>
|
|
<pre>
|
|
...
|
|
<xsl:message>
|
|
<xsl:message select="foundry:message-info('Something is strange...')" />
|
|
</xsl:message>
|
|
</pre>
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
message
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
any
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
xs:string
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
A message string of the form <code>[Foundry WARNING] $message</code> with
|
|
<code>$message</code> replaced by the value of the parameter.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:message-error" class="function">
|
|
|
|
<h1>
|
|
Function foundry:message-error
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
Helper function to generate an info message. This function be used together with
|
|
<code><xsl:message></code> to output a message in the CCM log when
|
|
something goes wrong in the theme, for example when a layout file has a wrong
|
|
structure. Example:
|
|
|
|
</p>
|
|
<pre>
|
|
...
|
|
<xsl:message>
|
|
<xsl:message select="foundry:message-info('Some error has occurred...')" />
|
|
</xsl:message>
|
|
...
|
|
</pre>
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
message
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
any
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
xs:string
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
A message string of the form <code>[Foundry ERROR] $message</code> with
|
|
<code>$message</code> replaced by the value of the parameter.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:get-attribute-value" class="function">
|
|
|
|
<h1>
|
|
Function foundry:get-attribute-value
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
A helper function for retrieving an attribute value from an element. If the
|
|
attribute is set on the current element the value of the attribute is used as
|
|
result. If the attribute is not set the <code>default-value</code> is used. This
|
|
method is used by several layout tags with optional attributes. A common use pattern
|
|
looks like this:
|
|
|
|
</p>
|
|
<pre>
|
|
<xsl:template match="example">
|
|
<xsl:variable name="width"
|
|
select="foundry:get-attribute-value(current(), 'width', '640')" />
|
|
<xsl:variable name="height"
|
|
select="foundry:get-attribute-value(current(), 'height', '480')" />
|
|
/<xsl:template>
|
|
</pre>
|
|
<p>
|
|
In this example, the element <code>example</code> has two optional attributes:
|
|
<code>with</code> and <code>height</code>. If the attribute is set in processed XML,
|
|
the value set there is used. Otherwise the default value (<code>640</code>
|
|
respectively <code>480</code>) is used. Without this function a code block like the
|
|
one in the <code>xsl:choose</code> block of this function would be necessary for
|
|
each of the variables.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
node
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
<td>
|
|
any
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<td>
|
|
attribute-name
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
<td>
|
|
any
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<td>
|
|
default-value
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
<td>
|
|
any
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
any
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The value of the attribute if it is set on the current element, the
|
|
<code>default-value</code> otherwise.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:get-setting" class="function">
|
|
|
|
<h1>
|
|
Function foundry:get-setting
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
Convenient function for calling <code>foundry:get-setting</code> with only the
|
|
module name and setting name.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
module
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The module of the settings. May be an empty string (<code>''</code>).
|
|
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<td>
|
|
setting
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The name of the setting to retrieve.
|
|
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
string
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The value of the setting.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:get-setting" class="function">
|
|
|
|
<h1>
|
|
Function foundry:get-setting
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
Convenient function for calling <code>foundry:get-setting</code> with only the
|
|
module name, the setting name and an default value.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
module
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The module of the settings. May be an empty string (<code>''</code>).
|
|
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<td>
|
|
setting
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The name of the setting to retrieve.
|
|
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<td>
|
|
default
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
A default value which is used when the setting is not configured.
|
|
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
string
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The value of the setting or the default value if the setting is not configured.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
The module of the settings. At the moment this corresponds to the name of the file
|
|
in the conf directory. The empty string as value corresponds to the
|
|
global.xml file.
|
|
|
|
|
|
|
|
|
|
The name of the setting to retrieve.
|
|
|
|
|
|
|
|
|
|
The value to use if there is no entry for the setting in the settings file.
|
|
|
|
|
|
|
|
|
|
A node from the layout template which overrides the value from the configuration.
|
|
|
|
|
|
|
|
|
|
|
|
The value of the requested setting or if no value has been set the provided default
|
|
value. If no default value has been provided the result is an empty string.
|
|
|
|
|
|
|
|
This function retrieves the value of a setting from the theme configuration. For
|
|
more informations about the configuration system of Foundry please refer to the
|
|
configuration section of the Foundry documentation.
|
|
|
|
|
|
|
|
<section id="foundry:get-static-text" class="function">
|
|
|
|
<h1>
|
|
Function foundry:get-static-text
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
Retrieves at static text. For more informations about static texts in Foundry please
|
|
refer to the static texts section in the Foundry documentation.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<h2>Parameters</h2>
|
|
|
|
<table>
|
|
|
|
<thead>
|
|
|
|
<td>
|
|
|
|
<th>Name</th>
|
|
|
|
<th>Mandatory</th>
|
|
|
|
<th>Type</th>
|
|
|
|
<th>Description</th>
|
|
|
|
</td>
|
|
|
|
</thead>
|
|
|
|
<tbody>
|
|
|
|
<td>
|
|
|
|
<td>
|
|
module
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
he module of the settings. At the moment this corresponds to the name of the file
|
|
in the <code>texts</code> directory. The empty string as value corresponds to the
|
|
<code>global.xml</code> file.
|
|
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<td>
|
|
id
|
|
|
|
</td>
|
|
|
|
<td>
|
|
yes
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
|
|
</td>
|
|
|
|
</td>
|
|
<td>
|
|
|
|
<td>
|
|
lang
|
|
|
|
</td>
|
|
|
|
<td>
|
|
no
|
|
|
|
</td>
|
|
|
|
<td>
|
|
string
|
|
|
|
</td>
|
|
|
|
<td>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The language to retrieve. Normally there is no need to set this parameter because
|
|
it is determined automatically.
|
|
|
|
</p>
|
|
|
|
</td>
|
|
|
|
</td>
|
|
|
|
</tbody>
|
|
|
|
</table>
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
string
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The requested static text. If there is no value for the requested static text in the
|
|
module provided by the module parameter the value depends if the debug mode is
|
|
enabled or not. If the debug mode is <em>not</em> not enabled the result is an empty
|
|
string. If the debug mode is enabled, a identifier of the text (the value of the
|
|
<code>id</code> parameter) is displayed. If you point the mouse pointer of the
|
|
placeholder, the complete path of the text is shown as hovering box.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:debug-enabled" class="function">
|
|
|
|
<h1>
|
|
Function foundry:debug-enabled
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
<foundry:doc-desc xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
|
|
<p>
|
|
A helper function to determine if the debug mode should be enabled. The debug mode
|
|
of foundry is automatically enabled if the theme is viewed as development theme.
|
|
|
|
</p>
|
|
|
|
</foundry:doc-desc>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
any
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
<code>true</code> if the debug mode if active, <code>false</code> otherwise.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
<section id="foundry:read-current-category" class="function">
|
|
|
|
<h1>
|
|
Function foundry:read-current-category
|
|
|
|
</h1>
|
|
|
|
|
|
<div>
|
|
|
|
|
|
</div>
|
|
|
|
|
|
|
|
<div>
|
|
|
|
<h2>Result</h2>
|
|
|
|
<h3>Result type</h3>
|
|
|
|
<p>
|
|
any
|
|
|
|
</p>
|
|
|
|
<h3>Description</h3>
|
|
|
|
<div>
|
|
|
|
<p xmlns="" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:bebop="http://www.arsdigita.com/bebop/1.0" xmlns:cms="http://www.arsdigita.com/cms/1.0" xmlns:foundry="http://foundry.libreccm.org" xmlns:nav="http://ccm.redhat.com/navigation">
|
|
The path of the current category.
|
|
|
|
</p>
|
|
|
|
</div>
|
|
|
|
</div>
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</section>
|
|
|
|
|
|
|
|
</article>
|
|
|
|
|
|
</main>
|
|
|
|
<footer>
|
|
|
|
<p>
|
|
(c) 2014 Jens Pelzetter.
|
|
|
|
</p>
|
|
|
|
</footer>
|
|
|
|
</body>
|
|
|
|
</html> |