XSLT Reference

`http://www.inventic.eu/strings`

String functions.

<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:axstr="http://www.inventic.eu/strings" extension-element-prefixes="... axstr">
  <xsl:value-of select="str:makeLower('XX')"/>
</xsl:stylesheet>

Function	Description
`makeLower(value)`	convert string to lower
`makeUpper(value)`	convert string to upper
`makeFirstCharUpper(value)`	convert first char to upper
`makeFirstCharLower(value)`	convert first char to lower
`convertCamelCaseToXmlStyle(value,separator='-')`	convert camel case to xml style
`convertXmlStyleToCamelCase(value,firstLower,separator='-')`	convert xml style to camel case
`convertStringStyle(value,style,defaultStyle)`	convert value based on `style`. If `style` is empty, use `default style`
`makeEnglishPlural(value)`	make plural from singular word (car →cars)
`makeEnglishSingular(value)`	make singular from plural word (cars →car)
`makeEnglishPluralMultiword(value)`	make plural from singular word (NewCar →NewCars)
`makeEnglishSingularMultiword(value)`	make singular from plural word (NewCars →NewCar)
`replace(str,from,to)`	replace `from` in string to `to` value
`endsWith(str,val)`	test if passed string ends with `val`
`count(str,val)`	return number of occurances of `val` in `str`
`substringAfterLast(str,val)`	returns string after last occurance of val
`substringBeforeLast(str,val)`	returns string before last occurance of val
`firstNonEmpty(str1,str2,...)`	returns first non-empty value
`namespaceGetPath(value)`	get namespace from full path
`namespaceGetLocalName(value)`	get local name from fullpath
`namespaceConcatPath(v1,v2)`	concate two paths as namespace
`namespaceRemoveStartingSlash(v1)`	removes starting `\` from namespace`
`namespaceSubtractTwoPaths(ns1,ns2,direction)`	removes ns2 from ns1 from direction("begin" or "end"). \a\b\c - \a\b = \c
`namespaceRelativePath(ns1,ns2)`	returns relative path from ns1 to ns2. In case ns2 is independent NS, returns absolute NS2 path. \a\b, \a\b\c = c

`http://www.inventic.eu/system`

System functions.

<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:axsys="http://www.inventic.eu/system" extension-element-prefixes="... axsys">
  <axsys:call-template name="{$param}"/>
</xsl:stylesheet>

Element	Description
`<call-template name="{$param}"/>`	ability to call template with dynamic param name

`http://www.skipper18.com/orm-attributes`

Functions for manipulating with ORM Attributes.

<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xlns:ormd="http://www.skipper18.com/orm-attributes" extension-element-prefixes="... ormd">
  ...
</xsl:stylesheet>

Function	Description
`ConvertAttributesToOrmAttributes(encapsule,mask,xpath)`	convert attributes to orm attributes
`ConvertXpathItemsToOrmAttributes(encapsule,mask,xpath)`	convert xpath items to orm attribute
`CreateOrmAttributesFromValues(encapsule)`	create orm attributes from passed values
-- `value(value,name)`	-- inner element, attribute by value
-- `xpath(select,name)`	-- inner element, attribute by xpath
`CreateAttributeFromOrmAttribute(attribute,orm-attribute)`	create attribute from orm attribute
`ConvertOrmAttributesToAttributes(mask,xpath,class-kind-filter)`	convert orm attributes to attributes
`ConvertOrmAttributesToChildElements(mask,xpath,class-kind-filter,type-kind-filter,last-as-attribute)`	convert orm attribute to child elements
`ExistsOrmAttributeByFullName(full-name)`	test if exists specified orm attribute

Note: Each function attribute can be passed as xslt param, inner element and in some cases as inner-value.

Note2: class-kind-filter can have values: container,scalar,struct,value (based on orm attribute element class)

Note3: type-kind-filter can have values: container,scalar (based on orm attribute element type)

#this statement
<ormd:ConvertAttributesToOrmAttributes encapsule='true' mask='name()="attr1"'/>

#is equivalent to this one
<ormd:ConvertAttributesToOrmAttributes>
  <ormd:encapsule>true</ormd:encapsule>
  <ormd:mask>name()='attr1'</ormd:mask>
</ormd:ConvertAttributesToOrmAttributes>

`http://www.skipper18.com/annotations`

Functions for manipulation with annotations.

<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xlns:ann="http://www.skipper18.com/annotations" extension-element-prefixes="... ann">
  ...
</xsl:stylesheet>

Function	Description
`ConvertAttributesToAnnotationElement(*params)`	convert attributes to annotation
`ConvertXpathToAnnotationElement(*params)`	convert xpath items to annotation
`ConvertElementToAnnotationElement(*params)`	convert element to annotation element
[`encapsule,mask,xpath,name,always-create,element,prefix,remove-prefix,annotation-element,ast-param,divider,encapsuler`]	\*params
`ConvertAnnotationElementToAttribute(attribute,full-name)`	create attribute from annotation element by name
`ConvertAnnotationElementsToAttributes(*params)`	convert annotation elements to attributes
`ConvertAnnotationElementsToChildElements(*params)`	convert annotation elements to child element
`ConvertAnnotationElementsToChildElementsAndAttributes(*params)`	convert annotation elements to child element and attributes
[`mask, child-mask, xpath, full-name, encapsuler, encapsuler-ns,default-value-element,default-value-attribute`]	\*params (value-elem/value-attr is for default attr/elem for annotation-value)
`ExistsAnnotationElementByFullName(full-name, sub-path)`	test if exists specified annotation (element)
`ExistsAnnotationElementByFullNameFce(full-name, sub-path)`	test if exists specified annotation (function)
`GetAnnotationValueAsString(full-name, sub-path)`	convert annotation element to single text value (sub-path by @name attribute) (element)
`GetAnnotationValueAsStringFce(full-name, sub-path)`	convert annotation element to single text value (sub-path by @name attribute) (function)

Note: Each function attribute can be passed as xslt param, inner element and in some cases as inner-value.

Note: When xpath contains ".", function is evaluate on current element

#this statement
<ann:ConvertAttributesToAnnotationElement encapsule='true' mask='name()="attr1"'/>

#is equivalent to this one
<ann:ConvertAttributesToAnnotationElement>
  <ann:encapsule>true</ann:encapsule>
  <ann:mask>name()='attr1'</ann:mask>
</ann:ConvertAttributesToAnnotationElement>

`http://www.skipper18.com/extensions-support`

Functions for manipulation with complext extensions.

<?xml version="1.0"?>
<xsl:stylesheet version="1.0" xmlns:skext="http://www.skipper18.com/extensions-support" extension-element-prefixes="... skext">
  ...
</xsl:stylesheet>

common extension + behavior definition:

<skext:ConvertFromOrmAttributesToExtension extension="Gedmo" output="gedmo">
  <behavior name="Sluggable">
    <field name="slug" format="XmlYml" allow-empty="true">
       ...
    </field>
  </behavior>

  <behavior name="...">
		<entity name=""> ...
    <field name=""> ...
    <non-orm-field name=""> ...
    <field-list name="" storage-elements="entities" storage-element="entity" storage-params="auto"> ...
    <association-list name=""> ...
    <non-orm-field-list name=""> ...
  </behavior>
</skext:ConvertFromOrmAttributesToExtension>

Xslt attributes	Description
`allow-empty`	whether export this annotation if no parameter inside is filled [default false]
`format`	for which export format use this export
`output`	name of output element to convert behavior [default is lowecased extension name]
`storage-elements`	name of element storing group of items
`storage-element`	name of element storing single item
`storage-params`	where to get referenced item name [auto,none,entity,field]. None/Entity/Auto+norules = inner element, field=`Name` attribute

Xslt element	Description
`extension`	group of extensions in orm-attributes (gedmo, custom-extensions,....)
`behavior`	single behavior in group of extensions (sluggable in gedmo)
`entity`	parameters stored inside entity annotation
`field`	parameters stored inside field annotation

parameters of behaviors

<skext:ConvertFromOrmAttributesToExtension extension="Gedmo">
  <behavior name="...">
    <entity name="...">
       <parameter name="repository" alias="RepoAlias" type="string"/>
       <parameter name="callback-test" type="callback-value" from-template="xx" to-template="yy"/>
    </entity>
  </behavior>
</skext:ConvertFromOrmAttributesToExtension>

Xslt element	Description
`parameter`	string parameter
`alias`	how to store this parameter in Orm attributes [default = name ]
`type`	type of parameter [string,list,csv,elements,callback-value, callback-standalone]
`from-template`	xslt template name to generate callback value in FROM direction
`to-template`	xslt template name to generate callback value in TO direction