Use field variable with qualified field name. FIX namespace!
[marc4j.git] / overview.html
1 <html xmlns="http://www.w3.org/1999/xhtml">\r
2 <body>\r
3   <p>The goal of MARC4J is to provide an easy to use Application Programming Interface (API) \r
4   for working with <a href="http://www.loc.gov/marc/">MARC</a> and \r
5   <a href="http://www.loc.gov/standards/marcxml/">MARC XML</a> in Java. MARC stands for \r
6   MAchine Readable Cataloguing and is a widely used exchange format for bibliographic data. \r
7   MARC XML provides a loss-less conversion between MARC (MARC21 but also other formats like UNIMARC) and XML.</p>\r
8   \r
9   <p>The structure of a MARC record is defined in the ISO 2709:1996 (Format for Information Exchange) standard \r
10   (or ANSI/NISO Z39.2-1994, available <a href="http://www.niso.org/standards/resources/Z39-2.pdf">online</a> \r
11   from NISO). The MARC4J API is not a full implementation of the ISO 2709:1996 standard. The standard is \r
12   implemented as it is used in the MARC formats.</p>\r
13  \r
14   <p>MARC4J provides readers and writers for MARC and MARC XML. A {@link org.marc4j.MarcReader} \r
15   implementation parses input data and provides an iterator over a collection \r
16   of {@link org.marc4j.marc.Record} objects. The record object model is also suitable for in-memory \r
17   editing of MARC records, just as DOM is used for XML editing purposes. \r
18   Using a {@link org.marc4j.MarcWriter} implementation it is possible to create MARC or MARC XML. \r
19   Once MARC data has been converted to XML you can further process the result with XSLT, for \r
20   example to convert MARC to <a href="http://www.loc.gov/standards/mods/">MODS</a>.</p>\r
21 \r
22   <p>Although MARC4J is primarily designed for Java development you can use the command-line \r
23     utilities {@link org.marc4j.util.MarcXmlDriver} and {@link org.marc4j.util.XmlMarcDriver} \r
24     to convert between MARC and MARCXML. It is also possible to pre or post process the result \r
25     using XSLT, for example to convert directly from MODS to MARC or from MARC to MODS.</p>\r
26 \r
27   <p>The source code is published under version 2.1 of \r
28   the <a href="http://www.gnu.org/copyleft/lesser.html">GNU Lesser General Public License</a>. \r
29   In brief, this means there&apos;s no warranty and you can do anything you like with it. \r
30   The text of the license is included in the distribution. If you make changes to MARC4J and redistribute \r
31   those changes, then you must publish your modified version under the LGPL.</p>\r
32 \r
33   <p>For more information about the MARC4J project visit <a href="http://marc4j.tigris.org">http://marc4j.tigris.org</a>.</p>\r
34 \r
35 </body>\r
36 </html>