Package COM.INFORMATIMAGO.COMMON-LISP.HTML-PARSER.PARSE-HTML


This package implements a simple HTML parser.

Example:

        (parse-html-string "&lt;html&gt;&lt;head&gt;&lt;title&gt;Test&lt;/title&gt;&lt;/head&gt;
        &lt;body&gt;&lt;h1&gt;Little Test&lt;/h1&gt;
        &lt;p&gt;How dy? &lt;a href=\"/check.html\"&gt;Check this&lt;/a&gt;&lt;/p&gt;
        &lt;ul&gt;&lt;li&gt;one&lt;li&gt;two&lt;li&gt;three&lt;/ul&gt;&lt;/body&gt;&lt;/html&gt;")
        --> ((:html nil (:head nil (:title nil "Test")) "
            " (:body nil (:h1 nil "Little Test") "
            " (:p nil "How dy? " (:a (:href "/check.html") "Check this")) "
            " (:ul nil (:li nil "one" (:li nil "two" (:li nil "three")))))))

License:

    AGPL3
    
    Copyright Pascal J. Bourguignon 2003 - 2012
    
    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as published by
    the Free Software Foundation, either version 3 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 Affero General Public License for more details.
    
    You should have received a copy of the GNU Affero General Public License
    along with this program.
    If not, see <http://www.gnu.org/licenses/>

(html-attribute html key)

function

RETURN: The ATTRIBUTE named KEY in the HTML element.

(html-attributes html)

function

RETURN: The ATTRIBUTES of the HTML element.

(html-contents html)

function

RETURN: The CONTENTS of the HTML element.

(html-tag html)

function

RETURN: The TAG of the HTML element.

(parse-html-file pathname &key verbose external-format)

function

DO:                 Parse the HTML file PATHNAME.
VERBOSE:            When true, writes some information in the *TRACE-OUTPUT*.
EXTERNAL-FORMAT:    The external-format to use to open the HTML file.
RETURN:             A list of html elements.
SEE ALSO:           HTML-TAG, HTML-ATTRIBUTES, HTML-ATTRIBUTE, HTML-CONTENTS.

(parse-html-string string &key start end verbose)

function

DO:                 Parse the HTML in the STRING (between START and END)
VERBOSE:            When true, writes some information in the *TRACE-OUTPUT*.
RETURN:             A list of html elements.
SEE ALSO:           HTML-TAG, HTML-ATTRIBUTES, HTML-ATTRIBUTE, HTML-CONTENTS.

(unparse-html html &optional stream)

function

Writes back on STREAM the reconstituted HTML source.

(write-html-text html &optional stream)

function

Writes on STREAM a textual rendering of the HTML.
Some reStructuredText formating is used.
Simple tables are rendered, but colspan and rowspan are ignored.