| 1 | <html><head><title>
|
|---|
| 2 | d2m v0.2
|
|---|
| 3 | </title>
|
|---|
| 4 | </head>
|
|---|
| 5 |
|
|---|
| 6 | <body bgcolor="#ffffcc">
|
|---|
| 7 |
|
|---|
| 8 | <font face="Comic Sans MS">
|
|---|
| 9 | <h1 align=center>d2m : A Dublin Core to MARC converter</h1>
|
|---|
| 10 |
|
|---|
| 11 | <div align=center>
|
|---|
| 12 |
|
|---|
| 13 | version 0.2<br>
|
|---|
| 14 | 1998-10-14<br>
|
|---|
| 15 | Ole Husby<br>
|
|---|
| 16 | BIBSYS<br>
|
|---|
| 17 | [email protected]
|
|---|
| 18 | </div>
|
|---|
| 19 | </font>
|
|---|
| 20 |
|
|---|
| 21 |
|
|---|
| 22 | <h2>1. Introduction</h2>
|
|---|
| 23 |
|
|---|
| 24 | This software is part of the results from the Nordic Metadata project.
|
|---|
| 25 | (See <a href="http://linnea.helsinki.fi/meta/">
|
|---|
| 26 | http://linnea.helsinki.fi/meta/</a>).
|
|---|
| 27 |
|
|---|
| 28 | <p>
|
|---|
| 29 |
|
|---|
| 30 | This version is a "pre-release". It is not really ready for distribution.
|
|---|
| 31 | All the customary disclaimers apply!
|
|---|
| 32 | The programs have been compiled on Solaris, AIX and Linux.
|
|---|
| 33 |
|
|---|
| 34 |
|
|---|
| 35 |
|
|---|
| 36 | <h2>2. Contents</h2>
|
|---|
| 37 |
|
|---|
| 38 | The distribution includes the following files:
|
|---|
| 39 |
|
|---|
| 40 | <table>
|
|---|
| 41 | <tr><td><b>README.html </b></td><td>This file</td></tr>
|
|---|
| 42 | <tr><td><b>Makefile </b></td><td>Also includes some documentation</td></tr>
|
|---|
| 43 | <tr><td><b>d2m.h </b></td><td>Common include file</td></tr>
|
|---|
| 44 | <tr><td><b>D2Mcgi.c </b></td><td>Main program for the CGI version</td></tr>
|
|---|
| 45 | <tr><td><b>D2Mmain.c </b></td><td>Main program for the standalone version</td></tr>
|
|---|
| 46 | <tr><td><b>D2Mconv.c </b></td><td>Inputs file with DC metadata, outputs line MARC record</td></tr>
|
|---|
| 47 | <tr><td><b>M2Mconv.c </b></td><td>Inputs file with ISO 2709 MARC record, outputs line MARC record</td></tr>
|
|---|
| 48 | <tr><td><b>MARC2709.c </b></td><td>Converts from line MARC format to ISO 2709 MARC format</td></tr>
|
|---|
| 49 | <tr><td><b>MARCmake.c </b></td><td>Builds a MARC struct from a DC struct. Selects one of the following :</td></tr>
|
|---|
| 50 | <tr><td><b>danMARC.c </b></td><td> </td></tr>
|
|---|
| 51 | <tr><td><b>finMARC.c </b></td><td> </td></tr>
|
|---|
| 52 | <tr><td><b>isMARC.c </b></td><td> </td></tr>
|
|---|
| 53 | <tr><td><b>norMARC.c </b></td><td> </td></tr>
|
|---|
| 54 | <tr><td><b>sweMARC.c </b></td><td> </td></tr>
|
|---|
| 55 | <tr><td><b>usMARC.c </b></td><td> </td></tr>
|
|---|
| 56 | <tr><td><b>MARCtidy.c </b></td><td>Finishes the line MARC record from the MARC struct</td></tr>
|
|---|
| 57 | <tr><td><b>marc2line.c </b></td><td>Converts from ISO 2709 MARC format to line MARC format</td></tr>
|
|---|
| 58 | <tr><td><b>htget.c </b></td><td>Fetches a remote file using HTTP</td></tr>
|
|---|
| 59 | <tr><td><b>dc_parse.c </b></td><td>Parses an HTML <META> tag</td></tr>
|
|---|
| 60 | <tr><td><b>util.c </b></td><td>Some utilities</td></tr>
|
|---|
| 61 | <tr><td><b>wfetch.c </b></td><td>Small program on top of htget()</td></tr>
|
|---|
| 62 | <tr><td><b>wfetch-l.c </b></td><td>Dummy version of wfetch.c, does nothing except return 0</td></tr>
|
|---|
| 63 | <tr><td><b>test.data </b></td><td>A simple test file with a <meta> tag.</td></tr>
|
|---|
| 64 | </table>
|
|---|
| 65 |
|
|---|
| 66 | <h2>3. Compilation</h2>
|
|---|
| 67 |
|
|---|
| 68 | Unpack the d2m-v02.tar file. It will produce a directory <b>d2m-v02/</b>
|
|---|
| 69 | with the contents listed above.
|
|---|
| 70 |
|
|---|
| 71 | <p>
|
|---|
| 72 |
|
|---|
| 73 | Check the Makefile.
|
|---|
| 74 |
|
|---|
| 75 | <p>
|
|---|
| 76 |
|
|---|
| 77 | Type
|
|---|
| 78 |
|
|---|
| 79 | <pre>
|
|---|
| 80 |
|
|---|
| 81 | <b>make all</b>
|
|---|
| 82 |
|
|---|
| 83 | </pre>
|
|---|
| 84 |
|
|---|
| 85 | This should produce the programs <b>d2m</b> and <b>d2main</b> .
|
|---|
| 86 |
|
|---|
| 87 | <p>
|
|---|
| 88 |
|
|---|
| 89 | If you do not need access to remote files, or have problems compiling
|
|---|
| 90 | socket libraries, try to compile
|
|---|
| 91 |
|
|---|
| 92 | <pre>
|
|---|
| 93 |
|
|---|
| 94 | <b>make d2main-nosock</b>
|
|---|
| 95 |
|
|---|
| 96 | </pre>
|
|---|
| 97 |
|
|---|
| 98 |
|
|---|
| 99 | <h2>4. Use of d2main</h2>
|
|---|
| 100 |
|
|---|
| 101 | <b>d2main</b> should be ready to execute from the command line. No configuration
|
|---|
| 102 | or environment variables are needed.
|
|---|
| 103 |
|
|---|
| 104 | <p>
|
|---|
| 105 |
|
|---|
| 106 | If you do not enter any arguments, a short instruction will be printed.
|
|---|
| 107 |
|
|---|
| 108 | <p>
|
|---|
| 109 |
|
|---|
| 110 | The first test could be
|
|---|
| 111 |
|
|---|
| 112 | <pre>
|
|---|
| 113 |
|
|---|
| 114 | <b>d2main test.data -l</b>
|
|---|
| 115 |
|
|---|
| 116 | </pre>
|
|---|
| 117 |
|
|---|
| 118 | The next test could be (if d2main is not compiled using Makefile-l)
|
|---|
| 119 |
|
|---|
| 120 | <pre>
|
|---|
| 121 |
|
|---|
| 122 | <b>d2main http://linnea.helsinki.fi/meta/ -l -m FINMARC</b>
|
|---|
| 123 |
|
|---|
| 124 | </pre>
|
|---|
| 125 |
|
|---|
| 126 | <h2>5. Use of d2m</h2>
|
|---|
| 127 |
|
|---|
| 128 | <b>d2m</b> should be used as a CGI program.
|
|---|
| 129 |
|
|---|
| 130 | <p>
|
|---|
| 131 |
|
|---|
| 132 | A simple users guide is in D2Mcgi.c
|
|---|
| 133 |
|
|---|
| 134 | <p>
|
|---|
| 135 |
|
|---|
| 136 | See an example of use in <a href="http://www.bibsys.no/meta/d2m">
|
|---|
| 137 | http://www.bibsys.no/meta/d2m</a>
|
|---|
| 138 |
|
|---|
| 139 |
|
|---|
| 140 |
|
|---|
| 141 | <h2>6. Tailoring</h2>
|
|---|
| 142 |
|
|---|
| 143 | This version is not table-driven. The different MARC formats are
|
|---|
| 144 | treated by customized functions (norMARC.c, isMARC.c etc.). The
|
|---|
| 145 | selection of conversion program is performed by MARKmake.c .
|
|---|
| 146 |
|
|---|
| 147 | <p>
|
|---|
| 148 |
|
|---|
| 149 | The program MARCtidy.c is also to some degree depending of the
|
|---|
| 150 | MARC format. In addition there is a small sequence in D2Mconv.c
|
|---|
| 151 | with a special treatment for ISMARC. (It should really not be
|
|---|
| 152 | done there ...). Apart from this, all programs are independent on
|
|---|
| 153 | MARC format.
|
|---|
| 154 |
|
|---|
| 155 | <p>
|
|---|
| 156 |
|
|---|
| 157 | The supported formats are introduced in d2m.h .
|
|---|
| 158 |
|
|---|
| 159 | </body></html>
|
|---|
