Lire::DocBookParser.3pm

Langue: en

Autres versions - même langue

Version: 2006-07-23 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

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 (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.