DocBookParser(3pm)      LogReport's Lire Documentation      DocBookParser(3pm)


NAME
       Lire::XMLParser - Base DocBook parser.

SYNOPSIS
           package MyParser;

           use base qw/ Lire::XMLParser /;

DESCRIPTION
       This package contains a Lire::XMLParser DocBook parser. It defines the
       relevant "_start", "_end" and "_char" methods for the DocBook subset
       used by Lire. All defined handlers have the form "dbk_name_start",
       "dbk_name_end" and "dbk_name_char" (when the element accepts PCDATA
       content).

       Its base functionality is to collect the DocBook markup for later use.
       It will subclassed most of the time.

CLIENT METHODS
   dbk_init()
       Subclasses should call this method whenever the state of the DocBook
       parse should start. This is called from the parse_start() method when
       the parser is used standalone.

   dbk_string()
       Returns the DocBook XML accumulated by the parser. This is returned
       from parse_end() method when used standalone.

XML SPECIFICATIONS METHODS IMPLEMENTATION
   namespaces()
       DocBook doesn't use namespace, so this method returns an empty hash
       reference.

   elements_spec()
       Returns the elements specification for the DocBook subset supported by
       Lire.

SEE ALSO
        Lire::XMLParser(3pm), Lire::ReportParser::AsciiDocBookFormatter(3pm),
        Lire::ReportParser::HtmlDocBookFormatter(3pm)

AUTHOR
         Francis J. Lacoste <flacoste@logreport.org>

VERSION
       $Id: DocBookParser.pm,v 1.4 2006/07/23 13:16:29 vanbaal Exp $

COPYRIGHT
       Copyright (C) 2004 Stichting LogReport Foundation
       LogReport@LogReport.org

       This file is part of Lire.

       Lire is free software; you can redistribute it and/or modify it under
       the terms of the GNU General Public License as published by the Free
       Software Foundation; either version 2 of the License, or (at your
       option) any later version.

       This program is distributed in the hope that it will be useful, but
       WITHOUT ANY WARRANTY; without even the implied warranty of
       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
       General Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program (see COPYING); if not, check with
       http://www.gnu.org/copyleft/gpl.html.

Lire 2.1.1                        2020-07-07                DocBookParser(3pm)