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.
HTMLDocument.Doctype (3kaya)
HTMLDocument.WhiteList (3kaya)
HTMLDocument.readFromString (3kaya)
HTMLDocument.string (3kaya)