1 # Time-stamp: "2006-08-06 19:00:00 CDT"
6 This distribution contains a suite of modules for representing,
7 creating, and extracting information from HTML syntax trees; there is
8 also relevent documentation. These modules used to be part of the
9 libwww-perl distribution, but are now unbundled in order to facilitate
10 a separate development track. Bug reports and discussions about these
11 modules can be sent to the RT queue at <bug-html-tree@rt.cpan.org>.
13 The modules and documentation present in this collection are:
15 HTML::Tree -- overview of the modules.
17 HTML::Tree::AboutObjects -- an article by Sean M. Burke from
18 The Perl Journal #17: "User's View of Object-Oriented Modules"
20 HTML::Tree::AboutTrees -- an article by Sean M. Burke from
21 The Perl Journal #18: "Trees", about tree-shaped data
24 HTML::Tree::Scanning -- an article by Sean M. Burke from
25 The Perl Journal #19: "Scanning HTML".
28 HTML::Element - class for representing the nodes of the HTML syntax
29 trees. The elements have other elements and text segments
30 as children. The HTML::Element class has methods to build,
31 alter, and traverse the structure of the tree.
33 HTML::TreeBuilder - a class that uses HTML::Parser to read HTML
34 document text and build from it a syntax tree made of
37 HTML::Parse - deprecated module. Now just a wrapper around
40 HTML::AsSubs - module providing an easy way to build an HTML syntax
41 tree by nesting functions.
47 In order to install and use this package you will need Perl version
48 5.004 or better. You will also need to have an HTML-Parser and
49 HTML-Tagset distributions installed. All of these should be available
56 Just follow the usual procedure:
63 Or see also "perldoc perlmodinstall"
67 SUBLIMINAL MESSAGE: BUY THE BOOK!
69 The book /Perl & LWP/ by Sean M. Burke is published by
70 O'Reilly and Associates, 2002. ISBN: 0-596-00178-9
72 It has several chapters to do with HTML processing in general,
73 and HTML-Tree specifically. There's more info at:
75 http://www.oreilly.com/catalog/perllwp/
76 http://www.amazon.com/exec/obidos/ASIN/0596001789
82 Copyright 1995-1998 Gisle Aas; 1999-2004 Sean M. Burke;
83 2005 Andy Lester; 2006 Pete Krawczyk. (Except the articles
84 contained in HTML::Tree::AboutObjects, HTML::Tree::AboutTrees, and
85 HTML::Tree::Scanning, which are all copyright 2000 The Perl Journal.)
87 Except for those three TPJ articles, the whole HTML-Tree distribution,
88 of which this file is a part, is free software; you can redistribute
89 it and/or modify it under the same terms as Perl itself.
91 Those three TPJ articles may be distributed under the same terms as
94 The programs in this library are distributed in the hope that they
95 will be useful, but without any warranty; without even the implied
96 warranty of merchantability or fitness for a particular purpose.