Emacs can be compiled with built-in libxml2 support.
libxml-available-p
¶This function returns non-nil
if built-in libxml2 support is
available in this Emacs session.
When libxml2 support is available, the following functions can be used to parse HTML or XML text into Lisp object trees.
libxml-parse-html-region
&optional start end base-url discard-comments ¶This function parses the text between start and end as HTML, and returns a list representing the HTML parse tree. It attempts to handle real-world HTML by robustly coping with syntax mistakes.
If start or end are nil
, they default to the values
from point-min
and point-max
, respectively.
The optional argument base-url, if non-nil
, should be
used for warnings and errors reported by the libxml2 library,
but Emacs currently calls the library with errors and warnings
disabled, so this argument is not used.
If the optional argument discard-comments is non-nil
,
any top-level comment is discarded. (This argument is obsolete and
will be removed in future Emacs versions. To remove comments, use the
xml-remove-comments
utility function on the data before you
call the parsing function.)
In the parse tree, each HTML node is represented by a list in which the first element is a symbol representing the node name, the second element is an alist of node attributes, and the remaining elements are the subnodes.
The following example demonstrates this. Given this (malformed) HTML document:
<html><head></head><body width=101><div class=thing>Foo<div>Yes
A call to libxml-parse-html-region
returns this DOM
(document object model):
(html nil (head nil) (body ((width . "101")) (div ((class . "thing")) "Foo" (div nil "Yes"))))
shr-insert-document
dom ¶This function renders the parsed HTML in dom into the current
buffer. The argument dom should be a list as generated by
libxml-parse-html-region
. This function is, e.g., used by
EWW in The Emacs Web Wowser Manual.
libxml-parse-xml-region
&optional start end base-url discard-comments ¶This function is the same as libxml-parse-html-region
, except
that it parses the text as XML rather than HTML (so it is stricter
about syntax).