.TH "Eliom_content" 3o 2012-06-11 OCamldoc ""
.SH NAME
Eliom_content \- This module provides the creation of valid XML content, i.e.
.SH Module
Module   Eliom_content
.SH Documentation
.sp
Module
.BI "Eliom_content"
 : 
.B sig  end

.sp
This module provides the creation of valid XML content, i\&.e\&. XML, XHTML, SVG,
and (X)HTML5\&.
XML tree manipulation within Eliom is based on the TyXML library
but use a custom representation for XML values (see
.B Eliom_content\&.Xml
)\&. Then, 
.B Eliom_content
redefines the three high level
interfaces (
.B Eliom_content\&.Svg
, 
.B Eliom_content\&.Html5
and 
.B Eliom_content\&.Xhtml
) that are provided by
TyXML for valid XML tree creation and printing\&.
.sp
Modules 
.B Eliom_content\&.Html5
, 
.B Eliom_content\&.Svg
contain two implementing
sub\-modules: 
.B F
and 
.B D
\&.
.sp

.B Functional semantics
.sp
The 
.B F
modules provide functions to create elements with functional
semantics: On the one hand side, those values do not have an identity,
which means utilizations of those values are independent of each other\&.
On the other hand side, they cannot be referred to, neither by client code
when created on the server, nor for usage in the functions of
.B Eliom_content\&.Html5\&.To_dom
and 
.B Eliom_content\&.Html5\&.Manip
\&.
.sp

.B DOM semantics
.sp
The 
.B D
modules provide functions to create elements with DOM semantics:
Firstly, they behave like DOM nodes, e\&.g\&. they can only be added once to the
DOM tree even when appended several times\&.
Secondly, those values have an identity, which means they can be referred to
on the client side (by 
.B %variable
) or used with the functions
.B Eliom_content\&.Html5\&.To_dom
and 
.B Eliom_content\&.Html5\&.Manip
\&.
.sp
In case of doubt, use the modules with DOM\-like semantics 
.B D
\&.
.sp

.sp

.sp
.sp
.I module type Forms = 
.B sig  end

.sp
Abstract signature for links and forms creation functions\&. For
concrete instance see 
.B Eliom_content\&.Html5
, 
.B Eliom_content\&.Xhtml
or 
.B Eliom_content\&.Html_text
\&.
.sp

.sp
.I module Xml : 
.B sig  end

.sp
Low\-level XML manipulation\&.
.sp

.sp
.I module Svg : 
.B sig  end

.sp
Building and pretty\-printing valid SVG tree\&.
.sp

.sp
.I module Html5 : 
.B sig  end

.sp
Building and printing valid (X)HTML5 tree\&.
.sp

.sp
.I module Xhtml : 
.B sig  end

.sp
Building valid XHTML\&.
.sp

.sp
.I module Html_text : 
.B sig  end

.sp

.sp