The Html Class

Contents:

HTML operations.

This module exports the Html class

class gramps.plugins.lib.libhtml.Html(tag='html', *args, **keywargs)[source]

Bases: list

HTML class: Manages a rooted tree of HTML objects

addDOCTYPE(name='html', public='PUBLIC', external_id='', *args)[source]

Add a DOCTYPE statement to the start of the list

Parameters:

  • name (string) – name of this DOCTYPE. Defaults to “html”

  • external_id (string) – external identifier of this DOCTYPE. Defaults to XHTML 1.0 STRICT

  • args (object) – 0 or more positional parameters to be added to this DOCTYPE.

addXML(version=1.0, encoding='UTF-8', standalone='no')[source]

Add an XML statement to the start of the list for this object

Parameters:

  • version (decimal number) – version of XML to be used. Defaults to 1.0

  • encoding (string) – encoding method to be used. Defaults to “UTF-8”

  • standalone (string) – “yes” or “no”. Defaults to “no”

append(value)[source]

Append a new value

property attr

Returns HTML attributes for this object

Return type:

string

Returns:

HTML attributes

close
cms
static doctype(name='HTML', public='', external_id='')[source]

Build and return a DOCTYPE statement

Parameters:

  • name (string) – name of this DOCTYPE. Defaults to “html”

  • public (string) – class of this DOCTYPE. Defaults to ‘PUBLIC

  • external_id (string) – external identifier of this DOCTYPE. Defaults to XHTML 1.0 STRICT

  • args (object) – 0 or more positional parameters to be added to this DOCTYPE.

extend(value)

Append a new value

static head(title=None, encoding='utf-8', html5=True, *args, **keywargs)[source]

Build and return a properly-formated <head> object

Parameters:

  • title (string or None) – title for HTML page. Default=None. If None no title tag is written

  • encoding (string) – encoding to be used. Default = ‘utf-8’

  • html5 – generate html5 syntax. Default = True. Set to False if pre-html5 syntax required

Return type:

reference to new Html instance

Returns:

reference to the newly-created Html instances for <head> object

static html(xmlns='http://www.w3.org/1999/xhtml', lang='en', *args, **keywargs)[source]

Build and return a properly-formated <html> object

Parameters:

  • xmlns (string) – XML namespace string. Default = ‘http://www.w3.org/1999/xhtml’

  • lang (string) – language to be used. Defaul = ‘en’

Return type:

reference to new Html instance

Returns:

reference to the newly-created Html instances for <html> object

indent
inline
property inside

Returns list of items between opening and closing tags

Return type:

list

Returns:

list of items between opening and closing HTML tags

items
iteritems()

Iterator function: returns a generator that performs an insertion-order tree traversal and yields each item found.

iterkeys()

Iterator function: returns a generator that performs an insertion-order tree traversal and yields each item found.

itervalues()

Iterator function: returns a generator that performs an insertion-order tree traversal and yields each item found.

static page(title=None, encoding='utf-8', lang='en', html5=True, cms=False, *args, **keywargs)[source]

This function prepares a new Html class based page and returns

Parameters:

  • title (string) – title for HTML page. Default=None

  • encoding (string) – encoding to be used. Default = ‘utf-8’

  • lang (string) – language to be used. Defaul = ‘en’

  • html5 – generate html5 syntax. Default = True. Set to False if pre-html5 syntax required

Return type:

three object references

Returns:

references to the newly-created Html instances for page, head and body

remove(value)

Overload function for - and -= operators :type value: object :param value: object to be removed

Return type:

object reference

Returns:

reference to object with value removed

replace(cur_value, value)[source]

Replace current value with new value

Parameters:

  • cur_value (object) – value of object to be replaced

  • value (object) – replacement value

Return type:

object reference

Returns:

reference to object with new value added

property tag

Returns HTML tag for this object

Return type:

string

Returns:

HTML tag

write(method=<built-in function print>, indent='\t', tabs='')[source]

Output function: performs an insertion-order tree traversal and calls supplied method for each item found.

Parameters:

  • method (function reference) – function to call with each item found

  • indenf – string to use for indentation. Default = ‘ ‘ (tab)

  • tabs (string) – starting indentation

static xmldecl(version=1.0, encoding='UTF-8', standalone='no')[source]

Build and return an XML declaration statement

Parameters:

  • version (decimal number) – version of XML to be used. Defaults to 1.0

  • encoding (string) – encoding method to be used. Defaults to “UTF-8”

  • standalone (string) – “yes” or “no”. Defaults to “no”