Diff for /storage/meta/meta-format.tex between versions 1.23 and 1.29

version 1.23, 2010/08/27 15:30:21 version 1.29, 2011/08/01 09:12:47
Line 3 Line 3
 \usepackage[latin1]{inputenc}  \usepackage[latin1]{inputenc}
 \usepackage[T1]{fontenc}  \usepackage[T1]{fontenc}
 \usepackage{ae}  \usepackage{ae}
 %\usepackage{times}  \usepackage{times}
 %\usepackage{courier}  \usepackage{courier}
   
 % create in-text links black (with PDF)  % create in-text links in black (with PDF)
 \usepackage[colorlinks=true,linkcolor=black]{hyperref}  \usepackage[colorlinks=true,linkcolor=black]{hyperref}
 % Format URLs nicely (without PDF)  % Format URLs nicely (without PDF)
 %\usepackage{url}  %\usepackage{url}
Line 16 Line 16
   
 \author{Robert Casties, Dirk Wintergrün, Hans-Christoph Liess}  \author{Robert Casties, Dirk Wintergrün, Hans-Christoph Liess}
   
 \date{V1.3.7 of 27.8.2010}  \date{V1.3.9 of 20.12.2010}
   
 \begin{document}  \begin{document}
   
Line 172  The outer container element is \texttt{r Line 172  The outer container element is \texttt{r
   of this resource to the linked resource -- optional.    of this resource to the linked resource -- optional.
   \end{description}    \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  \item[media-type] \label{tag-media-type} The main media type of this
   resource -- required.\\ The main media type can be overridden by    resource -- required.\\ The main media type can be overridden by
   \texttt{media-type}s in subdirectories. Possible types are    \texttt{media-type}s in subdirectories. Possible types are
Line 298  Metadata elements can appear multiple ti Line 313  Metadata elements can appear multiple ti
   The content type enables the choice of tools to manipulate and    The content type enables the choice of tools to manipulate and
   display the resource. There should be a common list of content    display the resource. There should be a common list of content
   types. For digital documents (books, manuscripts) this would be    types. For digital documents (books, manuscripts) this would be
   "scanned document", for other image data "scanned    ``scanned document'', for other image data ``scanned
   images".\footnote{The criterion for documents is a ordered    images''.\footnote{The criterion for documents is a ordered
     succession of image files (pages) and equal image size and      succession of image files (pages) and equal image size and
     resolution throughout the images of a resource.}      resolution throughout the images of a resource.}
 \end{description}    \end{description}  
Line 652  with detailed information about the manu Line 667  with detailed information about the manu
   \begin{description}    \begin{description}
   \item [title] Title of the manuscript.    \item [title] Title of the manuscript.
   \item [author] The author of the text.    \item [author] The author of the text.
    \item[holding-library] Holding library     \item[holding-library] Holding library.
    \item[call-number] Call number/Shelf mark in holding library     \item[call-number] Call number/Shelf mark in holding library.
   \item[location] Place/City/Country where the manuscript is    \item[location] Place/City/Country where the manuscript is
     currently located.      currently located.
   \item[date calendar="type"] The date of publication with attribute which    \item[date calendar="type"] The date of publication with attribute which
   calendar used. If no attribute used, CE is the default. Can also be    calendar used. If no attribute used, CE is the default. Can also be
   descriptive.    descriptive.
   \item[year calendar="type"] approximate year or century     \item[year calendar="type"] Approximate year or century .
   \item[number-of-folios] Number of folios/pages of the manuscript.    \item[number-of-folios] Number of folios/pages of the manuscript.
   \item[signature] Signature(s) of the manuscript, under which a manuscript is    \item[signature] Signature(s) of the manuscript, under which a manuscript is
   known.    known.
   \item[abstract] Interpretative abstract of the text's content    \item[abstract] Interpretative abstract of the text's content.
   \item[incipit] Incipit    \item[incipit] Incipit (beginning of text).
   \item[explicit] Explicit    \item[explicit] Explicit (end of text).
   \item[contents] Formal description of the text structure (e.g. table of    \item[contents] Formal description of the text structure (e.g. table of
   contents)    contents).
   \item[writing-surface] material of the writing surface (e.g. non-european    \item[writing-surface] material of the writing surface (e.g. ``non-european
   paper, palm leaf,\ldots)    paper'', ``palm leaf'',\ldots)
   \item[foliation] Text giving list or range of folios     \item[foliation] Text giving list or range of folios. 
   \item[page-dimensions] height and width in cm    \item[page-dimensions] height and width in cm.
   \item[written-area-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[lines-per-page] number of lines and columns.
   \item[catchwords] Quire signatures and catchwords    \item[catchwords] Quire signatures and catchwords.
   \item[scripts] Description of the script    \item[scripts] Description of the script and the ink used.
   \item[copyist] Copyist    \item[copyist] Copyist.
   \item[collation-corrections] Notes on collation and corrections    \item[collation-corrections] Notes on collation and corrections.
   \item[binding] Binding    \item[binding] Description of binding.
   \item[notes] Additional notes    \item[notes-on-ownership] Notes on ownership.
     \item[notes] Additional notes.
   \item[secondary-literature] Notes on secondary literature related to the    \item[secondary-literature] Notes on secondary literature related to the
   manuscript    manuscript
   \item [editorial-remarks] Remarks related to the online    \item [editorial-remarks] Remarks related to the online
     publication of the manuscript.      publication of the manuscript.
   
   \item [keywords] Keywords related to the manuscript.    \item [keywords] Keywords related to the manuscript.
    
    
   \end{description}    \end{description}
 \end{description}  \end{description}
   
 \subsubsection{Codex}  \subsubsection{Codex}
   
 \begin{description}  \begin{description}
 \item [bib type="codex"] Codex  \item [bib type="codex"] Codex i.e. bound collection of one or more manuscripts.
   
   \begin{description}    \begin{description}
     %TODO: do we need collection information?
    \item[holding-library] Holding library    \item[holding-library] Holding library.
    \item[call-number] Call number/Shelf mark in holding library    \item[call-number] Call number/Shelf mark in holding library.
   \item[location] Place/City/Country where the codex is    \item[location] Place/City/Country where the codex is
     currently located.      currently located.
   \item[date calendar="type"] Date of the collation of the codex.    \item[date calendar="type"] Date of the collation of the codex.
   \item[year calendar="type"] approximate year or century     \item[year calendar="type"] Approximate year or century .
   \item[number-of-folios] Number of folios/pages of the manuscript.    \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    \item[signature] Signature(s) of the manuscript, under which a manuscript is
   known.    known.
   \item[contents] Formal description of the text structure (e.g. table of    \item[contents] Formal description of the text structure (e.g. table of
   contents)    contents).
   \item[dimensions] height + width in cm    \item[dimensions] height + width in cm.
    \item[binding] Binding    \item[binding] Description of binding.
   \item[notes] Additional notes    \item[notes] Additional notes.
   \item[notes-on-ownership] Notes on ownership    \item[notes-on-ownership] Notes on ownership.
   \end{description}    \end{description}
 \end{description}  \end{description}
   
Line 732  with detailed information about the manu Line 746  with detailed information about the manu
   \item [place] place where the letter was written/sent.    \item [place] place where the letter was written/sent.
   \item [title] Title of the letter -- optional.    \item [title] Title of the letter -- optional.
   \item[incipit] The opening phrase of the letter -- optional.    \item[incipit] The opening phrase of the letter -- optional.
   \item[excipit] The closing phrase of the letter -- optional.    \item[explicit] The closing phrase of the letter -- optional.
   \item [pages] Number of pages of the manuscript.    \item [pages] Number of pages of the manuscript.
   \item [signature] Canonical signature/call number of the manuscript.    \item [signature] Canonical signature/call number of the manuscript.
   \item [description] This can be any kind of description.    \item [description] This can be any kind of description.
Line 778  with detailed information about the manu Line 792  with detailed information about the manu
 \end{description}  \end{description}
   
   
 \subsection{Architectural drawings}  
 \label{sec:doc}  
   
 Specific information for architectural drawings is presented in a  
 \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[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}  
   
   
 \subsection{Document structure (table of contents)}  \subsection{Document structure (table of contents)}
 \label{sec:toc}  \label{sec:toc}
   
Line 1019  documented in this container. Line 1007  documented in this container.
   
 \begin{description}  \begin{description}
 \item[access-conditions] legal and technical conditions for access to  \item[access-conditions] legal and technical conditions for access to
   this resource    this resource. \\
     The \texttt{attribution}, \texttt{copyright}, and \texttt{access}
     tags can be repeated with different \texttt{resource} attributes if
     different conditions apply to different parts of the whole resource.
   
   \begin{description}    \begin{description}
   \item[attribution] The name or institution this resource should be    \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 kind of resource this condition applies to can be specified with a
       \texttt{resource} attribute with the values ``original'' (the
       physical object that was scanned), ``digital-image'' (the scanned
       images), ``text'' (the textual transcript). \\
       All tags inside can be repeated.
   
     \begin{description}      \begin{description}
     \item[name] a name (free text)      \item[name] a name (free text)
Line 1035  documented in this container. Line 1031  documented in this container.
       library call number)        library call number)
     \end{description}      \end{description}
   
   \item[copyright] the copyright holder and it's conditions    \item[copyright] the copyright holder and the copyright conditions. \\
       The kind of resource this condition applies to can be specified with a
       \texttt{resource} attribute with the values ``original'' (the physical object 
       that was scanned), ``digital-image'' (the scanned images), ``text'' 
       (the textual transcript).
   
     \begin{description}      \begin{description}
     \item[owner] the name of the copyright holder      \item[owner] the name of the copyright holder
       \begin{description}        \begin{description}
       \item[name] a name (free text)        \item[name] a name (free text)
   
       \item[url] a URL (with an optional \texttt{label} attribute to show        \item[url] a URL (with an optional \texttt{label} attribute to show
         as text)          as text) identifying the copyright holder
       \end{description}        \end{description}
   
     \item[date] the date when the copyright was issued      \item[date] the date when the copyright was issued
Line 1051  documented in this container. Line 1052  documented in this container.
   
     \item[description] free-text field for special or additional      \item[description] free-text field for special or additional
       conditions        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}
   
       \end{description}
   
   \item[publish-metadata] metadata about this resource can be made  
     freely available when this tag is present (otherwise metadata has  
     the same access conditions as the rest of the resource). Access to  
     the resource itself is regulated separately by the \texttt{access}  
     element.  
   
   \item[access] conditions of access to this resource. Different    \item[access] conditions of access to this resource. Different
     access types are specified by a \texttt{type} attribute:      access types are specified by a \texttt{type} attribute.
       The kind of resource this condition applies to can be specified with a
       \texttt{resource} attribute with the values ``digital-image'' (the
       scanned images), or ``text'' (the textual transcript).
   
     \begin{description}      \begin{description}
     \item[type=group] access restricted to the members of this named      \item[type=group] access restricted to the members of this named
       group. The method to identify a user belonging to a named group        group. The method to identify a user belonging to a named group

Removed from v.1.23  
changed lines
  Added in v.1.29


FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>