libxml2/doc/index.html

   1 <?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">
   8 TD {font-family: Verdana,Arial,Helvetica}
   9 BODY {font-family: Verdana,Arial,Helvetica; margin-top: 2em; margin-left: 0em; margin-right: 0em}
  10 H1 {font-family: Verdana,Arial,Helvetica}
  11 H2 {font-family: Verdana,Arial,Helvetica}
  12 H3 {font-family: Verdana,Arial,Helvetica}
  13 A:link, A:visited, A:active { text-decoration: underline }
  14 </style>
  15     <title>The XML C parser and toolkit of Gnome</title>
  16   </head>
  17   <body bgcolor="#8b7765" text="#000000" link="#000000" vlink="#000000">
  18     <table border="0" width="100%" cellpadding="5" cellspacing="0" align="center">
  19       <tr>
  20         <td width="180">
  21           <a href="http://www.gnome.org/">
  22             <img src="gnome2.png" alt="Gnome2 Logo" />
  23           </a>
  24           <a href="http://www.w3.org/Status">
  25             <img src="w3c.png" alt="W3C Logo" />
  26           </a>
  27           <a href="http://www.redhat.com/">
  28             <img src="redhat.gif" alt="Red Hat Logo" />
  29           </a>
  30           <div align="left">
  31             <a href="http://xmlsoft.org/">
  32               <img src="Libxml2-Logo-180x168.gif" alt="Made with Libxml2 Logo" />
  33             </a>
  34           </div>
  35         </td>
  36         <td>
  37           <table border="0" width="90%" cellpadding="2" cellspacing="0" align="center" bgcolor="#000000">
  38             <tr>
  39               <td>
  40                 <table width="100%" border="0" cellspacing="1" cellpadding="3" bgcolor="#fffacd">
  41                   <tr>
  42                     <td align="center">
  43                       <h1>The XML C parser and toolkit of Gnome</h1>
  44                       <h2>libxml</h2>
  45                     </td>
  46                   </tr>
  47                 </table>
  48               </td>
  49             </tr>
  50           </table>
  51         </td>
  52       </tr>
  53     </table>
  54     <table border="0" cellpadding="4" cellspacing="0" width="100%" align="center">
  55       <tr>
  56         <td bgcolor="#8b7765">
  57           <table border="0" cellspacing="0" cellpadding="2" width="100%">
  58             <tr>
  59               <td valign="top" width="200" bgcolor="#8b7765">
  60                 <table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000">
  61                   <tr>
  62                     <td>
  63                       <table width="100%" border="0" cellspacing="1" cellpadding="3">
  64                         <tr>
  65                           <td colspan="1" bgcolor="#eecfa1" align="center">
  66                             <center>
  67                               <b>Main Menu</b>
  68                             </center>
  69                           </td>
  70                         </tr>
  71                         <tr>
  72                           <td bgcolor="#fffacd">
  73                             <form action="search.php" enctype="application/x-www-form-urlencoded" method="get">
  74                               <input name="query" type="text" size="20" value="" />
  75                               <input name="submit" type="submit" value="Search ..." />
  76                             </form>
  77                             <ul>
  78                               <li>
  79                                 <a href="index.html">Home</a>
  80                               </li>
  81                               <li>
  82                                 <a href="intro.html">Introduction</a>
  83                               </li>
  84                               <li>
  85                                 <a href="FAQ.html">FAQ</a>
  86                               </li>
  87                               <li>
  88                                 <a href="docs.html">Developer Documentation</a>
  89                               </li>
  90                               <li>
  91                                 <a href="bugs.html">Reporting bugs and getting help</a>
  92                               </li>
  93                               <li>
  94                                 <a href="help.html">How to help</a>
  95                               </li>
  96                               <li>
  97                                 <a href="downloads.html">Downloads</a>
  98                               </li>
  99                               <li>
 100                                 <a href="news.html">News</a>
 101                               </li>
 102                               <li>
 103                                 <a href="XMLinfo.html">XML</a>
 104                               </li>
 105                               <li>
 106                                 <a href="XSLT.html">XSLT</a>
 107                               </li>
 108                               <li>
 109                                 <a href="xmldtd.html">Validation &amp; DTDs</a>
 110                               </li>
 111                               <li>
 112                                 <a href="encoding.html">Encodings support</a>
 113                               </li>
 114                               <li>
 115                                 <a href="catalog.html">Catalog support</a>
 116                               </li>
 117                               <li>
 118                                 <a href="namespaces.html">Namespaces</a>
 119                               </li>
 120                               <li>
 121                                 <a href="contribs.html">Contributions</a>
 122                               </li>
 123                               <li>
 124                                 <a href="guidelines.html">XML Guidelines</a>
 125                               </li>
 126                             </ul>
 127                           </td>
 128                         </tr>
 129                       </table>
 130                       <table width="100%" border="0" cellspacing="1" cellpadding="3">
 131                         <tr>
 132                           <td colspan="1" bgcolor="#eecfa1" align="center">
 133                             <center>
 134                               <b>Related links</b>
 135                             </center>
 136                           </td>
 137                         </tr>
 138                         <tr>
 139                           <td bgcolor="#fffacd">
 140                             <ul>
 141                               <li>
 142                                 <a href="http://mail.gnome.org/archives/xml/">Mail archive</a>
 143                               </li>
 144                               <li>
 145                                 <a href="http://xmlsoft.org/XSLT/">XSLT libxslt</a>
 146                               </li>
 147                               <li>
 148                                 <a href="http://phd.cs.unibo.it/gdome2/">DOM gdome2</a>
 149                               </li>
 150                               <li>
 151                                 <a href="http://www.aleksey.com/xmlsec/">XML-DSig xmlsec</a>
 152                               </li>
 153                               <li>
 154                                 <a href="ftp://xmlsoft.org/">FTP</a>
 155                               </li>
 156                               <li>
 157                                 <a href="http://www.zlatkovic.com/projects/libxml/">Windows binaries</a>
 158                               </li>
 159                               <li>
 160                                 <a href="http://garypennington.net/libxml2/">Solaris binaries</a>
 161                               </li>
 162                               <li>
 163                                 <a href="http://www.zveno.com/open_source/libxml2xslt.html">MacOsX binaries</a>
 164                               </li>
 165                               <li>
 166                                 <a href="http://sourceforge.net/projects/libxml2-pas/">Pascal bindings</a>
 167                               </li>
 168                               <li>
 169                                 <a href="http://bugzilla.gnome.org/buglist.cgi?product=libxml2">Bug Tracker</a>
 170                               </li>
 171                             </ul>
 172                           </td>
 173                         </tr>
 174                       </table>
 175                     </td>
 176                   </tr>
 177                 </table>
 178               </td>
 179               <td valign="top" bgcolor="#8b7765">
 180                 <table border="0" cellspacing="0" cellpadding="1" width="100%">
 181                   <tr>
 182                     <td>
 183                       <table border="0" cellspacing="0" cellpadding="1" width="100%" bgcolor="#000000">
 184                         <tr>
 185                           <td>
 186                             <table border="0" cellpadding="3" cellspacing="1" width="100%">
 187                               <tr>
 188                                 <td bgcolor="#fffacd">
 189                                   <p></p>
 190                                   <p>Libxml2 is the XML C parser and toolkit developed for the Gnome project
 191 (but usable outside of the Gnome platform). XML itself is a metalanguage to
 192 design markup languages, i.e. text language where semantic and structure are
 193 added to the content using extra &quot;markup&quot; information enclosed between angle
 194 brackets. HTML is the most well-known markup language. Though the library is
 195 written in C <a href="python.html">a variety of language bindings</a> make it
 196 available in other environments.</p>
 197                                   <p>Libxml2 is known to be very portable, the library should build and work
 198 without serious troubles on a variety of systems (Linux, Unix, Windows,
 199 CygWin, MacOS, MacOS X, RISC Os, OS/2, VMS, QNX, MVS, ...)</p>
 200                                   <p>Libxml2 implements a number of existing standards related to markup
 201 languages:</p>
 202                                   <ul><li>the XML standard: <a href="http://www.w3.org/TR/REC-xml">http://www.w3.org/TR/REC-xml</a></li>
 203   <li>Namespaces in XML: <a href="http://www.w3.org/TR/REC-xml-names/">http://www.w3.org/TR/REC-xml-names/</a></li>
 204   <li>XML Base: <a href="http://www.w3.org/TR/xmlbase/">http://www.w3.org/TR/xmlbase/</a></li>
 205   <li><a href="http://www.cis.ohio-state.edu/rfc/rfc2396.txt">RFC 2396</a> :
 206     Uniform Resource Identifiers <a href="http://www.ietf.org/rfc/rfc2396.txt">http://www.ietf.org/rfc/rfc2396.txt</a></li>
 207   <li>XML Path Language (XPath) 1.0: <a href="http://www.w3.org/TR/xpath">http://www.w3.org/TR/xpath</a></li>
 208   <li>HTML4 parser: <a href="http://www.w3.org/TR/html401/">http://www.w3.org/TR/html401/</a></li>
 209   <li>most of XML Pointer Language (XPointer) Version 1.0: <a href="http://www.w3.org/TR/xptr">http://www.w3.org/TR/xptr</a></li>
 210   <li>XML Inclusions (XInclude) Version 1.0: <a href="http://www.w3.org/TR/xinclude/">http://www.w3.org/TR/xinclude/</a></li>
 211   <li>[ISO-8859-1], <a href="http://www.cis.ohio-state.edu/rfc/rfc2044.txt">rfc2044</a> [UTF-8]
 212     and <a href="http://www.cis.ohio-state.edu/rfc/rfc2781.txt">rfc2781</a>
 213     [UTF-16] core encodings</li>
 214   <li>part of SGML Open Technical Resolution TR9401:1997</li>
 215   <li>XML Catalogs Working Draft 06 August 2001: <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</a></li>
 216   <li>Canonical XML Version 1.0: <a href="http://www.w3.org/TR/xml-c14n">http://www.w3.org/TR/xml-c14n</a>
 217     and the Exclusive XML Canonicalization CR draft <a href="http://www.w3.org/TR/xml-exc-c14n">http://www.w3.org/TR/xml-exc-c14n</a></li>
 218   <li>Relax NG Committee Specification 3 December 2001 <a href="http://www.oasis-open.org/committees/relax-ng/spec-20011203.html">http://www.oasis-open.org/committees/relax-ng/spec-20011203.html</a></li>
 219   <li>W3C XML Schemas Part 2: Datatypes <a href="http://www.w3.org/TR/2001/REC-xmlschema-2-20010502/">REC 02 May
 220     2001</a> except the base64Binary and hexBinary types</li>
 221 </ul>
 222                                   <p>In most cases libxml2 tries to implement the specifications in a
 223 relatively strictly compliant way. As of release 2.4.16, libxml2 passes all
 224 1800+ tests from the <a href="http://www.oasis-open.org/committees/xml-conformance/">OASIS XML Tests
 225 Suite</a>.</p>
 226                                   <p>To some extent libxml2 provides support for the following additional
 227 specifications but doesn't claim to implement them completely:</p>
 228                                   <ul><li>Document Object Model (DOM) <a href="http://www.w3.org/TR/DOM-Level-2-Core/">http://www.w3.org/TR/DOM-Level-2-Core/</a>
 229     it doesn't implement the API itself, gdome2 does this on top of
 230   libxml2</li>
 231   <li><a href="http://www.cis.ohio-state.edu/rfc/rfc959.txt">RFC 959</a> :
 232     libxml2 implements a basic FTP client code</li>
 233   <li><a href="http://www.cis.ohio-state.edu/rfc/rfc1945.txt">RFC 1945</a> :
 234     HTTP/1.0, again a basic HTTP client code</li>
 235   <li>SAX: a minimal SAX implementation compatible with early expat
 236   versions</li>
 237   <li>DocBook SGML v4: libxml2 includes a hackish parser to transition to
 238   XML</li>
 239 </ul>
 240                                   <p>A partial implementation of <a href="http://www.w3.org/TR/2001/REC-xmlschema-1-20010502/">XML Schemas Part
 241 1: Structure</a> is being worked on but it would be far too early to make any
 242 conformance statement about it at the moment.</p>
 243                                   <p>Separate documents:</p>
 244                                   <ul><li><a href="http://xmlsoft.org/XSLT/">the libxslt page</a> providing an
 245     implementation of XSLT 1.0 and common extensions like EXSLT for
 246   libxml2</li>
 247   <li><a href="http://www.cs.unibo.it/~casarini/gdome2/">the gdome2 page</a>
 248     : a standard DOM2 implementation for libxml2</li>
 249   <li><a href="http://www.aleksey.com/xmlsec/">the XMLSec page</a>: an
 250     implementation of <a href="http://www.w3.org/TR/xmldsig-core/">W3C XML
 251     Digital Signature</a> for libxml2</li>
 252   <li>also check the related links section below for more related and active
 253     projects.</li>
 254 </ul>
 255                                   <p>Results of the <a href="http://xmlbench.sourceforge.net/results/benchmark/index.html">xmlbench
 256 benchmark</a> on sourceforge 19 March 2003 (smaller is better):</p>
 257                                   <p align="center">
 258                                     <img src="benchmark.gif" alt="benchmark results for Expat Xerces libxml2 Oracle and Sun toolkits" />
 259                                   </p>
 260                                   <p>Logo designed by <a href="mailto:liyanage@access.ch">Marc Liyanage</a>.</p>
 261                                   <p>
 262                                     <a href="bugs.html">Daniel Veillard</a>
 263                                   </p>
 264                                 </td>
 265                               </tr>
 266                             </table>
 267                           </td>
 268                         </tr>
 269                       </table>
 270                     </td>
 271                   </tr>
 272                 </table>
 273               </td>
 274             </tr>
 275           </table>
 276         </td>
 277       </tr>
 278     </table>
 279   </body>
 280 </html>