Skip to content
GitLab
Commit f38ec4db authored by mmarkus1's avatar mmarkus1
Browse files

Revert "Merge branch 'merge-to-master' into 'develop'" 

This reverts merge request !61
parent a28460b0
Expand all Hide whitespace changes
Inline Side-by-side
application-profiles/graphic-arts/accompanying-texts/intro.xml 0 → 100644
View file @ f38ec4db
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rng" type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?>
<?xml-model href="http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rng" type="application/xml"
schematypens="http://purl.oclc.org/dsdl/schematron"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0" xmlns:lido="http://www.lido-schema.org">
<teiHeader>
<fileDesc>
<titleStmt>
<title>Title</title>
</titleStmt>
<publicationStmt>
<p>Information about publication or distribution</p>
</publicationStmt>
<sourceDesc>
<p>Information about the source</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<text>
<body>
<div xml:id="foreword">
<div xml:lang="de">
<head n="1">Vorwort</head>
<p>Der vorliegende erste Band des LIDO-Handbuchs zur Erfassung und Publikation von
Metadaten zu kulturellen Objekten widmet sich Zeichnungen und druckgraphischen
Werken. Das Handbuch soll Sammlungen dazu befähigen, die Daten ihrer
Sammlungsdokumentation bestmöglich in übergeordneten Webportalen präsentieren zu
können. Dazu sollen nicht nur Basisinformationen, sondern auch detailliertere
wissenschaftliche Erschließungsebenen so weitergegeben werden können, dass sie im
Portalkontext adäquat, d. h. semantisch korrekt ausgewertet werden können. Davon
profitiert die Sammlung, deren Objekte besser auffindbar sind, ebenso wie das
Portal, das qualitativ hochwertige Daten differenziert anbieten kann.</p>
<p>Die Empfehlungen dieses Handbuchs wurden in enger fachlicher Beratung mit dem
Arbeitskreis „Graphik vernetzt“ entwickelt, der Mitarbeiter*innen aus mehr als 60
internationalen graphischen Sammlungen das Forum bietet, um Erfahrungen in
Digitalisierungsprojekten auszutauschen und gemeinsame Standards in der digitalen
Dokumentation von Sammlungsobjekten zu etablieren. Ohne diese Standards wäre es
nicht möglich, eine gemeinsame digitale Forschungsinfrastruktur aufzubauen. Die
von bibliothekarischen Verbundkatalogen bekannte grundsätzliche Notwendigkeit der
Interoperabilität von Daten erfordert einerseits ein definiertes Mindestmaß an
Standardisierung bei der Datenerfassung in den lokalen Informationssystemen,
andererseits benötigt es standardsierte Datenaustauschformate. Hier kommt das
international besonders im Museumsbereich etablierte XML-Harvestingformat LIDO
(Lightweight Information Describing Objects) zum Einsatz.</p>
<p>Das vorliegende Handbuch gibt für die beiden maßgeblichen Ebenen – die Erfassung
und die Herstellung des LIDO-Exports – eine Orientierung. Jeder datenfeldbezogene
Eintrag besteht aus zwei Teilen. Die Hinweise zur Erfassung richten sich an die an
graphischen Sammlungen tätigen Kurator*innen und Museolog*innen, die die
wissenschaftliche Erschließung der Sammlungsbestände leisten oder für deren
Strukturierung und Schwerpunktsetzung verantwortlich sind. Die Hilfestellungen für
den LIDO-Export richten sich an Informationstechniker*innen, die für die
technische Entwicklung und Betreuung der Sammlungsmanagementsysteme zuständig
sind. Sämtliche Empfehlungen dienen dem Ziel, Daten aus unterschiedlichen Quellen
für die Nutzung in Portalanwendungen übersichtlich aufzubereiten, so dass
möglichst umfassende und präzise Suchergebnisse gewährleistet werden können.</p>
<p>Das hier vorgestellte LIDO-Anwendungsprofil 1.0 orientiert sich an den gängigen
Dokumentationsschwerpunkten zu den in graphischen Sammlungen von Museen und
Bibliotheken aufbewahrten Objekten. Dazu zählen unikale Werke wie Zeichnungen oder
illuminierte Handschriften, aber auch mit druckgraphischen Techniken hergestellte
serielle Objekte, ob es sich um Künstlergraphik in den klassischen Techniken wie
Holzschnitt, Kupferstich, Radierung und Lithographie handelt, um Gebrauchsgraphik
oder gedruckte Buchillustrationen. Die Fotografie ist nicht Gegenstand dieses
Bandes.</p>
<p>Ein Vorläufer des vorliegenden Handbuchs war der 2015 publizierte „Gemeinsame
Feldkatalog graphischer Sammlungen“. Für eine ganze Reihe von graphischen
Sammlungen hat er sich bereits als Richtschnur und praktische Anleitung für die
Erstellung von LIDO-Exportdaten aus den hauseigenen Systemen bewährt. Die
Erfahrungen, die während der Realisierung des Graphikportals und insbesondere bei
der Beratung der datenliefernden Institutionen gesammelt wurden, führten zu einer
Erweiterung und teilweisen Überarbeitung der vorangegangenen Empfehlungen, die wir
in Form dieses Handbuches nun vorlegen. Auf relevante strukturelle Änderungen wird
am Anfang der Abschnitte durch einen mit „Neu“ eingeleiteten Passus hingewiesen,
so dass die nachgängige Anpassung von auf Basis des „Gemeinsamen Feldkatalogs“
erstellten Mappings und Transformationen erleichtert wird.</p>
<p>Wir danken insbesondere Dr. des. Tatjana Bartsch, Dr. Regina Doppelbauer, Dr.
Maria Effinger, Dr. Franziska Ehrl, Dr. Anita Haldemann, Dr. Jochen Hesse, Henrike
Hövelmann, Dr. David Klemm, Dr. Gudula Metze, Christiane Pagel, Kathrin
Pokorny-Nagel, Katja Riemer, Dr. Christian Rümelin und Axel Vitzthum für den
ergiebigen fachlichen Austausch rund um die Herausforderungen, die sich beim
praktischen Einsatz von LIDO stellten. Die Rückmeldungen des Arbeitskreises
„Graphik vernetzt“ zeigen die breite Akzeptanz des hier eingeschlagenen Weges. –
Außerdem danken wir Dr. Maria Effinger für die engagierte Betreuung dieser
Publikation, die bei arthistoricum.net der Universitätsbibliothek Heidelberg
erscheint und damit als Print on Demand, aber auch frei zugänglich ist. Mit dieser
Publikation möchten wir dazu beitragen, dass es graphischen Sammlungen wesentlich
erleichtert wird, qualitätsvolle Erschließungsdaten standardisiert an Portale
weiterzugeben.</p>
<closer>Die Autorinnen</closer>
</div>
<div xml:lang="en">
<head>Foreword</head>
<p>...</p>
</div>
</div>
</body>
</text>
</TEI>
application-profiles/graphic-arts/ap-graphic-arts.xsd 0 → 100644
View file @ f38ec4db
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:gml="http://www.opengis.net/gml"
xmlns:doc="http://www.mda.org.uk/spectrumXML/Documentation"
xmlns:lido="http://www.lido-schema.org"
xmlns:owl="http://www.w3.org/2002/07/owl#"
xmlns:sch="http://purl.oclc.org/dsdl/schematron"
xmlns:skos="http://www.w3.org/2004/02/skos/core#"
xmlns:tei="http://www.tei-c.org/ns/1.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
targetNamespace="http://www.lido-schema.org/graphic-arts" elementFormDefault="qualified"
attributeFormDefault="qualified">
<xs:import namespace="http://www.lido-schema.org"
schemaLocation="../../1.1/lido-v1.1.xsd"/>
<!-- allgemeine Einführung, nicht relevant für die Veröffentlichung -->
<xs:annotation>
<xs:documentation xml:lang="de">
<tei:div xml:lang="de">
<tei:head n="1">Proof of Concept: LIDO-Applikationsprofil Graphik</tei:head>
<tei:p rend="indent">Dieses Dokument ist ein <tei:hi rend="italic">Proof of Concept</tei:hi> für das
LIDO-Applikationsprofil „Graphik“. Es zeigt die wesentliche Funktionalität der Einbindung von
mehreren Dokumenten in das Applikationsprofil.</tei:p>
</tei:div>
<tei:div xml:lang="en">
This is the place where you could translate your docs.
</tei:div>
</xs:documentation>
</xs:annotation>
<!-- Import der Begleittexte -->
<xs:annotation xml:id="accompanying-texts">
<xs:documentation>
<xi:include href="accompanying-texts/intro-2.xml" xpointer="LIDO_foundations"/>
<!--<xi:include href="../../1.1/accompanying-texts/about-lido.xml" xpointer="LIDO_foundations"/> -->
</xs:documentation>
</xs:annotation>
<!-- LIDO-Elemente -->
<xs:annotation xml:id="chapter_1_identifier">
<xs:documentation>
<tei:div xml:lang="de">
<tei:head n="1">1. Block: xml:identifier</tei:head>
<tei:head n="4">Dieser Block enthält folgende Felder:</tei:head>
<tei:p rend="leading">
Nr. des LIDO-Datensatzes <tei:lb/>
Published Object xml:identifier
</tei:p>
</tei:div>
<tei:div xml:lang="en"></tei:div>
</xs:documentation>
</xs:annotation>
<xs:complexType name="lidoComplexType" id="lidoComplexType">
<xs:sequence>
<xs:element name="lidoRecID" type="lido:identifierComplexType" maxOccurs="unbounded" id="lidoRecID">
<xs:annotation>
<xs:documentation>
<tei:div xml:lang="de">
<!-- Titel -->
<tei:ab type="title">Nr. des LIDO-Datensatzes (Pflichtelement)</tei:ab>
<!-- Definition -->
<tei:div type="definition">
<tei:p>Eine eindeutige Identifikationsnummer des LIDO-Datensatzes. Diese wird automatisch aus einer Kombination von eindeutiger Identifikation der Datensatzquelle und der Datensatznummer gebildet.</tei:p>
</tei:div>
<!-- Beispiele -->
<tei:div type="examples">
<tei:p>DE-MUS-073216/lido/10102</tei:p>
</tei:div>
<!-- Tipps für die Erfassung -->
<tei:div type="hints_acquisition">
<tei:p>Dieses Datenfeld kann ergänzend zum Objekttyp verwendet werden. Manchmal gilt derselbe Begriff für beide Felder, z.B. Zeichnung...</tei:p>
<tei:p>n der Regel leistet der Gattungsbegriff jedoch die Einordnung des Objekts...</tei:p>
</tei:div>
<!-- Verweise -->
<tei:div type="references">
<tei:p>Wenn die Zugehörigkeit eines Blattes zu einer Serie deutlich gemacht werden soll, gilt dies stets als Beziehung...</tei:p>
</tei:div>
<!-- LIDO-Export -->
<tei:div type="export">
<!-- LIDO-Element -->
<tei:div type="element">
<tei:p>LIDO Metadata Record-ID (lidoRecID)</tei:p>
</tei:div>
<!-- Tipps für den LIDO-Export -->
<tei:div type="hint_export">
<tei:p><tei:hi rend="bold">Achtung: LIDO Pflichtfeld, es muss ein Wert angegeben sein.</tei:hi></tei:p>
<tei:p>Damit sowohl das beschriebene Objekt selbst al...</tei:p>
</tei:div>
<!-- Beispiele -->
<tei:div type="examples">
<tei:p>DE-MUS-047727/lido/db-08781</tei:p>
<tei:p>DE-MUS-296617/lido/2001</tei:p>
<tei:p>gnd16265928-3/lido/doc0000132</tei:p>
</tei:div>
</tei:div>
</tei:div>
<tei:div xml:lang="en">
</tei:div>
</xs:documentation>
</xs:annotation>
</xs:element>
<xs:element name="objectPublishedID" type="lido:identifierComplexType" minOccurs="0"
maxOccurs="unbounded" id="objectPublishedID">
<xs:annotation>
<xs:documentation>
<tei:div xml:lang="de">
<!-- Titel -->
<tei:ab type="title">Published Object Identifier (Pflicht, wenn vorhanden)</tei:ab>
<!-- Definition -->
<tei:div type="definition">
<tei:p>Eine eindeutige Identifikation des Objekts/Werks, das im Datensatz beschrieben wird. Idealerweise wird diese bereits bei der Erfassung aufgenommen und, wenn vorhanden, aus einer Normdatei übernommen. Ist dies nicht der Fall, kann die ID – analog zur LIDO Record ID – aus einer Identifikation der Datensatzquelle und der lokalen Datensatznummer gebildet werden.</tei:p>
</tei:div>
<!--empfohlene Vokabulare/Normdateien-->
<tei:div type="authority">
<tei:p>GND; CONA; Wikidata; VIAF</tei:p>
</tei:div>
<!-- Beispiele -->
<tei:div type="examples">
<tei:p>http://d-nb.info/gnd/4562218-8</tei:p>
<tei:p>https://www.wikidata.org/wiki/Q2628761</tei:p>
<tei:p>DE-MUS-047727/object/db-08781</tei:p>
</tei:div>
<!-- LIDO-Export -->
<tei:div type="export">
<!-- LIDO-Element -->
<tei:div type="element">
<tei:p>Published Object Identifier (objectPublishedID)</tei:p>
</tei:div>
<!-- Tipps für den LIDO-Export -->
<tei:div type="hint_export">
<tei:p>Falls vorhanden, wird der im Erfassungssystem vorgehaltene Objekt-Identifier übernommen....</tei:p>
</tei:div>
</tei:div>
</tei:div>
<tei:div xml:lang="en">
</tei:div>
</xs:documentation>
</xs:annotation>
</xs:element>
</xs:sequence>
</xs:complexType>
<!-- Die Metadaten zum Applikationsprofil werden in einem TEI-Header erfasst -->
<xs:annotation xml:id="header">
<xs:documentation>
<tei:teiHeader>
<tei:fileDesc>
<tei:titleStmt>
<tei:title type="main">
LIDO-Handbuch für die Erfassung und Publikation von Metadaten zu kulturellen Objekten
</tei:title>
<tei:title type="sub">
Band 1: Graphik
</tei:title>
<tei:author>Gudrun Knaus</tei:author>
<tei:author>Regine Stein</tei:author>
<tei:author>Angela Kailus</tei:author>
<tei:author role="contributor">Michael Freiberg</tei:author>
<tei:author role="contributor">Jutta Lindenthal</tei:author>
<tei:editor>Deutsches Dokumentationszentrum für
Kunstgeschichte – Bildarchiv Foto Marburg /
Christian Bracht</tei:editor>
</tei:titleStmt>
<tei:publicationStmt>
<tei:date>2019–2020</tei:date>
<tei:licence target="https://creativecommons.org/licenses/by-sa/4.0/">
<tei:p>The Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
applies to the documentation in this document.</tei:p>
</tei:licence>
<tei:licence target="http://creativecommons.org/licenses/by-sa/3.0/">
<tei:p>The Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
applies to the LIDOv1.1 imports in this document.</tei:p>
</tei:licence>
</tei:publicationStmt>
<tei:sourceDesc>
<tei:p>Born digital.</tei:p>
</tei:sourceDesc>
</tei:fileDesc>
</tei:teiHeader>
</xs:documentation>
</xs:annotation>
</xs:schema>
application-profiles/paintings-and-sculptures/accompanying-texts/intro-paintings-sculptures.xml 0 → 100644
View file @ f38ec4db
<?xml-model href="http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rng" type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?>
<?xml-model href="http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rng" type="application/xml"
schematypens="http://purl.oclc.org/dsdl/schematron"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0" xmlns:lido="http://www.lido-schema.org">
<teiHeader>
<fileDesc>
<titleStmt>
<title>Title</title>
</titleStmt>
<publicationStmt>
<p>Information about publication or distribution</p>
</publicationStmt>
<sourceDesc>
<p>Information about the source</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<text>
<body>
<div xml:id="foreword">
<div xml:lang="de">
<head n="1">Vorwort</head>
<p rend="leading">Der vorliegende zweite Band des LIDO-Handbuchs zur Erfassung und Publikation von
Metadaten zu kulturellen Objekten widmet sich Gemälden und Skulpturen. Das Handbuch soll Sammlungen dazu befähigen, die Daten ihrer
Sammlungsdokumentation bestmöglich in übergeordneten Webportalen präsentieren zu
können. Dazu sollen nicht nur Basisinformationen, sondern auch detailliertere
wissenschaftliche Erschließungsebenen so weitergegeben werden können, dass sie im
Portalkontext adäquat, d. h. semantisch korrekt ausgewertet werden können. Davon
profitiert die Sammlung, deren Objekte besser auffindbar sind, ebenso wie das
Portal, das qualitativ hochwertige Daten differenziert anbieten kann.</p>
<p rend="leading">Ohne gemeinsame Standards in der digitalen Dokumentation von Sammlungsobjekten wäre es
nicht möglich, eine gemeinsame digitale Forschungsinfrastruktur aufzubauen. Die
von bibliothekarischen Verbundkatalogen bekannte grundsätzliche Notwendigkeit der
Interoperabilität von Daten erfordert einerseits ein definiertes Mindestmaß an
Standardisierung bei der Datenerfassung in den lokalen Informationssystemen,
andererseits benötigt es standardisierte Datenaustauschformate. Hier kommt das
international besonders im Museumsbereich etablierte XML-Harvestingformat LIDO
(Lightweight Information Describing Objects) zum Einsatz.</p>
<p>Das Handbuch gibt für die beiden maßgeblichen Ebenen – die Erfassung
und die Herstellung des LIDO-Exports – eine Orientierung. Jeder datenfeldbezogene
Eintrag besteht aus zwei Teilen. Die Hinweise zur Erfassung richten sich an die in
Sammlungen tätigen Kurator*innen und Museolog*innen, die die
wissenschaftliche Erschließung der Sammlungsbestände leisten oder für deren
Strukturierung und Schwerpunktsetzung verantwortlich sind. Die Hilfestellungen für
den LIDO-Export richten sich an Informationstechniker*innen, die für die
technische Entwicklung und Betreuung der Sammlungsmanagementsysteme zuständig
sind. Sämtliche Empfehlungen dienen dem Ziel, Daten aus unterschiedlichen Quellen
für die Nutzung in Portalanwendungen übersichtlich aufzubereiten, so dass
möglichst umfassende und präzise Suchergebnisse gewährleistet werden können.</p>
<p>Das hier vorgestellte LIDO-Anwendungsprofil 1.0
<!-- 1.1?? -->orientiert sich an den gängigen
Dokumentationsschwerpunkten zu den in privaten und öffentlichen Sammlungen aufbewahrten Gemälden und Skulpturen.
Dazu zählen auch Wandgemälde. Für fest an Gebäuden installierte Skulpturen, wie Atlanten oder Hermen, siehe das LIDO-Handbuch: Architektur.
<!-- Link auf das Handbuch ergänzen --> Ebenso ist ein eigener Band des LIDO-Handbuchs für die Fotografie geplant.
Die Vielzahl möglicher Objektarten im Bereich der Gegenwartskunst, wie zeitbasierte Werke (z. B. Performances)
oder Werke, deren Kern nicht in einem sammelbaren Objekt, sondern in der zugrunde liegenden Idee begründet ist,
sind nicht Gegenstand dieses Handbuchs. Empfehlungen dazu werden nach und nach in einzelnen Beispieldatensätzen
im LIDO XML Schema ergänzt und publiziert.
<!-- Wo findet man diese Datensätze? -->
Auch Videokunst oder digitale Kunstwerke werden hier noch nicht berücksichtigt.</p>
<!-- Ergänzen Danksagung an wen?? -->
<div>
<head n="3">Wozu dient dieses Handbuch?</head>
<p rend="leading">
<list>
<item>Für die Erfassung von Metadaten, die man auf sammlungsübergreifenden Plattformen teilen und vernetzen kann</item>
<item>Als Voraussetzung für Treffermengen, die in Umfang und Zielgenauigkeit tatsächlich den Suchbegriffen entsprechen</item>
<item>Als Grundlage für die Entwicklung einer gemeinsamen Erschließungspraxis für Museen und damit für einen verbesserten Zugang zu digitalen Informationen über museale Sammlungsgüter
</item>
</list></p>
</div>
<closer>Die Autorinnen</closer>
</div>
<div xml:lang="en">
<head>Foreword</head>
<p>...</p>
</div>
</div>
</body>
</text>
</TEI>
application-profiles/paintings-and-sculptures/ap-paintings-and-sculptures.xsd 0 → 100644
View file @ f38ec4db
<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:gml="http://www.opengis.net/gml"
xmlns:doc="http://www.mda.org.uk/spectrumXML/Documentation"
xmlns:lido="http://www.lido-schema.org"
xmlns:owl="http://www.w3.org/2002/07/owl#"
xmlns:sch="http://purl.oclc.org/dsdl/schematron"
xmlns:skos="http://www.w3.org/2004/02/skos/core#"
xmlns:tei="http://www.tei-c.org/ns/1.0"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:xml="http://www.w3.org/XML/1998/namespace"
targetNamespace="http://www.lido-schema.org/graphic-arts" elementFormDefault="qualified"
attributeFormDefault="qualified">
<xs:import namespace="http://www.lido-schema.org"
schemaLocation="../../1.1/lido-v1.1.xsd"/>
<!-- allgemeine Einführung, nicht relevant für die Veröffentlichung -->
<xs:annotation>
<xs:documentation xml:lang="de">
<tei:div xml:lang="de">
<tei:head n="1">Proof of Concept: LIDO-Applikationsprofil Graphik</tei:head>
<tei:p rend="indent">Dieses Dokument ist ein <tei:hi rend="italic">Proof of Concept</tei:hi> für das
LIDO-Applikationsprofil „Graphik“. Es zeigt die wesentliche Funktionalität der Einbindung von
mehreren Dokumenten in das Applikationsprofil.</tei:p>
</tei:div>
<tei:div xml:lang="en">
This is the place where you could translate your docs.
</tei:div>
</xs:documentation>
</xs:annotation>
<!-- Import der Begleittexte -->
<xs:annotation xml:id="accompanying-texts">
<xs:documentation>
<!--<xi:include href="accompanying-texts/intro.xml" xpointer="foreword"/>-->
<!--<xi:include href="../../1.1/accompanying-texts/about-lido.xml" xpointer="LIDO_foundations"/>-->
</xs:documentation>
</xs:annotation>
<!-- Import und eventuelle Einschränkung von LIDO-Elementen -->
<xs:annotation xml:id="chapter_1_identifier">
<xs:documentation>
<tei:div xml:lang="de">
<tei:head n="1">1. Block: xml:identifier</tei:head>
<tei:head n="4">Dieser Block enthält folgende Felder:</tei:head>
<tei:p rend="leading">
Nr. des LIDO-Datensatzes <tei:lb/>
Published Object xml:identifier
</tei:p>
</tei:div>
<tei:div xml:lang="en"></tei:div>
</xs:documentation>
</xs:annotation>
<!-- Die Metadaten zum Applikationsprofil werden in einem TEI-Header erfasst -->
<xs:annotation xml:id="header">
<xs:documentation>
<tei:teiHeader>
<tei:fileDesc>
<tei:titleStmt>
<tei:title type="main">
LIDO-Handbuch für die Erfassung und Publikation von Metadaten zu kulturellen Objekten
</tei:title>
<tei:title type="sub">
Band 1: Graphik
</tei:title>
<tei:author>Gudrun Knaus</tei:author>
<tei:author>Regine Stein</tei:author>
<tei:author>Angela Kailus</tei:author>
<tei:author role="contributor">Michael Freiberg</tei:author>
<tei:author role="contributor">Jutta Lindenthal</tei:author>
<tei:editor>Deutsches Dokumentationszentrum für
Kunstgeschichte – Bildarchiv Foto Marburg /
Christian Bracht</tei:editor>
</tei:titleStmt>
<tei:publicationStmt>
<tei:date>2019–2020</tei:date>
<tei:licence target="https://creativecommons.org/licenses/by-sa/4.0/">
<tei:p>The Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
applies to the documentation in this document.</tei:p>
</tei:licence>
<tei:licence target="http://creativecommons.org/licenses/by-sa/3.0/">
<tei:p>The Creative Commons Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)
applies to the LIDOv1.1 imports in this document.</tei:p>
</tei:licence>
</tei:publicationStmt>
<tei:sourceDesc>
<tei:p>Born digital.</tei:p>
</tei:sourceDesc>
</tei:fileDesc>
</tei:teiHeader>
</xs:documentation>
</xs:annotation>
</xs:schema>
docs/application-profiles-accompanying-texts.md 0 → 100644
View file @ f38ec4db
# Readme for LIDO Application Profiles - Accompanying texts
This document provides guidelines for the creation and editing of accompanying texts for LIDO Application Profiles by the LIDO working group *LIDO AG*. The application profile schema allows the use of accompanying texts so that shared or more often used texts can be outsourced. This increases the overview and avoids duplication of work. There are generally two types of accompanying texts:
- general accompanying texts of LIDO in `1.1/accompanying-texts/`
- application profile specific accompanying texts in `applications-profiles/name-of-your-application-profile/accompanying-texts/`
## Usage
To add a new accompanying text, you need to create a new *.xml file in one of the above mentioned folders. Please start with the following frame:
```xml
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rng" type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?>
<?xml-model href="http://www.tei-c.org/release/xml/tei/custom/schema/relaxng/tei_all.rng" type="application/xml"
schematypens="http://purl.oclc.org/dsdl/schematron"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0" xmlns:lido="http://www.lido-schema.org">
<teiHeader>
<fileDesc>
<titleStmt>
<title>Title</title>
</titleStmt>
<publicationStmt>
<p>Information about publication or distribution</p>
</publicationStmt>
<sourceDesc>
<p>Information about the source</p>
</sourceDesc>
</fileDesc>
</teiHeader>
<text>
<body>
<div xml:id="Enter-Your-ID-Here">
<div xml:lang="Enter-Your-Language-Here">
<head n="1">Title</head>
<p>
YOUR TEXT HERE
</p>
</div>
</div>
</body>
</text>
</TEI>
```
To integrate the file and thus the accompanying text into a profile, proceed as follows:
1. Choose a unique ID and replace "Enter-Your-ID-Here"
2. Write your desired accompanying text with all options available [**see application-profiles-documentation.md**](../docs/application-profiles-documentation.md) and replace "YOUR TEXT HERE"
3. Integrate the file and the unique ID in the schema file (.xsd) where you want it as follows:
```xml
<xs:annotation xml:id="accompanying-texts">
<xs:documentation>
<xi:include href="accompanying-texts/YOUR-FILE-NAME.xml" xpointer="Your-ID-Here"/>
</xs:documentation>
</xs:annotation>
```
The automated process of publication will include the accompanying texts in the appropriate language of the documentation.
docs/application-profiles-schemafile.md 0 → 100644
View file @ f38ec4db
# Readme for LIDO Application Profiles - Elements
**TODO**
### Multilingualism
Use `<div xml:lang="de">` to create text blocks in any language. The language needs to be selected from a controlled list. We achieve this by requiring the use of two-letter codes listed in the international standard ISO 639-1 for the representation of names of languages (such as "en" for "English" or "de" for "German").
**TODO**
Example
docs/application-profiles.md 0 → 100644
View file @ f38ec4db
# Readme for LIDO Application Profiles
This document provides guidelines for the creation and editing of LIDO Application Profiles by the LIDO working group *LIDO AG*. The document explains the key structure and component of a LIDO Application Profile and walks through the process of developing a profile. The document is aimed at designers of application profiles.
## Usage
All application profiles are in the `applications-profiles/` folder. Each application profile has its own folder. Please keep the given structure to create or update an application profile:
- `applications-profiles/name-of-your-application-profile/`
- `applications-profiles/name-of-your-application-profile/schema-file.xsd`
- `applications-profiles/name-of-your-application-profile/img/`
- `applications-profiles/name-of-your-application-profile/accompanying-texts/`
- `1.1/accompanying-texts/`
### Schema file
The XML Schema Definition file (.xsd) is the main component of an application profile. It specifies how to formally describe the elements and how to use them (documentation) in the scope of the application. The following applies: The entire scheme is always LIDO valid. Typically, the focus is on documentation in order to support users when using a profile. Please visit [**application-profiles-documentation.md**](../docs/application-profiles-schemafile.md) to learn how to create and update such an documentation.
A manual will be automatically generated from the schema file. It is important that the given structure and format in the schema file are adhered to. For more information about this automated generation visit [**lido-publication**](https://gitlab.gwdg.de/lido/lido-publication).
### Image folder
To use images in the documentation read [**application-profiles-documentation.md**](../docs/application-profiles-documentation.md). All images used must be in this folder.
### Accompanying texts
The schema allows the use of accompanying texts so that shared or more often used texts can be outsourced. This increases the overview and avoids duplication of work. Please create one file for each accompanying texts and visit [**application-profiles-accompanying-texts.md**](../docs/application-profiles-accompanying-texts.md) to learn how to use them.
docs/schema-documentation.md 0 → 100644
View file @ f38ec4db
# Documentation
This document provides guidelines for the creation and editing of LIDO documentation by the LIDO working group *LIDO AG*. This includes the documentation of elements, complex types and attributes using TEI elements. The serialization of the PDF and HTML documentation is based on these elements and should therefore be adhered to.
## Usage
### General
The documentation in the form of TEI elements takes place within xs: documentation directly below the element/complexTypes/Attribute, e.g.
```xml
<xs:annotation>
<xs:documentation>
<tei:ab type="definition">Holds the metadata of an object/work.</tei:ab>
</xs:documentation>