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>
|
---|