## XML Template Functions

XML Template Functions — Functions to create and parse glabels XML template nodes and files

## Synopsis

    #include <libglabels/xml-templates.h>

    GList *             lgl_xml_template_read_templates_from_file
                                                            (const gchar *utf8_filename);
    GList *             lgl_xml_template_parse_templates_doc
                                                            (const xmlDocPtr templates_doc);
    lglTemplate *       lgl_xml_template_parse_template_node
                                                            (const xmlNodePtr template_node);
    gint                lgl_xml_template_write_templates_to_file
                                                            (GList *templates,
                                                             const gchar *utf8_filename);
    gint                lgl_xml_template_write_template_to_file
                                                            (const lglTemplate *template,
                                                             const gchar *utf8_filename);
    void                lgl_xml_template_create_template_node
                                                            (const lglTemplate *template,
                                                             xmlNodePtr root,
                                                             const xmlNsPtr ns);

## Description

This section describes a number of functions for creating and parsing glabels XML template nodes and files. Template nodes are used in both template files and document files.

## Details

### lgl_xml_template_read_templates_from_file ()

    GList *             lgl_xml_template_read_templates_from_file
                                                            (const gchar *utf8_filename);

Read glabels templates from template file.

`utf8_filename` : | Filename of papers file (name encoded as UTF-8)
Returns : | a list of lglTemplate structures.

### lgl_xml_template_parse_templates_doc ()

    GList *             lgl_xml_template_parse_templates_doc
                                                            (const xmlDocPtr templates_doc);

Read glabels templates from a libxml xmlDocPtr tree.

`templates_doc` : | libxml xmlDocPtr tree, representing template file.
Returns : | a list of lglTemplate structures.

### lgl_xml_template_parse_template_node ()

    lglTemplate *       lgl_xml_template_parse_template_node
                                                            (const xmlNodePtr template_node);

Read a single glabels template from a libxml xmlNodePtr node.

`template_node` : | libxml xmlNodePtr template node from a xmlDocPtr tree.
Returns : | a pointer to a newly created lglTemplate structure.

### lgl_xml_template_write_templates_to_file ()

    gint                lgl_xml_template_write_templates_to_file
                                                            (GList *templates,
                                                             const gchar *utf8_filename);

Write a list of lglTemplate structures to a glabels XML template file.

`templates` : | List of lglTemplate structures
`utf8_filename` : | Filename of templates file (name encoded as UTF-8)
Returns : | the number of bytes written or -1 in case of failure

### lgl_xml_template_write_template_to_file ()

    gint                lgl_xml_template_write_template_to_file
                                                            (const lglTemplate *template,
                                                             const gchar *utf8_filename);

Write a single lglTemplate structures to a glabels XML template file.

`template` : | lglTemplate structure to be written
`utf8_filename` : | Filename of templates file (name encoded as UTF-8)
Returns : | the number of bytes written or -1 in case of failure

### lgl_xml_template_create_template_node ()

    void                lgl_xml_template_create_template_node
                                                            (const lglTemplate *template,
                                                             xmlNodePtr root,
                                                             const xmlNsPtr ns);

Add a single lglTemplate child node to given xmlNodePtr.

`template` : | lglTemplate structure to be written
`root` : | parent node to receive new child node
`ns` : | a libxml xmlNsPtr