SIG:MSS

2014-08-08T09:43:38Z

Emmanuel Chateau: /* Manuscript Editions */ add a new website

<big>'''TEI Special Interest Group on Manuscripts (TEI MS SIG)'''</big>

== Introduction ==
The goal of the TEI Special Interest Group on Manuscripts is to bring together users of the TEI who wish to improve the encoding strategies for marking up transcriptions and editions of manuscript materials. The SIG was originally setup by Elena Pierazzo, Susan Schreibman, and Edward Vanhoutte. It is currently convened by Gerrit Brüning and Dot Porter.

The SIG runs a mailing list. To join visit http://listserv.brown.edu/tei-ms-sig.html.

==Achievements==
The SIG’s most important achievements were in the field of the representation of primary sources, resulting in the proposals of the working group on [[Genetic Editions]] which were submitted as “[http://www.tei-c.org/Activities/Council/Working/tcw19.html An Encoding Model for Genetic Editions]” and largely incorporated in the TEI Guidelines.

Important work was done towards a revision of the chapter on critical apparatus, see working group on [[Critical_Apparatus_Workgroup|Critical Apparatus]] / [[Textual Variance]].

== Agenda of this SIG ==
Revision of the chapter on critical apparatus; issues of variation; clarify the role of using the critical apparatus tagset in manuscript transcription (which is dependent on whether one is encoding an edition or encoding a manuscript transcription). See
*[[Critical_Apparatus_Workgroup|Critical Apparatus]]
and the following threads on sourceforge, TEI-L, and SIG-L:
*http://sourceforge.net/p/tei/bugs/357/
*http://listserv.brown.edu/archives/cgi-bin/wa?A2=TEI-L;bfa42e32.1310
*http://listserv.brown.edu/archives/cgi-bin/wa?A2=TEI-MS-SIG;ad41772a.1401
*“[http://listserv.brown.edu/archives/cgi-bin/wa?A1=ind1401&L=TEI-MS-SIG#3 App. Crit. state of play and questions]” and related threads on SIG-L from January 2014.
*“[https://listserv.brown.edu/archives/cgi-bin/wa?A2=TEI-L;7d23da20.1407 <rdg>s that go on and on]“ (July 2014)
*http://sourceforge.net/p/tei/feature-requests/521/

Revision of the chapter on manuscript description; see working group on [[msDesc enhancement|MSS Description]].

Continuing and extending the work on the chapter on the representation of primary sources, see [[Sandbox for Genetic Editing]].

Further issues:
* how to encode fragments
* how to record codicology (the substance of the medium, ink stints, etc); Robinson noted that the TEI already has mechanisms to record this, but it needs to be better documented

== Past Meetings ==
The SIG met at the Third Annual TEI Members' Meeting in Nancy, France on 08 November 2003. The report can be found [http://www.tei-c.org/Activities/SIG/Manuscript/mssigr01.xml here].

The second meeting of the SIG was held at the Fourth Annual TEI Members' Meeting at Johns Hopkins University, Baltimore, USA, 23 October 2004. The report can be found [http://www.tei-c.org/Activities/SIG/Manuscript/mssigr02.xml here].

The third meeting of the SIG was held at Seventh Annual TEI Member's Meeting at University of Maryland, College Park, 3nd of November 2007. The agenda of the meeting can be found [[MS SIG Agenda 2007|here]]; the report can be found [[MS SIG Report 07|here]]. During the meeting several task forces were created to deal with specific problems: the task forces main page can be found [[MS task forces|here]].

More recent meetings:
* [[SIGMS_Agenda_20081108|Agenda SIG meeting, London 8 November 2008]]
* [[SIGMS_Minutes_20091114|Minutes SIG meeting, Ann Arbor 14 November 2009]]
* [[SIGMS_Minutes_20101112|Minutes SIG meeting, Zadar 12 November 2010]]
* [[SIGMS_Minutes_20111014|Minutes SIG meeting, Würzburg 14 October 2011]]
* [[MS_SIG_meeting,_Rome,_3_October_2013|Minutes SIG meeting, Rome, 3 October 2013]]

== Links ==
=== Lists ===
*List of “institutions using TEI to encode and digitize manuscripts,” compiled by Tucker Hannah (https://listserv.brown.edu/archives/cgi-bin/wa?A2=TEI-MS-SIG;e8b927bf.1304):<br>https://docs.google.com/document/d/1Wv5Xn4aUW8uNUv1c-B5KNyzRx_TmWOKYEZylv5znPzc/edit
*A Catalog of Digital Scholarly Editions http://www.digitale-edition.de./
*Digital Editions Catalogue https://docs.google.com/spreadsheet/ccc?key=0Ag9fg4mfdAuPdHF2Y0twOVpaYS1MbjVWY25UNFZYWFE#gid=0
*Editions Database (“Editionen-Datenbank”) of the Deutsches Literaturarchiv Marbach (DLA) http://www.dla-marbach.de/?id=60340

=== Manuscript Description ===

Projects, resources, guidelines concerning MS description.

* [http://enrich.manuscriptorium.com ENRICH project] - standardising and aggregating medieval manuscript descriptions. See also [http://tei.oucs.ox.ac.uk/ENRICH/ OUCS ENRICH Website] containing ENRICH Schemas, ODD, Documentation and Training Materials.
* [http://sunsite3.berkeley.edu/Scriptorium/ Digital Scriptorium] (see especially the [http://sunsite3.berkeley.edu/Scriptorium/technical/description_dtd.html DESCRIPTION DTD] page).
* [http://www.hab.de/forschung/projekte/master-e.htm MASTER - Interface format for the description of medieval manuscripts]
* [http://www.tei-c.org/Activities/MS/msw05.xml Reviews of the manuscript description chapter: A summary]

=== Manuscript Editions ===
* [http://bdinski.obdurodon.org/ Bdinski sbornik: Manuscript and text]
* [http://www.kantl.be/ctb/project/dalf/ DALF: Digital Archive of Letters in Flanders]
* [http://web.uvic.ca/hrd/lydgate/pilot.htm Partial Transcription of John Lydgate's "Fall of Princes"]
* [http://www.digitalmishnah.umd.edu/ Digital Mishnah Project]
* [http://mitford.pitt.edu/index.html Digital Mitford: The Mary Russell Mitford Archive]
* [http://www.newtonproject.ic.ac.uk/prism.php?id=1 The Newton Project]
* [http://webapp1.dlib.indiana.edu/newton/index.jsp The Chymistry of Isaac Newton]
* [http://elec.enc.sorbonne.fr/chroniqueslatines/ Chroniques latines de Saint-Denis] : critical edition using TEI P4 (but we hope to migrate in P5 this year) : [http://elec.enc.sorbonne.fr/chroniqueslatines/xml/chroniquesstdenis.xml XML Files]
* [http://www.marktwainproject.org/homepage.html Mark Twain Project Online]
* [http://vbd.humnet.unipi.it/ Digital Vercelli Book]
* [http://www.desgodets.net Les Cours d'Antoine Desgodets]

=== Manuscript Transcription ===
Projects, resources, guidelines concerning MS transcription.
* [http://www.cdlib.org/inside/diglib/stwg/ms/ CDL Encoding Guidelines for Manuscripts and Rare Books]
* [http://www.scriptorium.columbia.edu/ Digital Scriptorium] (see especially the [https://www1.columbia.edu/sec/cu/libraries/bts/digital_scriptorium/technical/ds-xml/transcription_dtd/index.html TRANSCRIPTION DTD] and [https://www1.columbia.edu/sec/cu/libraries/bts/digital_scriptorium/technical/ds-xml/description_dtd/index.html DESCRIPTION DTD] pages).
* [[EpiDoc]], guidelines for transcribing ancient texts
* [http://skaldic.arts.usyd.edu.au/docs/guidelines/guide.html Guidelines for the electronic edition of the skaldic corpus]
* [http://gandalf.aksis.uib.no/menota/guidelines/ The Menota handbook]
*[http://ahds.ac.uk/creating/case-studies/newton/index.htm The Newton Project: Implementing and Exploiting XML]
* [http://www.whitmanarchive.org/guidelines/ The Walt Whitman Archive Encoding Guidelines for Poetry Manuscripts]
* [http://jefferson.village.virginia.edu/seenet/piers/protocoltran.html Transcriptional Protocols: Piers Plowman Electronic Archive and SEENET]
* [http://lemo.irht.cnrs.fr/43/43-12.htm Réflexions sur l'utilisation de la TEI pour encoder les sources diplomatiques] and [http://elec.enc.sorbonne.fr/cartulaireblanc/guidebalisage/ Guide du balisage du Cartulaire blanc] : two resources in French
* [http://ccfm.ens-lsh.fr/IMG/pdf/BFM-Mss_Encodage-XML.pdf Base de Français Médiéval - MSS Encoding Guidelines (in French)]
* [http://marjorie.burghart.online.fr/?q=en/content/tei-critical-apparatus-cheatsheet TEI: Critical Apparatus Cheatsheet]

===Projects using the new genetic or documentary markup===
*Textgenetic edition of Hermann Burger's Lokalbericht; currently being modeled at [http://www.nb.admin.ch/org/organisation/00783/?lang=en SLA]/[http://www.cceh.uni-koeln.de CCeH], cf. [http://dh13.sagw.ch/de/dh13/poster/poster/zumsteg.html poster]
* '''[http://www.uni-goettingen.de/en/303691.html Genetic-critical and annotated hybrid-edition of Theodor Fontane’s notebooks based on a virtual research environment]''': The TEI code (not published yet) is based on a <sourceDoc>/<zone>/<line> structure.
* '''[http://shelleygodwinarchive.org/ The Shelley-Godwin Archive]''' employs an encoding based on <sourceDoc>/<zone>/<line> and making use of <milestone> (e.g. <milestone unit="tei:p"/>) and <anchor> elements. The archive distinguishes two stages of transcriptions (basic and fully vetted) and the TEI encodings are directly accessible through the browser.
*Edition of Goethe’s Faust https://faustedition.uni-wuerzburg.de/dev/project/about
*Transcription of the [http://en.wikipedia.org/wiki/Holy_Trinity_Church,_Long_Melford#Clopton_Chantry_Chapel John Lydgate verses at Holy Trinity, Long Melford], see Matthew Davis’ post on TEI-L: http://listserv.brown.edu/archives/cgi-bin/wa?A2=TEI-L;34ca5119.1311
*Representation of the papers of Fernando Pessoa, see http://listserv.brown.edu/archives/cgi-bin/wa?A2=tei-l;50923a39.1402
* Proust Prototype http://research.cch.kcl.ac.uk/proust_prototype/ (see http://markmail.org/message/vtuwcuckf4ukxqfk)

[[Category:SIG|MSS]]
[[Category:SIG:Manuscripts]]

ODD

2014-02-22T10:54:41Z

Emmanuel Chateau: /* Articles */

'''ODD''' stands for "One Document Does it all". It is a TEI XML-conformant specification format that allows one to customize TEI P5 in a [[Wikipedia:literate programming|literate programming]] fashion. It uses elements from the new [http://www.tei-c.org/P5/Guidelines/TD.html Documentation Elements] module.

== Description ==
The TEI Guidelines, its DTD, and its schema fragments, are all produced from a single XML resource containing:

# Descriptive prose (lots of it)
# Examples of usage (plenty)
# Formal declarations for components of the TEI Abstract Model:
## elements and attributes
## modules
## classes and macros

We call this resource an ODD (One Document Does it all), although the master source is instantiated as a gazillion XML mini-documents.

A system of XSLT stylesheets called [[Roma]] has been created for the purpose of easy manipulation of ODD files.

== Example ==
The TEI scheme can only be used by customizing it. Customizations are also expressed in the ODD language. For example:

<pre>
<schemaSpec ident="myTEIlite">
<desc>This is TEI Lite with simplified heads</desc>
<moduleRef key="tei"/>
<moduleRef key="textstructure"/>
<moduleRef key="linking"/>
<moduleRef key="core"/>
<moduleRef key="header"/>
<elementSpec ident="head" mode="change">
<content><rng:text/></content>
</elementSpec>
</schemaSpec>
</pre>

produces the schema a bit like TEI Lite, with a slight change.

== Uses besides the TEI Guidelines and various customizations ==

* [http://www.w3.org/TR/its/ Internationalization Tag Set (ITS)]
* various standards proposal designed within ISO committee TC 37 have been totally or partially written in TEI/ODD: MLIF, MAF, ISO 16642 rev., ISOTimeML

== Future plans ==

Over the years ODD has evolved progressively to reflect more and more needs of the TEI community, both as the core specification language for the TEI guidelines, but also as generic customization language for any TEI users. Still ODD remains a hybrid environment combining its own vacabulary with RelaxNG fragments and at times, validation vocabularies from external languages (e.g. Schematron). The TEI council contemplates putting on its work program a revision of the ODD infrastructure, considering either to drop it altogether in favor of one existing schema language, or extend its capabilities to make it a self contained and generic specification language. Some thoughts are included at [[ODD-dev]].

== See also ==
*[http://en.wikipedia.org/wiki/ODD_%28Text_Encoding_Initiative%29 ODD (Text Encoding Initiative)] in Wikipedia
*[[ODD-dev]]
=== Documentation ===
*[http://www.tei-c.org/Guidelines/Customization/odds.xml Getting Started with P5 ODDs]
*[http://www.w3.org/TR/xml-i18n-bp/#tei-modularization A fragment of W3C's Best Practices for XML Internationalization concerning ODD customization for the Internationalization Tag Set (ITS).]
=== Presentations ===
*[http://tei.oucs.ox.ac.uk/Oxford/2007-02-13-oucs/talk-odds.xml A talk about the ODD system], given on 13 Feb 2007 by Lou Burnard and Sebastian Rahtz at the OUCS ''Encoding Digital Texts'' workshop
*[http://tei.oucs.ox.ac.uk/Oxford/2006-09-methNet/Talks/RomaJourney.ppt A PowerPoint presentation on TEI/ODD] by Laurent Romary; OUCS, September 2006
*[http://www.balisage.net/Proceedings/vol7/html/Banski01/BalisageVol7-Banski01.html Literate serialization of linguistic metamodels] by Piotr Bański, Balisage-2011

=== Articles ===
* [http://jtei.revues.org/842 Resolving the Durand Conundrum], by Lou Burnard
* [http://conferences.idealliance.org/extreme/html/2004/Bauman01/EML2004Bauman01.html Odd Customizations], by Syd Bauman and Julia Flanders.
* [http://conferences.idealliance.org/extreme/html/2004/Burnard01/EML2004Burnard01.html RelaxNG with Son of ODD], by Lou Burnard and Sebastian Rahtz.
* [http://www.balisage.net/Proceedings/vol1/html/Bauman01/BalisageVol1-Bauman01.html Freedom to Constrain] by Syd Bauman

[[Category:Customization|!]]

TEIWiki - User contributions [en]

SIG:MSS

ODD