--- storage/meta/meta-format.tex 2007/04/02 16:28:04 1.18 +++ storage/meta/meta-format.tex 2010/12/20 14:09:24 1.27 @@ -16,7 +16,7 @@ \author{Robert Casties, Dirk Wintergrün, Hans-Christoph Liess} -\date{V1.3.2 of 2.4.2007} +\date{V1.3.8 of 30.8.2010} \begin{document} @@ -172,6 +172,21 @@ The outer container element is \texttt{r of this resource to the linked resource -- optional. \end{description} +\item[is-part-of] Container for the description of another resource if this + resource is a part of the other resource. -- optional. It can have a + \texttt{type} attribute describing the type of relation .e.g. ``manuscript-codex''. + + \begin{description} + \item[archive-id] The ID of the original resource + -- required (or archive-path). + + \item[archive-path] The full path to the original resource + -- required (or archive-id). + + \item[description] An informal textual description of the relation + of this resource to the original resource -- optional. + \end{description} + \item[media-type] \label{tag-media-type} The main media type of this resource -- required.\\ The main media type can be overridden by \texttt{media-type}s in subdirectories. Possible types are @@ -298,8 +313,8 @@ Metadata elements can appear multiple ti The content type enables the choice of tools to manipulate and display the resource. There should be a common list of content types. For digital documents (books, manuscripts) this would be - "scanned document", for other image data "scanned - images".\footnote{The criterion for documents is a ordered + ``scanned document'', for other image data ``scanned + images''.\footnote{The criterion for documents is a ordered succession of image files (pages) and equal image size and resolution throughout the images of a resource.} \end{description} @@ -643,6 +658,103 @@ the commonly used program ``EndNote''. \end{description} \end{description} +\subsubsection{Extended Manuscript} + +\begin{description} +\item [bib type="extended-manuscript"] a handwritten/typewritten manuscript +with detailed information about the manuscripts appearance. + + \begin{description} + \item [title] Title of the manuscript. + \item [author] The author of the text. + \item[holding-library] Holding library. + \item[call-number] Call number/Shelf mark in holding library. + \item[location] Place/City/Country where the manuscript is + currently located. + \item[date calendar="type"] The date of publication with attribute which + calendar used. If no attribute used, CE is the default. Can also be + descriptive. + \item[year calendar="type"] Approximate year or century . + \item[number-of-folios] Number of folios/pages of the manuscript. + \item[signature] Signature(s) of the manuscript, under which a manuscript is + known. + \item[abstract] Interpretative abstract of the text's content. + \item[incipit] Incipit (beginning of text). + \item[explicit] Explicit (end of text). + \item[contents] Formal description of the text structure (e.g. table of + contents). + \item[writing-surface] material of the writing surface (e.g. ``non-european + paper'', ``palm leaf'',\ldots) + \item[foliation] Text giving list or range of folios. + \item[page-dimensions] height and width in cm. + \item[written-area-dimensions] height and width in cm. + \item[lines-per-page] number of lines and columns. + \item[catchwords] Quire signatures and catchwords. + \item[scripts] Description of the script and the ink used. + \item[copyist] Copyist. + \item[collation-corrections] Notes on collation and corrections. + \item[binding] Description of binding. + \item[notes-on-ownership] Notes on ownership. + \item[notes] Additional notes. + \item[secondary-literature] Notes on secondary literature related to the + manuscript + \item [editorial-remarks] Remarks related to the online + publication of the manuscript. + \item [keywords] Keywords related to the manuscript. + \end{description} +\end{description} + +\subsubsection{Codex} + +\begin{description} +\item [bib type="codex"] Codex i.e. bound collection of one or more manuscripts. + + \begin{description} + \item[holding-library] Holding library. + \item[call-number] Call number/Shelf mark in holding library. + \item[location] Place/City/Country where the codex is + currently located. + \item[date calendar="type"] Date of the collation of the codex. + \item[year calendar="type"] Approximate year or century . + \item[number-of-folios] Number of folios/pages of the manuscript. + \item[foliation] Text giving list or range of folios. + \item[signature] Signature(s) of the manuscript, under which a manuscript is + known. + \item[contents] Formal description of the text structure (e.g. table of + contents). + \item[dimensions] height + width in cm. + \item[binding] Description of binding. + \item[notes] Additional notes. + \item[notes-on-ownership] Notes on ownership. + \end{description} +\end{description} + + +\subsubsection{Correspondence} + +\begin{description} +\item [bib type="correspondence"] a piece of correspondence e.g. letter, telegram, in the following called ``letter'' + + \begin{description} + \item[type] The type of correspondence, e.g. ``letter'', ``postcard'', ``telegram'', ``letter draft'' + \item [author] The author/sender of the letter. + \item [recipient] The recipient of the letter. + \item [date] normalised date of the letter. + \item [date-range-end] end of range of uncertain dating -- optional. + \item [date-original] the date in its original form as noted on the letter -- optional. + \item [place] place where the letter was written/sent. + \item [title] Title of the letter -- optional. + \item[incipit] The opening phrase of the letter -- optional. + \item[excipit] The closing phrase of the letter -- optional. + \item [pages] Number of pages of the manuscript. + \item [signature] Canonical signature/call number of the manuscript. + \item [description] This can be any kind of description. + \item [keywords] Keywords related to the manuscript. + \item[call-number] Call number in the current holding library + \item[holding-library] current holding library + \end{description} +\end{description} + \subsubsection{Generic} @@ -881,32 +993,30 @@ on page\pageref{tag-content-type}} ``ful The relation between the full text and optional images of whole pages or parts of pages must be specified in a -\texttt{text-tool} container. +\texttt{texttool} container. \begin{description} -\item[text-tool] representation of full text with images - +\item[texttool] representation of full text with images + \begin{description} - \item[text-file] the file name of the full text file (with path + \item[text] the file name of the full text file (path inside document directory) - \item[page-images] the directory name of the directory containig the - page image files (with path inside document directory) + \item[text-url-path] a characteristic part of the URL with which the + full text can be retrieved (the form and content of this element + is dependent on the specific text retrieval mechanism) + + \item[image] the directory name of the directory containig the + page image files (path inside document directory) - \item[xslt-file] the file name of an additional XSL transformation + \item[figure] the directory name of the directory containig the + in-page figure image files (path inside document directory) + + \item[xslt] the file name of an additional XSL transformation file - \item[text-config] container for configuration options - \begin{description} - \item[container-tag] the name of the text root element (default - ``text'') - - \item[ref-element-tag] the name of the element that is used as - unit of reference when results are presented - - \item[pagebreak-tag] the name of the element that indicates page - breaks (default ``pb'') - \end{description} + \item[pagebreak] the name of the element that indicates page breaks + (default ``pb'') \end{description} \end{description} @@ -920,13 +1030,22 @@ reasons then the conditions can be put i container. Other usage conditions like copyright can also be documented in this container. +% attribute for type 'original', 'digital-image', 'text' +% tags can be repeated +% CC license short-cut + + \begin{description} \item[access-conditions] legal and technical conditions for access to this resource \begin{description} \item[attribution] The name or institution this resource should be - attributed to when it's publicly presented + attributed to when it's publicly presented. \\ + The type of resource this condition applies to can be specified with a + \texttt{type} attribute with the values ``original'' (the physical object + that was scanned), ``digital-image'' (the scanned images), ``text'' + (the textual transcript). \begin{description} \item[name] a name (free text) @@ -938,14 +1057,19 @@ documented in this container. library call number) \end{description} - \item[copyright] the copyright holder and it's conditions + \item[copyright] the copyright holder and the copyright conditions. \\ + The type of resource this condition applies to can be specified with a + \texttt{type} attribute with the values ``original'' (the physical object + that was scanned), ``digital-image'' (the scanned images), ``text'' + (the textual transcript). + \begin{description} \item[owner] the name of the copyright holder \begin{description} \item[name] a name (free text) \item[url] a URL (with an optional \texttt{label} attribute to show - as text) + as text) identifying the copyright holder \end{description} \item[date] the date when the copyright was issued @@ -954,6 +1078,11 @@ documented in this container. \item[description] free-text field for special or additional conditions + \item[license] the type of license if its a standardised license e.g. Creative Commons + \begin{description} + \item[url] a URL representing the license e.g. \url{http://creativecommons.org/licenses/by/3.0/} + \end{description} + \end{description}