TEIWiki - User contributions [en]

SIG:Correspondence

2014-10-09T15:02:57Z

Magdalena Turska: /* Ongoing Projects */

== News ==

* [[SIG:Correspondence/minutes-rome|minutes]] of the SIG meeting at Rome, final version --[[User:Pstadler|pstadler]] 09:03, 26 November 2013 (EST)
* New page for the [[SIG:Correspondence/task-force-correspDesc|correspDesc task force]] --[[User:Pstadler|pstadler]] 10:22, 11 November 2013 (EST)

== Introduction ==
The TEI Special Interest Group on Correspondence seeks to bring together scholars interested in creating digital scholarly editions of correspondence. The goal of the SIG will be to discuss and develop sample tagsets (including suggesting additions/modifications to the TEI Guidelines) for varying forms of correspondence as well as to create tutorials and best practice models.

Because the initiative for this SIG emerged from editorial work with 19th century letters, the organizers of this SIG have focused on these types of materials. However, we want this SIG to be more encompassing, embracing varying types of historical and literary correspondence including epistles, telegrams, postcards, etc., and perhaps other types of documents that share features with physical written correspondence like diaries, diary entries, letters to the editor, e-mail, blogs, etc.

The common feature of these sorts of text is a generally formalized physical appearance (e.g., an envelope for letters) and structure of content (i.e. address field, special formulas for opener and closer). [http://www.tei-c.org/Activities/Projects/da03.xml DALF] was one of the best documented projects in this area developing specific DTDs for those needs in P4: this may be a starting point for further work in P5.

Initial topics for the SIG Correspondence may include:
* the handling of the envelope and postal addresses
* the formal description of correspondence as a written dialogue between an author and an addressee
* correspondence-specific bibliographical data within the metadata section

== Activities ==

The SIG runs a mailing list, which you can join by visiting http://listserv.brown.edu/tei-corresp-sig.html .

=== Topics currently under discussion ===
* The content of a special '''correspDesc''' element (see [[SIG:Correspondence/ODD_work]])
* Discussion of different P5-customizations for correspondence (see [[SIG:Correspondence/EncodingComparisons]])
--> For this, see the work of the [[SIG:Correspondence/task-force-correspDesc|correspDesc task force]] for current developments.
* The content model of '''postscript''': look at the [[Collection of Postscript-Examples]] and the contributions to the [[ps-discussion]].
* How to deal with '''enclosures''' or '''attachements''' to a letter
* The content model of opener/closer and their connection with salute, signed, dateline, etc.
* diary entries
* definition of <signed> does not correspond with its actual use in the P5 guidelines
* address now in <p> but not in <div>: maybe not a good idea
* notification of addresses (different in different parts of the world). Could this be handled more adequately than just with datelines?
* [[SIG:Correspondence/pre-printed_text|pre-printed text]] (e.g. letterhead, postcard captions)

=== Meetings ===

==== Rome, Oct 3, 2013 ====

Exhaustive minutes at [[SIG:Correspondence/minutes-rome]]

==== College Station, Nov 9, 2012 ====

09-12:30PM at Rudder Tower 302

'''Agenda''':

# Report on last year's activities
# [[SIG:Correspondence/RequestForModule|Request for a correspondence module and a wrapper element for correspondence meta data]]
# AOB

'''Minutes'''

Short summary/Outcome: [[SIG:Correspondence/ODD_work|A second draft for a correspondence ODD]]

Details: [[Minutes College Station]]

==== Wuerzburg, Oct 15, 2011 ====

Agenda of the meeting during the Wuerzburg MM (on Oct 15, 2011 from 9am to 10:30am in room 1.003):
* 1. New members / projects / demands
* 2. Short survey of the development of the SIG and the topics discussed
* 3. Views of the group about proposing a <correspDesc> (or similar) element or not
* 4. Future activities of the SIG: P5-Customizations for Correspondence ("Dalfy" et al.) / Special Guidelines (TEI by example) / Proposals / Next Steps
* 5. Roadmap for 2012
* 6. Website and Wiki

===== Minutes / Results / Goals =====

For more detailed minutes see [[SIGcorresp Minutes 20111015|Minutes Wuerzburg]], the main results of the discussions and the goals for the near future are summed up here:

* Preliminary goal: initiate a comparison between several customized or non-customized TEI versions for correspondence (to be published on the WiKi)
* Middle-term goal: propose "official" customization(s) for correspondence
* Middle-term goal: ask people to make some or their examples available and find out in which way they used TEI for correspondence
* Middle-term goal: develop best practice models
* Long-term goal: develop a compressed proposal for handling correspondence within TEI

==== Zadar, Nov 13, 2010 ====

Participation: around 5 people

1. Peter gave a report on last year's activities
* Task force ‘Dalfy’ was established after the Ann Arbor Meeting: Markus Flatscher, Bert Van Raemdonck, Peter Stadler
* Goal: Mapping of DALF (P4) to TEI P5 as a basis for further work on a correspondence customization
* But: Momentum got lost …
* Further: Some discussion on TEI-L about "signed vs. salute"

2. A brief look on open questions
* Correspondence meta data: correspDesc?
* The content model of postscript (cf. the Collection of Postscript-Examples and the contributions to the ps-discussion.)
* The content model of opener/closer and their connection with salute, signed, dateline, byline etc.

3. Attempt to create a roadmap for 2011
* Peter suggested a second attempt for a grant to achieve the mapping of DALF to P5
* Discussion about possible fundings for such an attempt
* review of the last failed TEI grant proposal: it was criticized by the present panel members that no preliminary work was (visibly) carried out
* Susan suggested to first initiate a survey on the correspondence list

4. AOB
* nothing

==== Ann Arbor, Nov 14, 2009 ====

Business and working meeting during the annual members meeting.
'''Participants''': Syd Bauman (SB), Markus Flatscher (MF), Elena Pierazzo (EP), Malte Rehbein (MR), Paul Schaffner (PSc), Peter Stadler (PSt), Bert Van Raemdonck (BV)

The business meeting was attended by MF, PSc, PSt and BV and - since the number of participants allowed it - was an informal talk about the different projects, the last meeting at London and the "correspDesc" PS had proposed there as well as the question whether editing correspondence from printed (secondary) material needs to treated differently than correspondence from manuscript source material. Work on the roadmap was postponed to the working meeting.

The working meeting was attended by all above mentioned participants who agreed on the need for a customization of some of the P5 elements (and element classes) for encoding correspondence. Question is of course: how?
* P5 has introduced some elements that were inspired by what had been done earlier in DALF (P4), but not all P4 customizations in DALF are actually rendered in P5 (and vice versa). Hence, a comparison of both should be a good starting point to eventually come to a new ODD for encoding correspondence, and maybe even for introducing an actual module for future TEI Guidelines.
* MF, PSt and BV agree on doing such a mapping together. Since BV is like the only DALF original left, he will coordinate this: he will split the work up, and will be contacting MF and PSt for further arrangements. [UPDATE: Edward Vanhoutte and Ron Van den Branden agreed to work on this with BV face to face and then get back to MF and PSt afterwards. --[[User:Pstadler|pstadler]] 07:04, 27 November 2009 (EST)]
* Before X-mas, there should be a conference call to catch up on how the mapping proceeds. PSt will contact Dan O'Donnell for funding.
* Bugs and absurdities in P5 regarding correspondence should be posted on Sourceforge. Elena Pierazzo will be the liaison between the SIG and the TEI Council. She will help SIG members to report our findings through Sourceforge or otherwise.
* The mapping should result in a new ODD. SB is willing to help us create it. The new ODD should somehow be more or less DALF-like. Hence, the working title of the ODD is 'Dalfy'. Dalfy will be an oddified version of DALF where obviously identical concepts will already be mapped to their P5 equivalents (therefore Dalfy != DALF).
* After the mapping is done, useful elements (or concepts, structures) that are neither in DALF or in P5 yet, should be listed. Members of the SIG are welcome to suggest their own 'favourite missing elements'.
* With Dalfy as starting point we can than try to rearrange and modify it to come to a new Correspondence ODD (no code name yet!) that should resolve all problems and satisfy all needs...
* Issues that came up during the meetings concern <address> (and multiple addresses within one letter) (SB and EP), <signed> (everyone), endorsements as well as correspondence by committee (PSc)
* Besides the work on Dalfy PSt shall finish his work on oddifying his <correspDesc>.
'''Roadmap/Milestones''':
* Before Christmas: Teleconference about the mapping (MF, PSt, BV)
* Febr. 10, 2010: Mapping done
* July, 2010: Next SIG meeting at Digital Humanities conference (London) on new ODD

[Minutes PSt and BV]

==== London, Nov 8, 2008 ====

The first section (14-15:30) saw short presentations of current projects by:
* Tim McLoughlin: James Barry's letters
* Hilde Bøe: eMunch project (assisted by Ellen Nessheim Wiger with the Henrik Ibsen correspondence)
* Peter Boot: correspondence of Vincent van Gogh
* David Sewell: correspondence projects published via ROTUNDA
* Deborah K. Wright: correspondence of Matthew Prior
* Peter Stadler: correspondence of Carl Maria von Weber

The second section (16-16:45) had to be shortened due to organisational necessities but saw general discussion about
* the content model of postscript which is rather restricted and does not allow for an i.e. '''head''' element. Everyone was encouraged to send examples via the list. [Let me add that the same holds true for '''address''' --[[User:Pstadler|pstadler]]]
* the need and the possible content for an '''correspDesc''' element within '''sourceDesc'''. I will try to create an odd file with the necessary additions to the schema as a starting point for further expertise. --[[User:Pstadler|pstadler]].
* correspondence as an event. Lou pointed this out as similar topics were discussed in the ontologies SIG.

== Correspondence Projects ==

Please add your projects alphabetically with link and (if possible) a short description!

=== Ongoing Projects ===

* [http://gams.uni-graz.at/fedora/get/container:rollett/bdef:Container/get The Letters of Alexander Rollett]. A project of the Center for Information Modeling in the Humanities (ZIM) at the University of Graz.
* Alfred Escher Correspondence. A project of the Alfred Escher Foundation, Zurich [http://www.alfred-escher.ch (Alfred Escher-Stiftung)]. Edition of the correspondence of Alfred Escher, influential 19th century Swiss politician and entrepreneur (e.g. Credit Suisse, Gotthard railway), comprising several thousand letters. At first, an edition of selected letters to and from Escher will be published in book form, including rich annotations. The first volume of the series is already available. Later on, the correspondence of Alfred Escher will be made available online. The correspondence covers topics as diverse as politics, economics, education, railways, banks, insurance. [http://www.briefedition.alfred-escher.ch/ Alfred Escher-Briefedition]
* Digital Archive of Letters in Flanders authors and composers from the 19th & 20th century, [http://www.kantl.be/ctb/project/dalf/ DALF]
* ''Emily Dickinson's Correspondences'' (public version not yet online), to be published under the [http://rotunda.upress.virginia.edu Rotunda] imprint by University of Virginia Press. An edition of selected correspondence to and from American poet Emily Dickinson, with MS facsimiles and rich metadata capturing physical details of the manuscripts.
* Gundolf-Elli. Correspondence between Friedrich Gundolf and Elisabeth Salomon (George-Kreis). Project at the German Literature Archive. There is no website, yet. For more information use the mailing list.
* eMunch. Edvard Munch's written material: Complete letters, diaries and writings, [http://www.emunch.no/eng/index.htm] (Updated and expanded 15.06.2009)
* Schleiermacher, Friedrich - Edition of the correspondence at Berlin-Brandenburg Academy of Sciences and Humanities ([http://www.bbaw.de/ BBAW]). At the moment the new work environment (with TEI) is in development.
* Weber, C.M.v.: Complete letters, diaries, writings and compositions, [http://www.weber-gesamtausgabe.de/ Carl-Maria-von-Weber-Gesamtausgabe] (at the moment german only)
* Digital edition [http://141.20.126.175/berliner-intellektuelle/?language=de 'Letters and texts. The intellectual Berlin around 1800'.] Realized by the project 'Berlin Intellectuals 1800-1830' at Humboldt University Berlin. Publication of letters and work manuscripts of Berlin-based writers and scholars from the late 18th and early 19th century. Manuscript facsimiles, transcriptions with annotation, XML files made available. Web presence launched in April 2012 with a first set of texts. Will be progressively enriched during the upcoming years.
* [http://elec.enc.sorbonne.fr/dubourg/ Correspondance of the chancellor Antoine Du Bourg]. A project of the École nationale des chartes. Certainly one of the richest administrative and political correspondence for the France of the Renaissance, it evokes all matters a chancellor has to manage: royal finances, monitoring the printed production, economic politics, .... The whole corpus contains around 1200 letters; for the moment, one hundred has been published online, the edition is still regularly increased. The edition is part of a bigger project of digital editions of modern correspondences (15th-18th century): the aim is to build a model and interface which could be usable and shared to every non literary correspondences for early modern history.
* [http://dantiscus.al.uw.edu.pl Texts & Correspondence of Ioannes Dantiscus]. Launched in 2010 and building upon material recorded since 1989 at the University of Warsaw Ioannes Dantiscus’ correspondence forms Central-Eastern Europe’s largest collection of letters (over 6,000 letters, mostly Latin and German) related to the Polish royal court and its partners in Renaissance Europe.

=== Completed Projects ===
* [http://rotunda.upress.virginia.edu/dmde The Dolley Madison Digital Edition], part of the University of Virginia Press's [http://rotunda.upress.virginia.edu/ Rotunda] series. This is an ongoing publication, but the first two "volumes" are online. Currently the underlying data is tagged using the [http://adh.sc.edu/ Model Editions Partnership] variant of TEI (P4), but we are also exporting and transforming the documents to TEI P5 for interoperability with other material. (Contact: [mailto:dsewell@virginia.edu David Sewell])
* [http://www.vnsbrieven.org/VNS/?lang=en Van Nu en Straks: Brieven / Letters], Online edition of the correspondence concerning the literary journal 'Van Nu en Straks' (1419 letters). The annotated letters contain references to ca 2500 persons, 500 places, 1000 titles of books, 650 journal articles and 350 poems. A network of 3600 hyperlinks facilitates intuitive and associative consulting. Project at the [http://www.ctb.kantl.be Centre for Scholarly Editing and Document Studies] / Royal Academy of Dutch Language and Literature (KANTL-CTB, Ghent-Belgium) and Ghent University (Belgium). This project is part of the broader [http://www.kantl.be/ctb/project/dalf/ DALF-project].
* [http://www.vangoghletters.org/vg/ Vincent van Gogh, The letters]. A full edition of all the extant correspondence of Vincent van Gogh (900 letters). The edition includes full transcriptions (in Dutch and French), translation into English, facsimiles, extensive annotations and about 2000 illustrations.

[[Category:SIG|Correspondence]]

Kiln

2014-07-30T09:59:58Z

Magdalena Turska:

[[Category:Tools]]
[[Category:Publishing and delivery tools]]

== Synopsis ==
'''Kiln is an open source multi-platform framework for building and deploying complex websites whose source content is primarily in XML'''. It brings together various independent software components into an integrated whole that provides the infrastructure and base functionality for such sites.

Kiln is developed and maintained by a team at the Department of Digital Humanities (DDH), King’s College London. Over the past years and versions, Kiln has been used to generate more than 50 websites which have very different source materials and functionality. It has been adapted to work on a variety of flavours of TEI and other XML vocabularies, and has been used to publish data held in relational databases.

Kiln comes with XSLT code that provides support for some types of markup, but it is expected for each project to either customise it or replace it altogether and as a result of that customisation Kiln can support the publishing of complex materials with deep markup, such as medieval charters, musicological bibliographies, classical inscriptions, biographies, glossaries and so forth.

== Features ==
* powerful templating mechanism that provides full access to XSLT for creating the output
* clear separations of roles
* templates for common types of pages
* integration with Solr for indexing and searching
* default support for TEI files
* support for multilingual websites

== System requirements ==
Java 1.7 (or at least Java 1.5+ to run Kiln webapps)

== Source code and licensing ==
https://github.com/kcl-ddh/kiln/

Copyright 2012 Department of Digital Humanities, King's College London

Licensed under the Apache License, Version 2.0

http://www.apache.org/licenses/LICENSE-2.0

Components licences:

* Apache Cocoon, Apache Solr and Apache Ant are available under the Apache License.
* Sesame 2 is available under the BSD License.
* Jetty is available dual licensed under the Apache License and the Eclipse Public License.

== Support for TEI ==
Since DDH has in-house guidelines for using TEI P5 to create websites, Kiln makes use of certain TEI markup conventions. However, it has been adapted to work on a variety of flavours of TEI and other XML vocabularies.

== Components ==

*Apache Cocoon web development framework for XML processing, built with integrated eXist XML database that can be used for storage, indexing and searching using XPath expressions.
*Apache Solr searching platform for indexing, searching and browsing of contents.
*Apache Ant build system that has tasks for running the built-in web application server, running the Solr web server, creating a static version of the website, generating a Solr index of all the desired content.
*Jetty web application server for immediate running of Cocoon with automatic refreshing of changes.
*An XSLT-based templating language that supports inheritance, similar to Django’s template block system.
*Simple Presentation and Interface Library (SPIL), a set of HTML/CSS/JavaScript building blocks.

== Language ==
Interface and documentation available in English.

== Documentation ==
http://kiln.readthedocs.org/en/latest/

== Tech support ==
Kiln comes with a tutorial that covers using the main components of Kiln, and is recommended for new users.

For support try the issue tracker at https://github.com/kcl-ddh/kiln/issues.

No paid-for support scheme available.

== User community ==
There's a strong community of users at King's College London.

== Sample implementations ==
http://www.gasconrolls.org/en/

== Current version number and date of release ==
Kiln is in constant development (last modification correct at the time of adding this entry on 25/07/2014)

== History of versions ==
Kiln was previously known as xMod

== How to download or buy ==
Download from https://github.com/kcl-ddh/kiln/

== Additional notes ==

== User commentary ==
'''Please sign all comments.'''
(please leave the above note about signing comments, and add signed comments here below it)

Kiln

2014-07-30T09:58:59Z

Magdalena Turska:

Kiln

2014-07-30T09:53:25Z

Magdalena Turska: 1st version of the Kiln entry

[[Category:Tools]]
[[Category:Publishing and delivery tools]]

== Synopsis ==
'''Kiln is an open source multi-platform framework for building and deploying complex websites whose source content is primarily in XML'''. It brings together various independent software components into an integrated whole that provides the infrastructure and base functionality for such sites.

Kiln is developed and maintained by a team at the Department of Digital Humanities (DDH), King’s College London. Over the past years and versions, Kiln has been used to generate more than 50 websites which have very different source materials and functionality. It has been adapted to work on a variety of flavours of TEI and other XML vocabularies, and has been used to publish data held in relational databases.

Kiln comes with XSLT code that provides support for some types of markup, but it is expected for each project to either customise it or replace it altogether and as a result of that customisation Kiln can support the publishing of complex materials with deep markup, such as medieval charters, musicological bibliographies, classical inscriptions, biographies, glossaries and so forth.

== Features ==
* powerful templating mechanism that provides full access to XSLT for creating the output
* clear separations of roles
* templates for common types of pages
* integration with Solr for indexing and searching
* default support for TEI files
* support for multilingual websites

== System requirements ==
Java 1.7 (or at least Java 1.5+ to run Kiln webapps)

== Source code and licensing ==
https://github.com/kcl-ddh/kiln/

Copyright 2012 Department of Digital Humanities, King's College London

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Components licences:

* Apache Cocoon, Apache Solr and Apache Ant are available under the Apache License.
* Sesame 2 is available under the BSD License.
* Jetty is available dual licensed under the Apache License and the Eclipse Public License.

== Support for TEI ==
Since DDH has in-house guidelines for using TEI P5 to create websites, Kiln makes use of certain TEI markup conventions. However, it has been adapted to work on a variety of flavours of TEI and other XML vocabularies.

== Components ==

*Apache Cocoon web development framework for XML processing, built with integrated eXist XML database that can be used for storage, indexing and searching using XPath expressions.
*Apache Solr searching platform for indexing, searching and browsing of contents.
*Apache Ant build system that has tasks for running the built-in web application server, running the Solr web server, creating a static version of the website, generating a Solr index of all the desired content.
*Jetty web application server for immediate running of Cocoon with automatic refreshing of changes.
*An XSLT-based templating language that supports inheritance, similar to Django’s template block system.
*Simple Presentation and Interface Library (SPIL), a set of HTML/CSS/JavaScript building blocks.

== Language ==
Interface and documentation available in English.

== Documentation ==
http://kiln.readthedocs.org/en/latest/

== Tech support ==
Kiln comes with a tutorial that covers using the main components of Kiln, and is recommended for new users.

For support try the issue tracker at https://github.com/kcl-ddh/kiln/issues.

No paid-for support scheme available.

== User community ==
There's a strong community of users at King's College London.

== Sample implementations ==
http://www.gasconrolls.org/en/

== Current version number and date of release ==
Kiln is in constant development (last modification correct at the time of adding this entry on 25/07/2014)

== History of versions ==
Kiln was previously known as xMod

== How to download or buy ==
Download from https://github.com/kcl-ddh/kiln/

== Additional notes ==
(type in that information here)

== User commentary ==
'''Please sign all comments.'''
(please leave the above note about signing comments, and add signed comments here below it)

DH2014Hackathon-Projects

2014-06-23T09:00:28Z

Magdalena Turska: /* MS Description Display Framework */

= DH2014 Hackathon Project Discussion Page =

== Participants ==

* Robert C Kahlert, Department of Protestant Theology, University of Vienna
* Raffaele Viglianti, University of Maryland
* Patrik Granholm, Uppsala University Library: Greek Manuscripts in Sweden. A Digitization and Cataloguing Project (http://www.manuscripta.se)
* Frederike Neuber,DiXiT - Ph.D. Fellow on „Digital Palaeography and scholarly editions“ at Graz University / Austrian Centre for Digital Humanities
* Felix Lange, Academy of Sciences and Literatur | Mainz, Project IBR (http://www.spatialhumanities.de)
* Emmanuelle Morlock, CNRS, HISoMA Laboratory (Histoire et Sources des mondes antiques / History and Origins of the Antique World)
* Elli Bleeker, PhDstudent in Digital Humanities at Antwerp University; research fellow at DiXiT
* Magdalena Turska, University of Oxford
* Nick Laiacona, Performant Software Solutions LLC www.performantsoftware.com
* Elizabeth Maddock Dillon, Professor of English and CoDirector of NULab for Texts, Maps, and Networks, Northeastern University, Boston, MA USA
* Thomas Kollatz, Steinheim-Institute for German-Jewish History
* Elena Spadini, Huygens Ing

* Sebastian Rahtz, University of Oxford
* James Cummings, University of Oxford
* Alex Czmiel,
* Hugh Cayless, Duke University
* Elli Mylonas, Brown University

== Procedure ==

We will be using the wiki as a place for comments and discussion. The projects each participant proposed are all listed below. Ideally, the hackathon will be focussed around one or two projects that are useful to everyone. The participants are all experienced with TEI in various capacities, but they are not all skilled programmers. The hackathon would be a success if the outcome of the one day event was e a good start on one or two useful pieces of TEI related software. In order to achieve this, we should collectively decide on projects that are interesting, useful, generalizable, and do-able! We should also try to capitalize on everyone's skill set, and try to plan the event in such a way that we can all contribute to something.

You are all welcome to introduce yourselves, by adding a description of a few sentences to the list of participants above. And please, edit, correct and comment on the projects. We are also inviting the TEI Council and Board and other interested parties to look in on the discussions.

== Proposed Projects ==

=== Mormon City Planning: ===
when early Mormonism ventured from Kirtland, Ohio, into Missouri, their prophet Joseph Smith Jr provided a revelation for the plat (city layout) of the new Zion (http://urbanplanning.library.cornell.edu/DOCS/smith.htm; http://zomarah.files.wordpress.com/2010/10/firstplatofzion.png), which was subsequently applied in the settlement of Far West, Missouri, for which two plats exist, one on sheepskin (https://www.lds.org/bc/content/shared/content/images/gospel-library/manual/32502/15-02 b.gif) in private possession and one on paper at BYU University (there is no online copy of this, but I have obtained a digital copy from BYU with their permission); however these plats were not only used to sketch out the city, but also to assign lots to settlers, and thus show secondary markup in pencil to allocate houses, redraw lot boundaries, etc; (http://zomarah.files.wordpress.com/2010/10/platoffarwestbig.png)

'''Comments:'''
* A clarification: What would the project strive to accomplish? Is this a visualization? georeferencing based on markup?

=== ODD Customization visualizer ===
A web-based tool to visualize any ODD customization against TEI-all. This could be useful when working on a customization (with Roma, or manually) to quickly and visually check that the ODD is still TEI-conformant and see how it diverges from the standard.
I started working on a basic D3 visualization a couple of years ago, but haven't really touched the code since:https://github.com/raffazizzi/ODDViz I only restructured the repository a bit before sending this proposal.

'''Comments'''

=== ACE-based Web editor ===

MITH, at the University of Maryland has been working on an ACE-based web editor able to validate tei-all files in the browser and provide ODD-based contextual help (e.g. suggesting valid options when entering a new element).
The grant that funded this work is now over, but there's plenty more to do. This is the GitHub repository: https://github.com/umd-mith/angles

'''Comments:'''

=== MS Description Display Framework ===
To create a simple web interface which would provide basic functionalities like browsing, searching and displaying TEI-files containing manuscript descriptions. The interface could be built using a Ubuntu server with nginx (http://nginx.org), and eXist-db (http://exist-db.org) following the setup guide and scripts provided by Grant Macken (https://github.com/grantmacken/nginx-eXist-ubuntu). I have already made some preliminary work on an eXist-db web interface and posted the code in our GitHub repository (https://github.com/manuscripta). This could be used as a starting point for further development. A possible goal for the hackathon could be to create an advanced search form in XQuery which would display snippets of the descriptions in the search results using the transform function with our XSL stylesheet, with links to the full description. All of the code, with detailed documentation, would be made public on GitHub for others to reuse and modify for their own projects. I think this would be beneficial to the TEI community at large, and especially to other cataloguing projects.

'''Comments:'''

I believe this would be really useful project, especially if we build it not only having this particular purpose of MS descriptions in mind, but something more general, so other users would potentially swap only source files and stylesheets and would have a basic working website. [[User:Magdalena Turska|Magdalena Turska]] 11:00, 23 June 2014 (CEST)

=== Medieval Text Edition ===

Project isn't advanced enough to suggest concrete task, but the topic of interest is focussed around a digital scholarly edition of a medieval text (with corresponding images) encoded in XML/TEI. The edition will be enriched with palaeographical and codicological information (in both <text> and <teiHeader>) and the results can be visualized in a way which hopefully goes beyond the sometimes not very enlightening listing of data.

'''Comments:'''

=== Semantic Connections for Epigraphic Documents ===
I am currently working with epidoc documents in the context of the Project IBR. These documents, epigraphical editions from the catalogue "German Inscriptions Online" (inschriften.net), are (1) to be transformed into RDFtriples for semantic connection and for a finegrained quantificational analysis in a Triple Store, (2) XSLT transformed into HTMLDocuments for further annotation in the semantic annotator "Pundit"(thepund.it). I could surely contribute a programming task based on this points, but would also be happy to participate in another task, preferably based on "adding a TEI mode to a web editor".

'''Comments:'''

=== Zotero ===
Some TEI encoding project may need to use a "master bibliography" to group together all the bibliographic references that are used in a given text or collection of texts. Using the "masterfile" option in Oxygen give the user a convenient way of pointing to a reference without having to encode a ref each time it is used in a text or in a specific bibliographic section.
<pre>
<bibl type="fromStone">
<ptr target="#Breal1878"/>
<citedRange>15</citedRange>
</bibl>
</pre>

The bibliography can be inserted in a <back/> element with xinclude. But the question is how to use Zotero to create this file, update it and synchonize it with the biblographic masterfile.
Though incomplete, the workflow I use works like that :
* the entering of the bibliographic entries is done with zotero, in a group library
* the zotero database is then exported in xml using the "bibliontology_rdf" format (the TEI export format being to restrictive in its formatting choices : e.g. does'nt include "short titles" which are a requisite in epigraphy
* the bibliontology rdf is converted in TEI through XSLT in Oxygen (modifying existing xslt :https://github.com/paregorios/Zotero-RDF-to-TEI-XML)
* If the user wants to add a new reference in the masterbibliography or correct an entry, he or she has to do go to zotero and follow the whole workflow of export - tranform process. But the user might not have the user right to do so. And of course, there are some potential conflicting issues.

How to improve that workflow ? use a version control system like git or subversion ? or adding/modifying an entry in xml / tei and then updating the zotero group library via api ?

'''Comments:'''

=== Migrating value lists form CSS frameworks to ODD ===

The author mode of the Oxygen editor can be customized with custom css functions. A part from the function providing a more user-friendly and tag free visualization of the tei content, one of the fuction allow the user to edit attributes or simple elements values using combo boxes or check boxes. The "form controls" can display values collected from an xml schema. But these values can also be just in the oxygen css. This may be used in a workflow to test some choices before integrating them in a more consistent and persistant way in the ODD (then exported in the schema).

This could be useful in case you have user that may be ok to change the values in the css code but would be relunctant to get involved with the ODD editing / schema generation process.
cf. http://www.oxygenxml.com/doc/ug-editor/concepts/combo-box-editor.html#combo-box-editor

'''Comments:'''

--[[User:Raffaele.viglianti|Raffaele.viglianti]] 19:20, 16 June 2014 (CEST) This is interesting, would like to work on it. I would suggest to make it less tied to Oxygen and think in terms of CSS to ODD, for example to limit attribute values (e.g. hi[rend=italic])

=== Visualization of intertextual TEI content ===

A digital archive containing a variety of material not necessarily limited to text related to a work, and subsequently encoded in such a way that the inter(textual)relations could be visualized.

'''Comments:'''

* Clarification: is the project about the visualization? the relationships? More detail would be great.

=== Rendering Complex Markup ===
Rendering complex markup in an innovative and playful way: reconstructing & visualizing author’s
geographical position by the dates of sending of his letters (taking uncertainty into account)

'''Comments:'''

[[User:Magdalena Turska|Magdalena Turska]] 12:36, 12 June 2014 (CEST)

Starting with a list of letters that have a place and date of sending the idea would be to present map overview of the author's journeys.
See the simple Google Map at https://mapsengine.google.com/map/edit?mid=z3q4AefiR7Us.kf1fVBHlu8qE

Fist ideas re visualisation:
* places color-coded with color getting darker to represent 'later' places
* similarly shaded lines along the routes between places
* animation with slider to show circle moving along the routes, size of the circle getting bigger with the uncertainty

Input data:
each letter has assigned place name and 1+ time intervals (notBefore to not After)

=== Adding a TEI mode to a web editor ===
Title says it all!

'''Comments:'''

--[[User:Raffaele.viglianti|Raffaele.viglianti]] 19:20, 16 June 2014 (CEST) How does the [http://wiki.tei-c.org/index.php/DH2014Hackathon-Projects#ACE-based_Web_editor Angles] proposal above sound?

=== Juxta Script support ===
Adding support for Bengali text to Juxta Commons

'''Comments:'''
* This is fairly narrow.

=== Visualization ===
The archive of early Caribbean texts and images is a fairly large project which will be heavily encoded (and a portion of texts will be encoded by July). I'd like to explore ways of using the TEI to visualize relations between and among texts and elements of texts.

'''Comments:'''

=== Jewish Sepulchral Headstones DB ===

Given that all headstones can be clearly located,
and about 20.000 (of total 26.000) inscriptions are dated,
and to a large extend can be distinguished by gender,
and also by language usage (hebrew, german, german in Hebrew letters, …),
they lend themselves to mining the epidat corpus for specific data facets and try to visualize the results "in an innovative and playful way".
1 A challenging research questions could be the search for and visualization of the differences in word usage and specific idiomatic
– between different locations,
– within different periods (based on one or several locations),
– between inscriptions for men and inscriptions for women.
2 Even more challenging is the search for inscriptions with very similar text coverage. These are quite difficult to discover by a simple full text search. The inscriptions are usually rather short, and the filter to develop has to consider the differentiating elements – usually names and dates – in order to determine, whether two text are identical or not.

All necessary information to answer this questions is contained in the metadata <teiHeader> and data <text> of each single record.
example – spatial and temporal metadata (date, country/region code, geo-coordinates, Thesaurus of Getty Names or OSM ID)
<history>
<origin>
<date notBefore='1621-08-17'>1621-08-17</date>
<country type="ISO_3166" key="XA-DE-HH">
Germany
<region>Hamburg</region>
</country>
<settlement type='city' key='tgn:7012310'>
Hamburg-Altona, Königstraße
<geogName>
Jüdischer Friedhof
<geo decls="#WGS">53.549373 9.950545</geo>
</geogName>
</settlement>
</origin>
</history>
example – gender-specific metadata (given according to ISO 5218:2004)
<particDesc>
<listPerson>
<person xml:id="hha-3361-1" s x='1'>
<persName>Schmuel ben Jehuda</persName>
<event when='1621-08-17' type="dateofdeath">
<desc/>
</event>
</person>
</listPerson>
</particDesc>
example – language Usage metadata:
<langUsage>

<language ident='he' usage='100'>Hebrew</language>
</langUsage>

With respect for the TEI Hackathon I have (just) set up a website with very general information how to harvest epidat records:
http://www.steinheim-institut.de/cgi-bin/epidat?info=howtoharvest (to be continued …)
Over and beyond that it would make no great difficulty to provide a zip file with the data available for the workshop.

'''Comments:'''

== Discussion ==

What commonalities to you see? What seems interesting? Anything to add?

--[[User:Raffaele.viglianti|Raffaele.viglianti]] 19:07, 16 June 2014 (CEST)
=== Core Builder ===
Another possible tool to work on: https://github.com/raffazizzi/coreBuilder
It provides a simple web interface to create stand-off markup. TEI files can be open into multiple ACE editors and the user can click on elements with xml:ids to create references.
The current version creates <app> elements containing <rdg>s with pointers to the selected elements. It should be easy enough to make the elements user configurable so that the Core Builder can be used to put together <linkGrp>s or <timeline>s.
The tool is written in CoffeScript with a [http://backbonejs.org/ Backbone] framework.

DH2014Hackathon-Projects

2014-06-12T10:37:05Z

Magdalena Turska: /* Rendering Complex Markup */

= DH2014 Hackathon Project Discussion Page =

== Participants ==

* Robert C Kahlert, Department of Protestant Theology, University of Vienna
* Raffaele Viglianti, University of Maryland
* Patrik Granholm, Uppsala University Library: Greek Manuscripts in Sweden. A Digitization and Cataloguing Project (http://www.manuscripta.se)
* Frederike Neuber,DiXiT - Ph.D. Fellow on „Digital Palaeography and scholarly editions“ at Graz University / Austrian Centre for Digital Humanities
* Felix Lange, Academy of Sciences and Literatur | Mainz, Project IBR (http://www.spatialhumanities.de)
* Emmanuelle Morlock, CNRS, HISoMA Laboratory (Histoire et Sources des mondes antiques / History and Origins of the Antique World)
* Elli Bleeker, PhDstudent in Digital Humanities at Antwerp University; research fellow at DiXiT
* Magdalena Turska, University of Oxford
* Nick Laiacona, Performant Software Solutions LLC www.performantsoftware.com
* Elizabeth Maddock Dillon, Professor of English and CoDirector of NULab for Texts, Maps, and Networks, Northeastern University, Boston, MA USA

* Sebastian Rahtz, University of Oxford
* James Cummings, University of Oxford
* Alex Czmiel,
* Hugh Cayless, Duke University
* Elli Mylonas, Brown University

== Procedure ==

We will be using the wiki as a place for comments and discussion. The projects each participant proposed are all listed below. Ideally, the hackathon will be focussed around one or two projects that are useful to everyone. The participants are all experienced with TEI in various capacities, but they are not all skilled programmers. The hackathon would be a success if the outcome of the one day event was e a good start on one or two useful pieces of TEI related software. In order to achieve this, we should collectively decide on projects that are interesting, useful, generalizable, and do-able! We should also try to capitalize on everyone's skill set, and try to plan the event in such a way that we can all contribute to something.

You are all welcome to introduce yourselves, by adding a description of a few sentences to the list of participants above. And please, edit, correct and comment on the projects. We are also inviting the TEI Council and Board and other interested parties to look in on the discussions.

== Proposed Projects ==

=== Mormon City Planning: ===
when early Mormonism ventured from Kirtland, Ohio, into Missouri, their prophet Joseph Smith Jr provided a revelation for the plat (city layout) of the new Zion (http://urbanplanning.library.cornell.edu/DOCS/smith.htm; http://zomarah.files.wordpress.com/2010/10/firstplatofzion.png), which was subsequently applied in the settlement of Far West, Missouri, for which two plats exist, one on sheepskin (https://www.lds.org/bc/content/shared/content/images/gospel-library/manual/32502/15-02 b.gif) in private possession and one on paper at BYU University (there is no online copy of this, but I have obtained a digital copy from BYU with their permission); however these plats were not only used to sketch out the city, but also to assign lots to settlers, and thus show secondary markup in pencil to allocate houses, redraw lot boundaries, etc; (http://zomarah.files.wordpress.com/2010/10/platoffarwestbig.png)

'''Comments:'''
* A clarification: What would the project strive to accomplish? Is this a visualization? georeferencing based on markup?

=== ODD Customization visualizer ===
A web-based tool to visualize any ODD customization against TEI-all. This could be useful when working on a customization (with Roma, or manually) to quickly and visually check that the ODD is still TEI-conformant and see how it diverges from the standard.
I started working on a basic D3 visualization a couple of years ago, but haven't really touched the code since:https://github.com/raffazizzi/ODDViz I only restructured the repository a bit before sending this proposal.

'''Comments'''

=== ACE-based Web editor ===

MITH, at the University of Maryland has been working on an ACE-based web editor able to validate tei-all files in the browser and provide ODD-based contextual help (e.g. suggesting valid options when entering a new element).
The grant that funded this work is now over, but there's plenty more to do. This is the GitHub repository: https://github.com/umd-mith/angles

'''Comments:'''

=== MS Description Display Framework ===
To create a simple web interface which would provide basic functionalities like browsing, searching and displaying TEI-files containing manuscript descriptions. The interface could be built using a Ubuntu server with nginx (http://nginx.org), and eXist-db (http://exist-db.org) following the setup guide and scripts provided by Grant Macken (https://github.com/grantmacken/nginx-eXist-ubuntu). I have already made some preliminary work on an eXist-db web interface and posted the code in our GitHub repository (https://github.com/manuscripta). This could be used as a starting point for further development. A possible goal for the hackathon could be to create an advanced search form in XQuery which would display snippets of the descriptions in the search results using the transform function with our XSL stylesheet, with links to the full description. All of the code, with detailed documentation, would be made public on GitHub for others to reuse and modify for their own projects. I think this would be beneficial to the TEI community at large, and especially to other cataloguing projects.

'''Comments:'''

=== Medieval Text Edition ===

Project isn't advanced enough to suggest concrete task, but the topic of interest is focussed around a digital scholarly edition of a medieval text (with corresponding images) encoded in XML/TEI. The edition will be enriched with palaeographical and codicological information (in both <text> and <teiHeader>) and the results can be visualized in a way which hopefully goes beyond the sometimes not very enlightening listing of data.

'''Comments:'''

=== Semantic Connections for Epigraphic Documents ===
I am currently working with epidoc documents in the context of the Project IBR. These documents, epigraphical editions from the catalogue "German Inscriptions Online" (inschriften.net), are (1) to be transformed into RDFtriples for semantic connection and for a finegrained quantificational analysis in a Triple Store, (2) XSLT transformed into HTMLDocuments for further annotation in the semantic annotator "Pundit"(thepund.it). I could surely contribute a programming task based on this points, but would also be happy to participate in another task, preferably based on "adding a TEI mode to a web editor".

'''Comments:'''

=== Zotero ===
Some TEI encoding project may need to use a "master bibliography" to group together all the bibliographic references that are used in a given text or collection of texts. Using the "masterfile" option in Oxygen give the user a convenient way of pointing to a reference without having to encode a ref each time it is used in a text or in a specific bibliographic section.
<pre>
<bibl type="fromStone">
<ptr target="#Breal1878"/>
<citedRange>15</citedRange>
</bibl>
</pre>

The bibliography can be inserted in a <back/> element with xinclude. But the question is how to use Zotero to create this file, update it and synchonize it with the biblographic masterfile.
Though incomplete, the workflow I use works like that :
* the entering of the bibliographic entries is done with zotero, in a group library
* the zotero database is then exported in xml using the "bibliontology_rdf" format (the TEI export format being to restrictive in its formatting choices : e.g. does'nt include "short titles" which are a requisite in epigraphy
* the bibliontology rdf is converted in TEI through XSLT in Oxygen (modifying existing xslt :https://github.com/paregorios/Zotero-RDF-to-TEI-XML)
* If the user wants to add a new reference in the masterbibliography or correct an entry, he or she has to do go to zotero and follow the whole workflow of export - tranform process. But the user might not have the user right to do so. And of course, there are some potential conflicting issues.

How to improve that workflow ? use a version control system like git or subversion ? or adding/modifying an entry in xml / tei and then updating the zotero group library via api ?

'''Comments:'''

=== Migrating value lists form CSS frameworks to ODD ===

The author mode of the Oxygen editor can be customized with custom css functions. A part from the function providing a more user-friendly and tag free visualization of the tei content, one of the fuction allow the user to edit attributes or simple elements values using combo boxes or check boxes. The "form controls" can display values collected from an xml schema. But these values can also be just in the oxygen css. This may be used in a workflow to test some choices before integrating them in a more consistent and persistant way in the ODD (then exported in the schema).

This could be useful in case you have user that may be ok to change the values in the css code but would be relunctant to get involved with the ODD editing / schema generation process.
cf. http://www.oxygenxml.com/doc/ug-editor/concepts/combo-box-editor.html#combo-box-editor

'''Comments:'''

=== Visualization of intertextual TEI content ===

A digital archive containing a variety of material not necessarily limited to text related to a work, and subsequently encoded in such a way that the inter(textual)relations could be visualized.

'''Comments:'''

* Clarification: is the project about the visualization? the relationships? More detail would be great.

=== Rendering Complex Markup ===
Rendering complex markup in an innovative and playful way: reconstructing & visualizing author’s
geographical position by the dates of sending of his letters (taking uncertainty into account)

'''Comments:'''

[[User:Magdalena Turska|Magdalena Turska]] 12:36, 12 June 2014 (CEST)

Starting with a list of letters that have a place and date of sending the idea would be to present map overview of the author's journeys.
See the simple Google Map at https://mapsengine.google.com/map/edit?mid=z3q4AefiR7Us.kf1fVBHlu8qE

Fist ideas re visualisation:
* places color-coded with color getting darker to represent 'later' places
* similarly shaded lines along the routes between places
* animation with slider to show circle moving along the routes, size of the circle getting bigger with the uncertainty

Input data:
each letter has assigned place name and 1+ time intervals (notBefore to not After)

=== Adding a TEI mode to a web editor ===
Title says it all!

'''Comments:'''

=== Juxta Script support ===
Adding support for Bengali text to Juxta Commons

'''Comments:'''
* This is fairly narrow.

=== Visualization ===
The archive of early Caribbean texts and images is a fairly large project which will be heavily encoded (and a portion of texts will be encoded by July). I'd like to explore ways of using the TEI to visualize relations between and among texts and elements of texts.

'''Comments:'''

== Discussion ==

What commonalities to you see? What seems interesting? Anything to add?

DH2014Hackathon-Projects

2014-06-12T10:36:46Z

Magdalena Turska: /* Rendering Complex Markup */

= DH2014 Hackathon Project Discussion Page =

== Participants ==

* Robert C Kahlert, Department of Protestant Theology, University of Vienna
* Raffaele Viglianti, University of Maryland
* Patrik Granholm, Uppsala University Library: Greek Manuscripts in Sweden. A Digitization and Cataloguing Project (http://www.manuscripta.se)
* Frederike Neuber,DiXiT - Ph.D. Fellow on „Digital Palaeography and scholarly editions“ at Graz University / Austrian Centre for Digital Humanities
* Felix Lange, Academy of Sciences and Literatur | Mainz, Project IBR (http://www.spatialhumanities.de)
* Emmanuelle Morlock, CNRS, HISoMA Laboratory (Histoire et Sources des mondes antiques / History and Origins of the Antique World)
* Elli Bleeker, PhDstudent in Digital Humanities at Antwerp University; research fellow at DiXiT
* Magdalena Turska, University of Oxford
* Nick Laiacona, Performant Software Solutions LLC www.performantsoftware.com
* Elizabeth Maddock Dillon, Professor of English and CoDirector of NULab for Texts, Maps, and Networks, Northeastern University, Boston, MA USA

* Sebastian Rahtz, University of Oxford
* James Cummings, University of Oxford
* Alex Czmiel,
* Hugh Cayless, Duke University
* Elli Mylonas, Brown University

== Procedure ==

We will be using the wiki as a place for comments and discussion. The projects each participant proposed are all listed below. Ideally, the hackathon will be focussed around one or two projects that are useful to everyone. The participants are all experienced with TEI in various capacities, but they are not all skilled programmers. The hackathon would be a success if the outcome of the one day event was e a good start on one or two useful pieces of TEI related software. In order to achieve this, we should collectively decide on projects that are interesting, useful, generalizable, and do-able! We should also try to capitalize on everyone's skill set, and try to plan the event in such a way that we can all contribute to something.

You are all welcome to introduce yourselves, by adding a description of a few sentences to the list of participants above. And please, edit, correct and comment on the projects. We are also inviting the TEI Council and Board and other interested parties to look in on the discussions.

== Proposed Projects ==

=== Mormon City Planning: ===
when early Mormonism ventured from Kirtland, Ohio, into Missouri, their prophet Joseph Smith Jr provided a revelation for the plat (city layout) of the new Zion (http://urbanplanning.library.cornell.edu/DOCS/smith.htm; http://zomarah.files.wordpress.com/2010/10/firstplatofzion.png), which was subsequently applied in the settlement of Far West, Missouri, for which two plats exist, one on sheepskin (https://www.lds.org/bc/content/shared/content/images/gospel-library/manual/32502/15-02 b.gif) in private possession and one on paper at BYU University (there is no online copy of this, but I have obtained a digital copy from BYU with their permission); however these plats were not only used to sketch out the city, but also to assign lots to settlers, and thus show secondary markup in pencil to allocate houses, redraw lot boundaries, etc; (http://zomarah.files.wordpress.com/2010/10/platoffarwestbig.png)

'''Comments:'''
* A clarification: What would the project strive to accomplish? Is this a visualization? georeferencing based on markup?

=== ODD Customization visualizer ===
A web-based tool to visualize any ODD customization against TEI-all. This could be useful when working on a customization (with Roma, or manually) to quickly and visually check that the ODD is still TEI-conformant and see how it diverges from the standard.
I started working on a basic D3 visualization a couple of years ago, but haven't really touched the code since:https://github.com/raffazizzi/ODDViz I only restructured the repository a bit before sending this proposal.

'''Comments'''

=== ACE-based Web editor ===

MITH, at the University of Maryland has been working on an ACE-based web editor able to validate tei-all files in the browser and provide ODD-based contextual help (e.g. suggesting valid options when entering a new element).
The grant that funded this work is now over, but there's plenty more to do. This is the GitHub repository: https://github.com/umd-mith/angles

'''Comments:'''

=== MS Description Display Framework ===
To create a simple web interface which would provide basic functionalities like browsing, searching and displaying TEI-files containing manuscript descriptions. The interface could be built using a Ubuntu server with nginx (http://nginx.org), and eXist-db (http://exist-db.org) following the setup guide and scripts provided by Grant Macken (https://github.com/grantmacken/nginx-eXist-ubuntu). I have already made some preliminary work on an eXist-db web interface and posted the code in our GitHub repository (https://github.com/manuscripta). This could be used as a starting point for further development. A possible goal for the hackathon could be to create an advanced search form in XQuery which would display snippets of the descriptions in the search results using the transform function with our XSL stylesheet, with links to the full description. All of the code, with detailed documentation, would be made public on GitHub for others to reuse and modify for their own projects. I think this would be beneficial to the TEI community at large, and especially to other cataloguing projects.

'''Comments:'''

=== Medieval Text Edition ===

Project isn't advanced enough to suggest concrete task, but the topic of interest is focussed around a digital scholarly edition of a medieval text (with corresponding images) encoded in XML/TEI. The edition will be enriched with palaeographical and codicological information (in both <text> and <teiHeader>) and the results can be visualized in a way which hopefully goes beyond the sometimes not very enlightening listing of data.

'''Comments:'''

=== Semantic Connections for Epigraphic Documents ===
I am currently working with epidoc documents in the context of the Project IBR. These documents, epigraphical editions from the catalogue "German Inscriptions Online" (inschriften.net), are (1) to be transformed into RDFtriples for semantic connection and for a finegrained quantificational analysis in a Triple Store, (2) XSLT transformed into HTMLDocuments for further annotation in the semantic annotator "Pundit"(thepund.it). I could surely contribute a programming task based on this points, but would also be happy to participate in another task, preferably based on "adding a TEI mode to a web editor".

'''Comments:'''

=== Zotero ===
Some TEI encoding project may need to use a "master bibliography" to group together all the bibliographic references that are used in a given text or collection of texts. Using the "masterfile" option in Oxygen give the user a convenient way of pointing to a reference without having to encode a ref each time it is used in a text or in a specific bibliographic section.
<pre>
<bibl type="fromStone">
<ptr target="#Breal1878"/>
<citedRange>15</citedRange>
</bibl>
</pre>

The bibliography can be inserted in a <back/> element with xinclude. But the question is how to use Zotero to create this file, update it and synchonize it with the biblographic masterfile.
Though incomplete, the workflow I use works like that :
* the entering of the bibliographic entries is done with zotero, in a group library
* the zotero database is then exported in xml using the "bibliontology_rdf" format (the TEI export format being to restrictive in its formatting choices : e.g. does'nt include "short titles" which are a requisite in epigraphy
* the bibliontology rdf is converted in TEI through XSLT in Oxygen (modifying existing xslt :https://github.com/paregorios/Zotero-RDF-to-TEI-XML)
* If the user wants to add a new reference in the masterbibliography or correct an entry, he or she has to do go to zotero and follow the whole workflow of export - tranform process. But the user might not have the user right to do so. And of course, there are some potential conflicting issues.

How to improve that workflow ? use a version control system like git or subversion ? or adding/modifying an entry in xml / tei and then updating the zotero group library via api ?

'''Comments:'''

=== Migrating value lists form CSS frameworks to ODD ===

The author mode of the Oxygen editor can be customized with custom css functions. A part from the function providing a more user-friendly and tag free visualization of the tei content, one of the fuction allow the user to edit attributes or simple elements values using combo boxes or check boxes. The "form controls" can display values collected from an xml schema. But these values can also be just in the oxygen css. This may be used in a workflow to test some choices before integrating them in a more consistent and persistant way in the ODD (then exported in the schema).

This could be useful in case you have user that may be ok to change the values in the css code but would be relunctant to get involved with the ODD editing / schema generation process.
cf. http://www.oxygenxml.com/doc/ug-editor/concepts/combo-box-editor.html#combo-box-editor

'''Comments:'''

=== Visualization of intertextual TEI content ===

A digital archive containing a variety of material not necessarily limited to text related to a work, and subsequently encoded in such a way that the inter(textual)relations could be visualized.

'''Comments:'''

* Clarification: is the project about the visualization? the relationships? More detail would be great.

=== Rendering Complex Markup ===
Rendering complex markup in an innovative and playful way: reconstructing & visualizing author’s
geographical position by the dates of sending of his letters (taking uncertainty into account)

'''Comments:'''

[[User:Magdalena Turska|Magdalena Turska]] 12:36, 12 June 2014 (CEST)
Starting with a list of letters that have a place and date of sending the idea would be to present map overview of the author's journeys.
See the simple Google Map at https://mapsengine.google.com/map/edit?mid=z3q4AefiR7Us.kf1fVBHlu8qE

Fist ideas re visualisation:
* places color-coded with color getting darker to represent 'later' places
* similarly shaded lines along the routes between places
* animation with slider to show circle moving along the routes, size of the circle getting bigger with the uncertainty

Input data:
each letter has assigned place name and 1+ time intervals (notBefore to not After)

=== Adding a TEI mode to a web editor ===
Title says it all!

'''Comments:'''

=== Juxta Script support ===
Adding support for Bengali text to Juxta Commons

'''Comments:'''
* This is fairly narrow.

=== Visualization ===
The archive of early Caribbean texts and images is a fairly large project which will be heavily encoded (and a portion of texts will be encoded by July). I'd like to explore ways of using the TEI to visualize relations between and among texts and elements of texts.

'''Comments:'''

== Discussion ==

What commonalities to you see? What seems interesting? Anything to add?

DH2014Hackathon-Projects

2014-06-12T10:35:52Z

Magdalena Turska: /* Rendering Complex Markup */

= DH2014 Hackathon Project Discussion Page =

== Participants ==

* Robert C Kahlert, Department of Protestant Theology, University of Vienna
* Raffaele Viglianti, University of Maryland
* Patrik Granholm, Uppsala University Library: Greek Manuscripts in Sweden. A Digitization and Cataloguing Project (http://www.manuscripta.se)
* Frederike Neuber,DiXiT - Ph.D. Fellow on „Digital Palaeography and scholarly editions“ at Graz University / Austrian Centre for Digital Humanities
* Felix Lange, Academy of Sciences and Literatur | Mainz, Project IBR (http://www.spatialhumanities.de)
* Emmanuelle Morlock, CNRS, HISoMA Laboratory (Histoire et Sources des mondes antiques / History and Origins of the Antique World)
* Elli Bleeker, PhDstudent in Digital Humanities at Antwerp University; research fellow at DiXiT
* Magdalena Turska, University of Oxford
* Nick Laiacona, Performant Software Solutions LLC www.performantsoftware.com
* Elizabeth Maddock Dillon, Professor of English and CoDirector of NULab for Texts, Maps, and Networks, Northeastern University, Boston, MA USA

* Sebastian Rahtz, University of Oxford
* James Cummings, University of Oxford
* Alex Czmiel,
* Hugh Cayless, Duke University
* Elli Mylonas, Brown University

== Procedure ==

We will be using the wiki as a place for comments and discussion. The projects each participant proposed are all listed below. Ideally, the hackathon will be focussed around one or two projects that are useful to everyone. The participants are all experienced with TEI in various capacities, but they are not all skilled programmers. The hackathon would be a success if the outcome of the one day event was e a good start on one or two useful pieces of TEI related software. In order to achieve this, we should collectively decide on projects that are interesting, useful, generalizable, and do-able! We should also try to capitalize on everyone's skill set, and try to plan the event in such a way that we can all contribute to something.

You are all welcome to introduce yourselves, by adding a description of a few sentences to the list of participants above. And please, edit, correct and comment on the projects. We are also inviting the TEI Council and Board and other interested parties to look in on the discussions.

== Proposed Projects ==

=== Mormon City Planning: ===
when early Mormonism ventured from Kirtland, Ohio, into Missouri, their prophet Joseph Smith Jr provided a revelation for the plat (city layout) of the new Zion (http://urbanplanning.library.cornell.edu/DOCS/smith.htm; http://zomarah.files.wordpress.com/2010/10/firstplatofzion.png), which was subsequently applied in the settlement of Far West, Missouri, for which two plats exist, one on sheepskin (https://www.lds.org/bc/content/shared/content/images/gospel-library/manual/32502/15-02 b.gif) in private possession and one on paper at BYU University (there is no online copy of this, but I have obtained a digital copy from BYU with their permission); however these plats were not only used to sketch out the city, but also to assign lots to settlers, and thus show secondary markup in pencil to allocate houses, redraw lot boundaries, etc; (http://zomarah.files.wordpress.com/2010/10/platoffarwestbig.png)

'''Comments:'''
* A clarification: What would the project strive to accomplish? Is this a visualization? georeferencing based on markup?

=== ODD Customization visualizer ===
A web-based tool to visualize any ODD customization against TEI-all. This could be useful when working on a customization (with Roma, or manually) to quickly and visually check that the ODD is still TEI-conformant and see how it diverges from the standard.
I started working on a basic D3 visualization a couple of years ago, but haven't really touched the code since:https://github.com/raffazizzi/ODDViz I only restructured the repository a bit before sending this proposal.

'''Comments'''

=== ACE-based Web editor ===

MITH, at the University of Maryland has been working on an ACE-based web editor able to validate tei-all files in the browser and provide ODD-based contextual help (e.g. suggesting valid options when entering a new element).
The grant that funded this work is now over, but there's plenty more to do. This is the GitHub repository: https://github.com/umd-mith/angles

'''Comments:'''

=== MS Description Display Framework ===
To create a simple web interface which would provide basic functionalities like browsing, searching and displaying TEI-files containing manuscript descriptions. The interface could be built using a Ubuntu server with nginx (http://nginx.org), and eXist-db (http://exist-db.org) following the setup guide and scripts provided by Grant Macken (https://github.com/grantmacken/nginx-eXist-ubuntu). I have already made some preliminary work on an eXist-db web interface and posted the code in our GitHub repository (https://github.com/manuscripta). This could be used as a starting point for further development. A possible goal for the hackathon could be to create an advanced search form in XQuery which would display snippets of the descriptions in the search results using the transform function with our XSL stylesheet, with links to the full description. All of the code, with detailed documentation, would be made public on GitHub for others to reuse and modify for their own projects. I think this would be beneficial to the TEI community at large, and especially to other cataloguing projects.

'''Comments:'''

=== Medieval Text Edition ===

Project isn't advanced enough to suggest concrete task, but the topic of interest is focussed around a digital scholarly edition of a medieval text (with corresponding images) encoded in XML/TEI. The edition will be enriched with palaeographical and codicological information (in both <text> and <teiHeader>) and the results can be visualized in a way which hopefully goes beyond the sometimes not very enlightening listing of data.

'''Comments:'''

=== Semantic Connections for Epigraphic Documents ===
I am currently working with epidoc documents in the context of the Project IBR. These documents, epigraphical editions from the catalogue "German Inscriptions Online" (inschriften.net), are (1) to be transformed into RDFtriples for semantic connection and for a finegrained quantificational analysis in a Triple Store, (2) XSLT transformed into HTMLDocuments for further annotation in the semantic annotator "Pundit"(thepund.it). I could surely contribute a programming task based on this points, but would also be happy to participate in another task, preferably based on "adding a TEI mode to a web editor".

'''Comments:'''

=== Zotero ===
Some TEI encoding project may need to use a "master bibliography" to group together all the bibliographic references that are used in a given text or collection of texts. Using the "masterfile" option in Oxygen give the user a convenient way of pointing to a reference without having to encode a ref each time it is used in a text or in a specific bibliographic section.
<pre>
<bibl type="fromStone">
<ptr target="#Breal1878"/>
<citedRange>15</citedRange>
</bibl>
</pre>

The bibliography can be inserted in a <back/> element with xinclude. But the question is how to use Zotero to create this file, update it and synchonize it with the biblographic masterfile.
Though incomplete, the workflow I use works like that :
* the entering of the bibliographic entries is done with zotero, in a group library
* the zotero database is then exported in xml using the "bibliontology_rdf" format (the TEI export format being to restrictive in its formatting choices : e.g. does'nt include "short titles" which are a requisite in epigraphy
* the bibliontology rdf is converted in TEI through XSLT in Oxygen (modifying existing xslt :https://github.com/paregorios/Zotero-RDF-to-TEI-XML)
* If the user wants to add a new reference in the masterbibliography or correct an entry, he or she has to do go to zotero and follow the whole workflow of export - tranform process. But the user might not have the user right to do so. And of course, there are some potential conflicting issues.

How to improve that workflow ? use a version control system like git or subversion ? or adding/modifying an entry in xml / tei and then updating the zotero group library via api ?

'''Comments:'''

=== Migrating value lists form CSS frameworks to ODD ===

The author mode of the Oxygen editor can be customized with custom css functions. A part from the function providing a more user-friendly and tag free visualization of the tei content, one of the fuction allow the user to edit attributes or simple elements values using combo boxes or check boxes. The "form controls" can display values collected from an xml schema. But these values can also be just in the oxygen css. This may be used in a workflow to test some choices before integrating them in a more consistent and persistant way in the ODD (then exported in the schema).

This could be useful in case you have user that may be ok to change the values in the css code but would be relunctant to get involved with the ODD editing / schema generation process.
cf. http://www.oxygenxml.com/doc/ug-editor/concepts/combo-box-editor.html#combo-box-editor

'''Comments:'''

=== Visualization of intertextual TEI content ===

A digital archive containing a variety of material not necessarily limited to text related to a work, and subsequently encoded in such a way that the inter(textual)relations could be visualized.

'''Comments:'''

* Clarification: is the project about the visualization? the relationships? More detail would be great.

=== Rendering Complex Markup ===
Rendering complex markup in an innovative and playful way: reconstructing & visualizing author’s
geographical position by the dates of sending of his letters (taking uncertainty into account)

'''Comments:'''

Starting with a list of letters that have a place and date of sending the idea would be to present map overview of the author's journeys.
See the simple Google Map at https://mapsengine.google.com/map/edit?mid=z3q4AefiR7Us.kf1fVBHlu8qE

Fist ideas re visualisation:
* places color-coded with color getting darker to represent 'later' places
* similarly shaded lines along the routes between places
* animation with slider to show circle moving along the routes, size of the circle getting bigger with the uncertainty

Input data:
each letter has assigned place name and 1+ time intervals (notBefore to not After)

=== Adding a TEI mode to a web editor ===
Title says it all!

'''Comments:'''

=== Juxta Script support ===
Adding support for Bengali text to Juxta Commons

'''Comments:'''
* This is fairly narrow.

=== Visualization ===
The archive of early Caribbean texts and images is a fairly large project which will be heavily encoded (and a portion of texts will be encoded by July). I'd like to explore ways of using the TEI to visualize relations between and among texts and elements of texts.

'''Comments:'''

== Discussion ==

What commonalities to you see? What seems interesting? Anything to add?