xacobeo(1p) [debian man page]

XACOBEO(1p)						User Contributed Perl Documentation					       XACOBEO(1p)

NAME

       xacobeo - Graphical interface for running XPath queries.

SYNOPSIS

       xacobeo [OPTION]... [file [xpath]]

       Options:

	  -h, --help		brief help message
	  -v, --version 	display the version of Xacobeo, XML::LibXML and libxml2
				that are used and exit
	  --html		parse the input file as an HTML document

       Where file is a XML document and xpath a XPath query.

OPTIONS

       --help  Print a brief help message and exits.

       --html  Parse the file in the command line using the HTML parser.

DESCRIPTION

       This program provides a simple graphical user interface (GUI) for executing XPath queries and seeing their results.

       The GUI tries to provide all the elements that are needed in order to write, test and execute XPath queries without too many troubles. It
       displays the Document Object Model (DOM) and the namespaces used. The program registers the namespaces automatically and each element is
       displayed with its associated namespaces. All is performed with the idea of being able of running an XPath query as soon as possible
       without having to fight with the document's namespaces and by seeing automatically under which namespace each element is.

       This program is not an XML editor, at least not at this point, it's meant to be used for constructing and executing XPath queries.

RATIONALE

       The main idea behind this application is to provide a simple way for building XPath queries that will be latter integrated in to a program
       or XSLT transformation paths. Therefore, this program goal is to load an XML document and to display it as an XML parser sees it. Thus each
       node element is prefixed with its namespace.

IMPLEMENTATION

       This program uses XML::LibXML (libxml2) for all XML manipulations and Gtk2 for the graphical interface.

LIMITATIONS

       For the moment, the program focuses only on XPath and doesn't allow the XML document to be edited.

AUTHOR

       Emmanuel Rodriguez <potyl@cpan.org>.

COPYRIGHT AND LICENSE

       Copyright (C) 2008,2009 by Emmanuel Rodriguez.

       This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or,
       at your option, any later version of Perl 5 you may have available.

perl v5.14.2							    2011-11-16							       XACOBEO(1p)

Template::Plugin::XML::XPath(3pm)			User Contributed Perl Documentation			 Template::Plugin::XML::XPath(3pm)

NAME

       Template::Plugin::XML::XPath - Plugin interface to XML::XPath

SYNOPSIS

	   # load plugin and specify XML file to parse
	   [% USE xpath = XML.XPath(xmlfile) %]
	   [% USE xpath = XML.XPath(file => xmlfile) %]
	   [% USE xpath = XML.XPath(filename => xmlfile) %]

	   # load plugin and specify XML text to parse
	   [% USE xpath = XML.XPath(xmltext) %]
	   [% USE xpath = XML.XPath(xml => xmltext) %]
	   [% USE xpath = XML.XPath(text => xmltext) %]

	   # then call any XPath methods (see XML::XPath docs)
	   [% FOREACH page = xpath.findnodes('/html/body/page') %]
	      [% page.getAttribute('title') %]
	   [% END %]

	   # define VIEW to present node(s)
	   [% VIEW repview notfound='xmlstring' %]
	      # handler block for a <report>...</report> element
	      [% BLOCK report %]
		 [% item.content(view) %]
	      [% END %]

	      # handler block for a <section title="...">...</section> element
	      [% BLOCK section %]
	      <h1>[% item.getAttribute('title') | html %]</h1>
	      [% item.content(view) %]
	      [% END %]

	      # default template block passes tags through and renders
	      # out the children recursivly
	      [% BLOCK xmlstring;
		 item.starttag; item.content(view); item.endtag;
	      END %]

	      # block to generate simple text
	      [% BLOCK text; item | html; END %]
	   [% END %]

	   # now present node (and children) via view
	   [% repview.print(page) %]

	   # or print node content via view
	   [% page.content(repview) %]

DESCRIPTION

       This is a Template Toolkit plugin interfacing to the XML::XPath module.

       All methods implemented by the XML::XPath modules are available.  In addition, the XML::XPath::Node::Element module implements
       present($view) and content($view) methods method for seamless integration with Template Toolkit VIEWs.  The XML::XPath::Node::Text module
       is also adorned with a present($view) method which presents itself via the view using the 'text' template.

       To aid the reconstruction of XML, methods starttag and endtag are added to XML::XPath::Node::Element which return the start and end tag for
       that element.  This means that you can easily do:

	 [% item.starttag %][% item.content(view) %][% item.endtag %]

       To render out the start tag, followed by the content rendered in the view "view", followed by the end tag.

AUTHORS

       This plugin module was written by Andy Wardley.

       The XML::XPath module is by Matt Sergeant.

COPYRIGHT

       Copyright (C) 1996-2006 Andy Wardley.  All Rights Reserved.

       This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

       Template::Plugin, XML::XPath, XML::Parser

perl v5.8.8							    2008-03-01					 Template::Plugin::XML::XPath(3pm)