NAME

       HTMLDocument::readFromTemplate - Convert a HTML template to HTML

SYNOPSIS

       Void  readFromTemplate(  ElementTree  location,  String  input,  WhiteList safety, Doctype
       doctype, Dict<String, ElementTree([Pair<String, String> ])>  templates )

ARGUMENTS

       location The location in the document to append the converted String

       input The String to convert

       safety The allowed elements and attributes

       doctype The document type of the input string. This is independent of the document type of
       the  document  and  controls  certain  aspects of parsing - for example, if the doctype is
       HTML4Strict , the end tags for p or td elements may be omitted, and the code will be case-
       insensitive.  As  usual, parsing with XHTML strictness will be quicker. The TagSoup option
       is equivalent to HTML4Strict - templates should be good quality!

       templates A dictionary of templating functions. The key is the name of the templating tag,
       and  the  value  is  the  function  to call upon seeing that tag (which will be passed the
       templating tags attributes as a list of pairs).

DESCRIPTION

       Convert a HTML template String to HTML. An Exception will be thrown if the  parser  cannot
       construct  an unambiguous tree from the string, and it is considerably less forgiving than
       the parsers in most web browsers. (On the other hand, it's a bit more forgiving in  places
       than a strict XML parser, especially if the HTML4Strict doctype is used).

       A  HTML  template  String contains empty tags with user-defined names. These tags are then
       replaced with the output of the function defined for that tag in the templates dictionary.

       Read the HTMLDocument.WhiteList (3kaya) documentation for important information on  safety
       when  converting  these Strings, and bear in mind that allowing user-supplied data to call
       templating functions is only as secure as the allowed templating functions.

AUTHORS

       Kaya standard library by Edwin Brady, Chris Morris  and  others  (kaya@kayalang.org).  For
       further information see http://kayalang.org/

LICENSE

       The Kaya standard library is free software; you can redistribute it and/or modify it under
       the terms of the GNU Lesser General Public License (version 2.1 or any later  version)  as
       published by the Free Software Foundation.

RELATED

       HTMLDocument.Doctype (3kaya)
       HTMLDocument.WhiteList (3kaya)
       HTMLDocument.readFromString (3kaya)
       HTMLDocument.string (3kaya)