blob: 1ef7dc90398bd0c6830b4c1d1450177202e087b4 [file] [log] [blame]
Daniel Veillard1177ca42003-04-26 22:29:54 +00001<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml">
4 <head>
5 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1" />
6 <link rel="SHORTCUT ICON" href="/favicon.ico" />
7 <style type="text/css">
Daniel Veillard373a4752002-02-21 14:46:29 +00008TD {font-family: Verdana,Arial,Helvetica}
9BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
10H1 {font-family: Verdana,Arial,Helvetica}
11H2 {font-family: Verdana,Arial,Helvetica}
12H3 {font-family: Verdana,Arial,Helvetica}
Daniel Veillardb8cfbd12001-10-25 10:53:28 +000013A:link, A:visited, A:active { text-decoration: underline }
Daniel Veillard1177ca42003-04-26 22:29:54 +000014</style>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +000015 <title>The XML C parser and toolkit of Gnome
16</title>
Daniel Veillard1177ca42003-04-26 22:29:54 +000017 </head>
18 <body bgcolor="#8b7765" text="#000000" link="#000000" vlink="#000000">
19 <table border="0" width="100%" cellpadding="5" cellspacing="0" align="center">
20 <tr>
Daniel Veillard6c57dca2003-09-03 10:10:51 +000021 <td width="120">
22 <a href="http://swpat.ffii.org/">
Daniel Veillarde8ba84e2003-11-18 13:54:15 +000023 <img src="epatents.png" alt="Action against software patents" />
Daniel Veillard6c57dca2003-09-03 10:10:51 +000024 </a>
25 </td>
Daniel Veillard1177ca42003-04-26 22:29:54 +000026 <td width="180">
27 <a href="http://www.gnome.org/">
Daniel Veillarde8ba84e2003-11-18 13:54:15 +000028 <img src="gnome2.png" alt="Gnome2 Logo" />
Daniel Veillard1177ca42003-04-26 22:29:54 +000029 </a>
30 <a href="http://www.w3.org/Status">
Daniel Veillarde8ba84e2003-11-18 13:54:15 +000031 <img src="w3c.png" alt="W3C Logo" />
Daniel Veillard1177ca42003-04-26 22:29:54 +000032 </a>
33 <a href="http://www.redhat.com/">
Daniel Veillarde8ba84e2003-11-18 13:54:15 +000034 <img src="redhat.gif" alt="Red Hat Logo" />
Daniel Veillard1177ca42003-04-26 22:29:54 +000035 </a>
36 <div align="left">
37 <a href="http://xmlsoft.org/">
Daniel Veillarde8ba84e2003-11-18 13:54:15 +000038 <img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" />
Daniel Veillard1177ca42003-04-26 22:29:54 +000039 </a>
40 </div>
41 </td>
42 <td>
43 <table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000">
44 <tr>
45 <td>
46 <table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd">
47 <tr>
48 <td align="center">
Daniel Veillardd4cfcef2004-05-06 18:55:27 +000049 <h1>The XML C parser and toolkit of Gnome
50</h1>
51 <h2>libxml
52</h2>
Daniel Veillard1177ca42003-04-26 22:29:54 +000053 </td>
54 </tr>
55 </table>
56 </td>
57 </tr>
58 </table>
59 </td>
60 </tr>
61 </table>
62 <table border="0" cellpadding="4" cellspacing="0" width="100%" align="center">
63 <tr>
64 <td bgcolor="#8b7765">
65 <table border="0" cellspacing="0" cellpadding="2" width="100%">
66 <tr>
67 <td valign="top" width="200" bgcolor="#8b7765">
68 <table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000">
69 <tr>
70 <td>
71 <table width="100%" border="0" cellspacing="1" cellpadding="3">
72 <tr>
73 <td colspan="1" bgcolor="#eecfa1" align="center">
74 <center>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +000075 <b>Main Menu
76</b>
Daniel Veillard1177ca42003-04-26 22:29:54 +000077 </center>
78 </td>
79 </tr>
80 <tr>
81 <td bgcolor="#fffacd">
82 <form action="search.php" enctype="application/x-www-form-urlencoded" method="get">
83 <input name="query" type="text" size="20" value="" />
84 <input name="submit" type="submit" value="Search ..." />
85 </form>
86 <ul>
87 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +000088 <a href="index.html">Home
89</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +000090 </li>
91 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +000092 <a href="intro.html">Introduction
93</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +000094 </li>
95 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +000096 <a href="FAQ.html">FAQ
97</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +000098 </li>
99 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000100 <a href="docs.html" style="font-weight:bold">Developer Menu
101</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000102 </li>
103 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000104 <a href="bugs.html">Reporting bugs and getting help
105</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000106 </li>
107 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000108 <a href="help.html">How to help
109</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000110 </li>
111 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000112 <a href="downloads.html">Downloads
113</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000114 </li>
115 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000116 <a href="news.html">News
117</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000118 </li>
119 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000120 <a href="XMLinfo.html">XML
121</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000122 </li>
123 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000124 <a href="XSLT.html">XSLT
125</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000126 </li>
127 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000128 <a href="xmldtd.html">Validation &amp; DTDs
129</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000130 </li>
131 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000132 <a href="encoding.html">Encodings support
133</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000134 </li>
135 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000136 <a href="catalog.html">Catalog support
137</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000138 </li>
139 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000140 <a href="namespaces.html">Namespaces
141</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000142 </li>
143 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000144 <a href="contribs.html">Contributions
145</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000146 </li>
147 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000148 <a href="examples/index.html" style="font-weight:bold">Code Examples
149</a>
Daniel Veillarda59853a2003-11-12 22:50:47 +0000150 </li>
151 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000152 <a href="html/index.html" style="font-weight:bold">API Menu
153</a>
Daniel Veillarde8ba84e2003-11-18 13:54:15 +0000154 </li>
155 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000156 <a href="guidelines.html">XML Guidelines
157</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000158 </li>
Daniel Veillard8badcee2004-05-16 00:28:36 +0000159 <li>
160 <a href="ChangeLog.html">ChangeLog
161</a>
162 </li>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000163 </ul>
164 </td>
165 </tr>
166 </table>
167 <table width="100%" border="0" cellspacing="1" cellpadding="3">
168 <tr>
169 <td colspan="1" bgcolor="#eecfa1" align="center">
170 <center>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000171 <b>Related links
172</b>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000173 </center>
174 </td>
175 </tr>
176 <tr>
177 <td bgcolor="#fffacd">
178 <ul>
179 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000180 <a href="http://mail.gnome.org/archives/xml/">Mail archive
181</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000182 </li>
183 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000184 <a href="http://xmlsoft.org/XSLT/">XSLT libxslt
185</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000186 </li>
187 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000188 <a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2
189</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000190 </li>
191 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000192 <a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec
193</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000194 </li>
195 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000196 <a href="ftp://xmlsoft.org/">FTP
197</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000198 </li>
199 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000200 <a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries
201</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000202 </li>
203 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000204 <a href="http://garypennington.net/libxml2/">Solaris binaries
205</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000206 </li>
207 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000208 <a href="http://www.zveno.com/open_source/libxml2xslt.html">MacOsX binaries
209</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000210 </li>
211 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000212 <a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings
213</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000214 </li>
215 <li>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000216 <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker
217</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000218 </li>
219 </ul>
220 </td>
221 </tr>
222 </table>
223 </td>
224 </tr>
225 </table>
226 </td>
227 <td valign="top" bgcolor="#8b7765">
228 <table border="0" cellspacing="0" cellpadding="1" width="100%">
229 <tr>
230 <td>
231 <table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000">
232 <tr>
233 <td>
234 <table border="0" cellpadding="3" cellspacing="1" width="100%">
235 <tr>
236 <td bgcolor="#fffacd">
237 <p></p>
Daniel Veillard7ebac022004-02-25 22:36:35 +0000238 <p style="text-align: right; font-style: italic; font-size: 10pt">"Programming
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000239with libxml2 is like the thrilling embrace of an exotic stranger."
240 <a href="http://diveintomark.org/archives/2004/02/18/libxml2">Mark
241Pilgrim
242</a>
243</p>
Daniel Veillard598bec32003-07-06 10:02:03 +0000244 <p>Libxml2 is the XML C parser and toolkit developed for the Gnome project
Daniel Veillard23a52c52003-08-18 10:01:18 +0000245(but usable outside of the Gnome platform), it is free software available
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000246under the
247 <a href="http://www.opensource.org/licenses/mit-license.html">MIT
248License
249</a>
250. XML itself is a metalanguage to design markup languages, i.e.
Daniel Veillardeec1ae92003-09-09 13:11:01 +0000251text language where semantic and structure are added to the content using
Daniel Veillard024f1992003-12-10 16:43:49 +0000252extra "markup" information enclosed between angle brackets. HTML is the most
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000253well-known markup language. Though the library is written in C
254 <a href="python.html">a variety of language bindings
255</a>
256 make it available in
257other environments.
258</p>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000259 <p>Libxml2 is known to be very portable, the library should build and work
Daniel Veillard710823b2003-03-04 10:05:52 +0000260without serious troubles on a variety of systems (Linux, Unix, Windows,
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000261CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)
262</p>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000263 <p>Libxml2 implements a number of existing standards related to markup
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000264languages:
265</p>
266 <ul> <li>the XML standard:
267 <a href="http://www.w3.org/TR/REC-xml">http://www.w3.org/TR/REC-xml
268</a>
269</li>
270
271
272 <li>Namespaces in XML:
273 <a href="http://www.w3.org/TR/REC-xml-names/">http://www.w3.org/TR/REC-xml-names/
274</a>
275</li>
276
277
278 <li>XML Base:
279 <a href="http://www.w3.org/TR/xmlbase/">http://www.w3.org/TR/xmlbase/
280</a>
281</li>
282
283
284 <li> <a href="http://www.cis.ohio-state.edu/rfc/rfc2396.txt">RFC 2396
285</a>
286 :
287 Uniform Resource Identifiers
288 <a href="http://www.ietf.org/rfc/rfc2396.txt">http://www.ietf.org/rfc/rfc2396.txt
289</a>
290</li>
291
292
293 <li>XML Path Language (XPath) 1.0:
294 <a href="http://www.w3.org/TR/xpath">http://www.w3.org/TR/xpath
295</a>
296</li>
297
298
299 <li>HTML4 parser:
300 <a href="http://www.w3.org/TR/html401/">http://www.w3.org/TR/html401/
301</a>
302</li>
303
304
305 <li>XML Pointer Language (XPointer) Version 1.0:
306 <a href="http://www.w3.org/TR/xptr">http://www.w3.org/TR/xptr
307</a>
308</li>
309
310
311 <li>XML Inclusions (XInclude) Version 1.0:
312 <a href="http://www.w3.org/TR/xinclude/">http://www.w3.org/TR/xinclude/
313</a>
314</li>
315
316
317 <li>ISO-8859-x encodings, as well as
318 <a href="http://www.cis.ohio-state.edu/rfc/rfc2044.txt">rfc2044
319</a>
320 [UTF-8]
321 and
322 <a href="http://www.cis.ohio-state.edu/rfc/rfc2781.txt">rfc2781
323</a>
324
325 [UTF-16] Unicode encodings, and more if using iconv support
326</li>
327
328
329 <li>part of SGML Open Technical Resolution TR9401:1997
330</li>
331
332
333 <li>XML Catalogs Working Draft 06 August 2001:
334 <a href="http://www.oasis-open.org/committees/entity/spec-2001-08-06.html">http://www.oasis-open.org/committees/entity/spec-2001-08-06.html
335</a>
336</li>
337
338
339 <li>Canonical XML Version 1.0:
340 <a href="http://www.w3.org/TR/xml-c14n">http://www.w3.org/TR/xml-c14n
341</a>
342
343 and the Exclusive XML Canonicalization CR draft
344 <a href="http://www.w3.org/TR/xml-exc-c14n">http://www.w3.org/TR/xml-exc-c14n
345</a>
346</li>
347
348
349 <li>Relax NG, ISO/IEC 19757-2:2003,
350 <a href="http://www.oasis-open.org/committees/relax-ng/spec-20011203.html">http://www.oasis-open.org/committees/relax-ng/spec-20011203.html
351</a>
352</li>
353
354
355 <li>W3C XML Schemas Part 2: Datatypes
356 <a href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">REC 02 May
357 2001
358</a>
359</li>
360
361
362 <li>W3C
363 <a href="http://www.w3.org/TR/xml-id/">xml:id
364</a>
365 Working Draft 7
366 April 2004
367</li>
368
369
Daniel Veillardc9484202001-10-24 12:35:52 +0000370</ul>
Daniel Veillard95c09d92003-07-07 12:11:06 +0000371 <p>In most cases libxml2 tries to implement the specifications in a
Daniel Veillard7c4eb632004-04-19 21:29:12 +0000372relatively strictly compliant way. As of release 2.4.16, libxml2 passed all
Daniel Veillardd4cfcef2004-05-06 18:55:27 +00003731800+ tests from the
374 <a href="http://www.oasis-open.org/committees/xml-conformance/">OASIS XML Tests
375Suite
376</a>
377.
378</p>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000379 <p>To some extent libxml2 provides support for the following additional
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000380specifications but doesn't claim to implement them completely:
381</p>
382 <ul> <li>Document Object Model (DOM)
383 <a href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/
384</a>
385
386 the document model, but it doesn't implement the API itself, gdome2 does
387 this on top of libxml2
388</li>
389
390
391 <li> <a href="http://www.cis.ohio-state.edu/rfc/rfc959.txt">RFC 959
392</a>
393 :
394 libxml2 implements a basic FTP client code
395</li>
396
397
398 <li> <a href="http://www.cis.ohio-state.edu/rfc/rfc1945.txt">RFC 1945
399</a>
400 :
401 HTTP/1.0, again a basic HTTP client code
402</li>
403
404
405 <li>SAX: a SAX2 like interface and a minimal SAX1 implementation compatible
406 with early expat versions
407</li>
408
409
Daniel Veillard9c466822001-10-25 12:03:39 +0000410</ul>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000411 <p>A partial implementation of
412 <a href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schemas Part
4131: Structure
414</a>
415 is being worked on but it would be far too early to make any
416conformance statement about it at the moment.
417</p>
418 <p>Separate documents:
419</p>
420 <ul> <li> <a href="http://xmlsoft.org/XSLT/">the libxslt page
421</a>
422 providing an
Daniel Veillard2d347fa2002-03-17 10:34:11 +0000423 implementation of XSLT 1.0 and common extensions like EXSLT for
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000424 libxml2
425</li>
426
427
428 <li> <a href="http://www.cs.unibo.it/~casarini/gdome2/">the gdome2 page
429</a>
430
431 : a standard DOM2 implementation for libxml2
432</li>
433
434
435 <li> <a href="http://www.aleksey.com/xmlsec/">the XMLSec page
436</a>
437: an
438 implementation of
439 <a href="http://www.w3.org/TR/xmldsig-core/">W3C XML
440 Digital Signature
441</a>
442 for libxml2
443</li>
444
445
446 <li>also check the related links section below for more related and active
447 projects.
448</li>
449
450
Daniel Veillardc9484202001-10-24 12:35:52 +0000451</ul>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000452 <p>Logo designed by
453 <a href="mailto:liyanage@access.ch">Marc Liyanage
454</a>
455.
456</p>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000457 <p>
Daniel Veillardd4cfcef2004-05-06 18:55:27 +0000458 <a href="bugs.html">Daniel Veillard
459</a>
Daniel Veillard1177ca42003-04-26 22:29:54 +0000460 </p>
461 </td>
462 </tr>
463 </table>
464 </td>
465 </tr>
466 </table>
467 </td>
468 </tr>
469 </table>
470 </td>
471 </tr>
472 </table>
473 </td>
474 </tr>
475 </table>
476 </body>
Daniel Veillardc9484202001-10-24 12:35:52 +0000477</html>