--- storage/meta/meta-format.tex 2003/07/23 10:35:06 1.4
+++ storage/meta/meta-format.tex 2003/07/23 20:34:53 1.5
@@ -16,7 +16,7 @@
\author{Robert Casties, Dirk Wintergrün, Hans-Christoph Liess}
-\date{V0.3pre2 of \today}
+\date{V0.3 of \today}
\begin{document}
@@ -93,7 +93,7 @@ parameter. Its sub-elements are:
to permanent storage -- deduced (must not be set by the user).
\item[archive-path] The full path to the resource directory inside the
- whole archive collection -- deduced.
+ whole archive collection, including the resource directory -- deduced.
\item[derived-from] Container for the description of the original
resource if this resource is a modified version of another resource
@@ -143,9 +143,9 @@ parameter. Its sub-elements are:
\item[name] The name of the subdirectory -- required.
\item[path] The directory path of this subdirectory relative to the
- resource's root directory (containing the directory itself) --
- required (may be identical to \texttt{name} or omitted if the
- directory is a direct child of the resource's root directory).
+ resource's root directory (excluding the directory itself) --
+ required (may be empty or omitted if the directory is a direct
+ child of the resource's root directory).
\item[meta] Additional metadata information about the directory --
optional.\\ For a description of additional metadata see below.
@@ -162,9 +162,9 @@ parameter. Its sub-elements are:
\item[name] The name of the file -- required.
\item[path] The directory path of this file relative to the
- resource's root directory (containing the file itself) -- required
- (may be identical to \texttt{name} or omitted if the file is in the
- resource's root directory).
+ resource's root directory (excluding the file itself) -- required
+ (may be empty or omitted if the file is in the resource's root
+ directory).
\item[modification-date] The file's modification date -- optional.
@@ -220,27 +220,33 @@ on the page
\label{sec:collection-context}
The context of a resource as part of a collection or part of a project can be
-specified in the \texttt{context} element:
+specified in the \texttt{context} element. All elements in the
+container can appear multiple times.
\begin{description}
-\item[link] URL to additional context information.
+\item[context] information on collection or project context.
-\item[name] Textual description of project or collection.
+ \begin{description}
+ \item[link] URL to additional context information.
+
+ \item[name] Textual description of project or collection.
+ \end{description}
\end{description}
-\noindent multiple \texttt{link} or \texttt{name} elements are
-possible.
+
\subsection{Bibliographic information}
\label{sec:bibliographic-data}
-Bibliographic information in the format of the ECHO scheme for
-bibliographic data (cf. content workflow) or the MPIWG
-``Projektbibliografie'' is presented in a \texttt{bib} container with
+Bibliographic information is presented in a \texttt{bib} container with
a \texttt{type} parameter, giving the type of bibliographic resource.
The \texttt{type} field can be repeated as a tag in the container.
+The format is based on the ECHO scheme for bibliographic data (cf.
+content workflow), the MPIWG ``Projektbibliografie'' and the format of
+the commonly used program ``EndNote''.
+
\subsubsection{Book}
@@ -433,6 +439,28 @@ The \texttt{type} field can be repeated
\end{description}
\end{description}
+\subsubsection{Manuscript}
+
+\begin{description}
+\item [bib type="manuscript"] a handwritten/typewritten manuscript.
+
+ \begin{description}
+ \item [title] Title of the manuscript.
+ \item [author] The author of the text.
+ \item [location] Name of the library where the manuscript is
+ currently located.
+ \item [year] The year or century of publication.
+ \item [pages] Number of pages of the manuscript.
+ \item [signature] Signature of the manuscript.
+ \item [editorial-remarks] Remarks related to the online
+ publication of the manuscript. This could be notes about
+ annotations etc.
+ \item [description] This can be any kind of description.
+ \item [keywords] Keywords related to the manuscript.
+ \end{description}
+\end{description}
+
+
\subsubsection{Generic}
\begin{description}
@@ -464,7 +492,7 @@ The \texttt{type} field can be repeated
\item [abstract]
\item [notes]
\item [url]
-\end{description}
+ \end{description}
\end{description}
@@ -472,18 +500,25 @@ The \texttt{type} field can be repeated
\label{sec:doc}
Specific information for architectural drawings is presented in a
-\texttt{doc} container. All elements can appear multiple times.
+\texttt{doc} container with an additional \texttt{type} attribute
+giving the type of drawing. All elements inside the container can
+appear multiple times.
\begin{description}
-\item [person] last name and first name of a person, separated by a
- comma. A further common name for the person can be put infront,
- separated by a semicolon.
-\item [location] Name of a place in its common notation. This can
- be a city or a institution.
-\item [date] This can be a year (or several years, separated by commas) or a period
- (1706-1714). Years are noted with four digits.
-\item [object] Short description of an object or signatures.
-\item [keywords] Keywords related to the object.
+
+\item[doc type="Architectural Drawing"] architectural drawing.
+
+ \begin{description}
+ \item [person] last name and first name of a person, separated by a
+ comma. A further common name for the person can be put infront,
+ separated by a semicolon.
+ \item [location] Name of a place in its common notation. This can be
+ a city or a institution.
+ \item [date] This can be a year (or several years, separated by
+ commas) or a period (1706-1714). Years are noted with four digits.
+ \item [object] Short description of an object or signatures.
+ \item [keywords] Keywords related to the object.
+\end{description}
\end{description}
@@ -510,52 +545,60 @@ the page images is specified in the \tex
tags.
\begin{description}
-\item[page] describes a single logical page
- \begin{description}
- \item[name] the ``name'' of the logical page. This can be any string
- like a page number (arabic, roman, etc.) or a special designation
- like ``Table 5''.
-
- \item[index] the \texttt{digilib} index number\footnote{The index
- number for digilib is the index in the alphabetical order of the
- scan file names.} of the scan image of the page.
-
- \item[url] alternatively to the \texttt{digilib} index number the
- full URL of the scan image of the page can be used.
- \end{description}
-
-\item[chapter] describes a section or chapter of the text.
- \texttt{chapter} elements can be nested.
- \begin{description}
- \item[name] the title of the chapter or section.
-
- \item[start] the beginning of a page range (usually the first page
- of the chapter). The \texttt{start} element has an optional
- \texttt{increment} attribute to indicate the number of logical
- pages on a scan image.\footnote{This information is only needed by
- additional tools that try to generate lists of all page and
- image numbers.}
- \begin{description}
- \item[name] the ``name'' of the first page (see \texttt{page}).
+\item[toc] container for document structure
- \item[index] the index of the first page (see \texttt{page}).
+ \begin{description}
+ \item[page] describes a single logical page
- \item[url] the URL of the first page (see \texttt{page}).
- \end{description}
-
- \item[end] the end of a page range (usually the last page of the
- chapter).
\begin{description}
- \item[name] the ``name'' of the last page (see \texttt{page}).
-
- \item[index] the index of the last page (see \texttt{page}).
+ \item[name] the ``name'' of the logical page. This can be any string
+ like a page number (arabic, roman, etc.) or a special designation
+ like ``Table 5''.
+
+ \item[index] the \texttt{digilib} index number\footnote{The index
+ number for digilib is the index in the alphabetical order of the
+ scan file names.} of the scan image of the page.
+
+ \item[url] alternatively to the \texttt{digilib} index number the
+ full URL of the scan image of the page can be used.
+ \end{description}
+
+ \item[chapter] describes a section or chapter of the text.
+ \texttt{chapter} elements can be nested.
- \item[url] the URL of the last page (see \texttt{page}).
+ \begin{description}
+ \item[name] the title of the chapter or section.
+
+ \item[start] the beginning of a page range (usually the first page
+ of the chapter). The \texttt{start} element has an optional
+ \texttt{increment} attribute to indicate the number of logical
+ pages on a scan image.\footnote{This information is only needed by
+ additional tools that try to generate lists of all page and
+ image numbers.}
+
+ \begin{description}
+ \item[name] the ``name'' of the first page (see \texttt{page}).
+
+ \item[index] the index of the first page (see \texttt{page}).
+
+ \item[url] the URL of the first page (see \texttt{page}).
+ \end{description}
+
+ \item[end] the end of a page range (usually the last page of the
+ chapter).
+
+ \begin{description}
+ \item[name] the ``name'' of the last page (see \texttt{page}).
+
+ \item[index] the index of the last page (see \texttt{page}).
+
+ \item[url] the URL of the last page (see \texttt{page}).
+ \end{description}
+
+ \item[page] alternative (and additional) to
+ \texttt{start}/\texttt{end} page ranges single \texttt{page}
+ elements can be used inside \texttt{chapter}.
\end{description}
-
- \item[page] alternative (and additional) to
- \texttt{start}/\texttt{end} page ranges single \texttt{page}
- elements can be used inside \texttt{chapter}.
\end{description}
\end{description}
@@ -573,33 +616,45 @@ of the original image. This information
Required is one of three possible sets of tags:
\begin{description}
-\item[original-size-x] The width of the original image. The unit of
- measure can be contained as parameter \texttt{unit}, the default is
- meter ``m''. The width to be considered is the total width of the
- scanned area.
-
-\item[original-size-y] The height of the original image.
-
-\item[original-pixel-x] The width of the hi-res scan in pixels.
+\item[img] digital image information.
-\item[original-pixel-y] The height of the hi-res scan in pixels.
+ \begin{description}
+ \item[original-size-x] The width of the original image. The unit of
+ measure can be contained as parameter \texttt{unit}, the default
+ is meter ``m''. The width to be considered is the total width of
+ the scanned area.
+
+ \item[original-size-y] The height of the original image.
+
+ \item[original-pixel-x] The width of the hi-res scan in pixels.
+
+ \item[original-pixel-y] The height of the hi-res scan in pixels.
+ \end{description}
\end{description}
or
\begin{description}
-\item[original-dpi-x] The resolution of the hi-res scan in its width
- in pixels per inch.
+\item[img] digital image information.
+
+ \begin{description}
+ \item[original-dpi-x] The resolution of the hi-res scan in its width
+ in pixels per inch.
-\item[original-dpi-y] The resolution of the hi-res scan in its height
- in pixels per inch.
+ \item[original-dpi-y] The resolution of the hi-res scan in its height
+ in pixels per inch.
+ \end{description}
\end{description}
or
\begin{description}
-\item[original-dpi] The resolution of the hi-res scan in pixels per
- inch if the resolutions in width and height are the same.
+\item[img] digital image information.
+
+ \begin{description}
+ \item[original-dpi] The resolution of the hi-res scan in pixels per
+ inch if the resolutions in width and height are the same.
+ \end{description}
\end{description}
@@ -614,79 +669,85 @@ inside the container has to be further s
\section{Sample metadata files for ECHO resources}
-The following is a sample structures for a scanned document.
+The following is a sample metadata index file for a directory containig a
+scanned document.
+
+\begin{small}
\begin{verbatim}
- Fleck, 1980
- fleck.1980
- University of Bern
- ubern/wiss-theorie
- scanned images
-
- echo23a45e2329x
- ger
-
- Fleck, Ludwik
- 1980
- Entstehung und Entwicklung einer
- wissenschaftlichen Tatsache
-
-
-
-
- Frankfurt am Main
- Suhrkamp
-
-
-
-
- Wissenschaftstheorie, Fleck, Tatsache
-
-
-
-
- Scanned images (300dpi)
- img
-
+ Fleck, 1980
+ fleck.1980
+ University of Bern
+ ubern/wiss-theorie
+ scanned images
+
+ echo23a45e2329x
+ ger
+
+ Fleck, Ludwik
+ 1980
+ Entstehung und Entwicklung einer
+ wissenschaftlichen Tatsache
+
+
+
+
+ Frankfurt am Main
+ Suhrkamp
+
+
+
+
+ Wissenschaftstheorie, Fleck, Tatsache
+
+
+
+
+ Scanned images (300dpi)
+ img
+
\end{verbatim}
+\end{small}
-The following is a sample metadata structure for an architectural
-drawing.
+The following is a sample metadata file for a single image of an
+architectural drawing.
+\begin{small}
\begin{verbatim}
- Bibliotheca Hertziana
- scanned images
-
- 00000271-asl-160-r-full.tif
-
-
- 315
-
- echo45a67bc4367d
- ita
-
- Ciolli, Giacomo
- Urban VIII; Barberini, Maffeo
- Accademia di San Luca
- Roma
- 1706
-
-
-
-
-
-
-
- http://colosseum.biblhertz.it:8080/Lineamenta/
- 1033478408.39/1035196181.35/1035196204.09/1035394121.83
-
-
-
-
+ Bibliotheca Hertziana
+ scanned images
+
+ 00000271-asl-160-r-full.tif
+
+
+ 315
+
+ echo45a67bc4367d
+ ita
+
+ Ciolli, Giacomo
+ Urban VIII; Barberini, Maffeo
+ Accademia di San Luca
+ Roma
+ 1706
+
+
+
+
+
+
+
+ http://colosseum.biblhertz.it:8080/Lineamenta/
+ 1033478408.39/1035196181.35/1035196204.09/1035394121.83
+
+
+
+
\end{verbatim}
+\end{small}
\end{document}