- Tei-council - lists.tei-c.org

correspDesc desc update
by Lou Burnard 11 Feb '15

11 Feb '15

As most of you will have noticed, over the weekend Peter quite rightly added a new section to the Header chapter describing correspDesc, along with associated ODDs to implement the proposals. I feel very guilty for not having found time to feedback suggestions for the new text (which I promised to do months ago).,.. but here they are now! I haven't checked the following in yet, but am happy to do so. As the section is quite short, I am just pasting it into this message. We're all grown ups here and can cope with a few TEI tags, right? My revisions are mostly to enlarge and make a bit more explicit what the examples are doing, plus a few other things changed for conformity with house style. I have however reordered the original, putting correspContext first, since it is simpler and shorter than the rest and I didn't want to introduce new subsections. I am not certain that I've properly understood the last and first examples, so please read my rewording carefully! -------- <div type="div3" xml:id="HD44CD"> <head>Correspondence Description</head> The <gi>correspDesc</gi> element is used within the <gi>profileDesc</gi> element to provide detailed correspondence-specific metadata, concerning in particular the communicative aspects (sending, receiving, forwarding etc.) associated with acts of of correspondence. This information is intended to complement the description of the objects recording correspondence activities (such as letters), typically provided by the <gi>sourceDesc</gi> element. <specList> <specDesc key="correspDesc"/> </specList> The <gi>correspDesc</gi> element contains the elements <gi>correspAction</gi> and <gi>correspContext</gi>, describing the actions identified and the context in which the correspondence occurs respectively. <specList> <specDesc key="correspAction" atts="type"/> <specDesc key="correspContext"/> </specList> Acts of correspondence typically do not occur in isolation from each other. The <gi>correspContext</gi> element is used to group references relevant to the item of correspondence being described, typically to other items such as the item to which it is a reply, or the item which replies to it: <egXML xmlns="http://www.tei-c.org/ns/Examples"> <correspContext> <ref type="replyTo" target="#CLF0102">Previous letter of Chamisso to de La Foye: 16 January 1807</ref> <ref type="replyFrom" target="#CLF0104">Next letter of Chamisso to de La Foye: 07 May 1810</ref> </correspContext> </egXML> Many types of correspondence action may be distinguished. The <att>type</att> attribut should be used to indicate the type of action being documented, using values such as those suggested above. The following basic example uses <gi>correspAction</gi> to describe the sending of a letter by Adelbert von Chamisso from Vertus at 29 January 1807 to Louis de La Foye at Caen. The date of reception is unknown: <egXML xmlns="http://www.tei-c.org/ns/Examples"> <correspAction type="sending"> <persName>Adelbert von Chamisso</persName> <placeName>Vertus</placeName> <date when="1807-01-29">29 January 1807</date> </correspAction> <correspAction type="receiving"> <persName>Louis de La Foye</persName> <placeName>Caen</placeName> <date>unknown</date> </correspAction> </egXML> Several senders, recipients, etc. can be specified for a single <gi>correspAction</gi> if the action is considered to apply to them all acting as a single group. In the following example three people are considered to have received the communication. <egXML xmlns="http://www.tei-c.org/ns/Examples"> <correspAction type="receiving"> <persName>Hermann Hesse</persName> <persName>Ninon Hesse</persName> <placeName>Montagnola</placeName> </correspAction> </egXML>  The <att>subtype</att> attribute may be used to further distinguish types of action. In the following example, an e-mail is sent to two people directly and to a third by blind copy (<term>cc</term>). <egXML xmlns="http://www.tei-c.org/ns/Examples"> <correspAction type="sending"> <persName>PN0001</persName> <date when="1999-06-02">Wed, 02 Jun 1999</date> </correspAction> <correspAction type="receiving" subtype="to"> <persName>PN0002</persName> </correspAction> <correspAction type="receiving" subtype="to"> <persName>PN0003</persName> </correspAction> <correspAction type="receiving" subtype="cc"> <persName>PN0004</persName> </correspAction> </egXML> The same person may often be associated with many actions. For example, it will often be the case that the author and sender of a message are identical, and that many individual letters will need to be associated with the same person. The <att>sameAs</att> attribute defined in section <ptr target="#SAIE"/> may be used to indicate that the same name applies to many actions. Its value will usually be the identifier of an element defining the person or name concerned, which is supplied elsewhere in the document. <egXML xmlns="http://www.tei-c.org/ns/Examples"> <correspAction type="sending"> <name sameAs="#author"/> </correspAction> </egXML>  It is assumed that each correspondence action applies to a single act of communication. It may however be the case that the same physical object is involved in several such acts, if for example person A sends a letter to person B, who then annotates it and sends it on to person C, or if persons A and B both use the same document to convey quite different messages. In such situations, multiple <gi>correspDesc</gi> elements should be supplied, one for each communication. In the following example, the same document contains distinct messages, sent by two different people. to the same destination: <gi>correspDesc</gi> is used for each separately: <egXML xmlns="http://www.tei-c.org/ns/Examples"> <correspDesc xml:id="message1"> <correspAction type="sending"> <persName>John Gneisenau Neihardt</persName> <placeName>Branson (Montgomery)</placeName> <date>17 December 1932</date> </correspAction> <correspAction type="receiving"> <persName xml:id="JTH">Julius Temple House</persName> <placeName>New York</placeName> </correspAction> </correspDesc> <correspDesc xml:id="message2"> <correspAction type="sending"> <persName>Enid Neihardt</persName> <placeName>Branson (Montgomery)</placeName> <date>17 December 1932</date> </correspAction> <correspAction type="receiving"> <persName sameAs="#JTH"/> <placeName>New York</placeName> </correspAction> </correspDesc> </egXML>

2 3

Bug and FR assignments
by Hugh Cayless 10 Feb '15

10 Feb '15

Hi all, As promised, I’ve gone through the unassigned bugs and feature requests and assigned them, mostly arbitrarily based on who’s currently working on the fewest things. For the new folks: being assigned a Feature Request doesn’t mean just go do it :-), it means you’re responsible for making sure it gets discussed adequately and then implemented, revised, broken up into smaller implementable chunks, rejected, quietly neglected for years, etc. Do speak up if you think an assignment is grossly unfair! I haven't assigned the latest FR, https://sourceforge.net/p/tei/feature-requests/546/ <https://sourceforge.net/p/tei/feature-requests/546/> yet, because it looked like there’s much active discussion with possibly some consensus emerging. All the best, Hugh

1 0

Development version of oxygen-tei plugin available
by Martin Holmes 08 Feb '15

08 Feb '15

Hi all, I now have a development build of the oxygen-tei add-on working. You can subscribe from here: <http://teijenkins.hcmc.uvic.ca/job/oxygen-tei/lastSuccessfulBuild/artifact/…> If you're brave enough to try it, uninstall the regular version of the add-on before installing this one. I can also confirm that James was right: you can provide access to multiple versions of the plugin, allowing people to roll back to a previous version if something breaks, by providing multiple <xt:extension> elements in the updateSite.oxygen file. This seems to be working well with the URL above: if, when you're subscribing to the plugin (Help / Install New Add-Ons) you uncheck the "Show only the latest versions of the add-ons", you'll see there are three versions available. I have it set up so we'll keep the last ten versions available. I've subscribed myself, so I should be able to see if anything goes wrong. If you do test it, be aware that if you have transformation scenarios (for instance) that depend on the absolute location of the TEI extension framework, those paths will no longer work; Oxygen stores the add-on data in a path which includes a modified version of the URL of the updateSite.oxygen file. It's easy to change back to the standard TEI release, though. A new version of the plugin will be built and "released" every time the Stylesheets or P5 are rebuilt; the former triggers the latter, so the overall process takes quite a while, but the build of the oxygen-tei plugin itself takes only a few seconds. I'm copying Sebastian on this because my Jenkins is still reporting build failures and successes to him, as the Oxford one does to me, and I want to confirm that this should continue (or if it shouldn't, then what should happen instead). I'd also like to get this setup working on the Oxford Jenkins so we have some redundancy. The next step is to create some tests we can run in Oxygen to check core functionality of the add-on. I envisage this as an Oxygen project with a bunch of sample files that are transformed or otherwise manipulated and the results checked. These files would presumably live in the oxygen-tei repo. Cheers, Martin

5 27

getting mad with makefile
by Fabio Ciotti 07 Feb '15

07 Feb '15

Hi all, I'm struggling with Makefile from svn repo. Any time I try to make I have this error BUILD FAILED /media/Archivio/src/tei-code/P5/antbuilder.xml:102: Fatal error during transformation using /usr/share/xml/tei/stylesheet/odds/odd2relax.xsl: A sequence of more than one item is not allowed as the result of function tei:generateRefPrefix() ("TEI_model.contentPart", "TEI_model.contentPart", ...) ; SystemID: file:/usr/share/xml/tei/stylesheet/odds/teiodds.xsl; Line#: 2339; Column#: -1 The first time I've run it this morning (after implementing a ticket) it has worked. Then before to check I thought to implement a couple of other tickets, make again to see if something had broken and the error jumped out, but it has apparently nothing to do with my modifications. I have already tried to: make clean 1000 times delete and download again my stylesheets deb try to use online stylesheets as referenced in the makefile (nope the URL is broken) re-checkout the trunk and try the build with an untouched svn local copy curse all the possible deities hit the pc with a baseball bat any hint??? f

3 4

Conferencing system
by Fabio Ciotti 06 Feb '15

06 Feb '15

Hi all, this link could be of some interest. http://crln.acrl.org/content/76/2/98.full Our voice conf system works only by wired phone, and nowadays it is very hard to find one if you are out of office. It is quite annoying to beg for a wired phone when you for ex. are at a conference, where usually you have a fast access to the net (like me last week!). Fabio

5 11

Teleconference dates
by Hugh Cayless 04 Feb '15

04 Feb '15

We settled on the last Friday of the month, at 13:30 GMT, but note the weirdness over time changes in March—I can’t do 09:30 EDT, as it will be then. These are the teleconference dates and times, though August: February 27, 05:30 PST | 08:30 EST | 13:30 GMT | 14:30 CET March 27 05:30 PDT | 08:30 EDT | 12:30 GMT | 13:30 CET April 24 05:30 PDT | 08:30 EDT | 13:30 BST | 14:30 CEST May 29 05:30 PDT | 08:30 EDT | 13:30 BST | 14:30 CEST June 26 05:30 PDT | 08:30 EDT | 13:30 BST | 14:30 CEST July 31 05:30 PDT | 08:30 EDT | 13:30 BST | 14:30 CEST August 28 05:30 PDT | 08:30 EDT | 13:30 BST | 14:30 CEST We’ll cancel one of April, May, or June because the F2F should fall in one of those months. If you haven’t done so yet, please put in your availability for the poll I posted yesterday. If the time shift in March will cause problems, please object now so we can reschedule. I do wish they’d get rid of Daylight Savings Time entirely, but even if they won’t, I wish we could have it at least be coordinated…sigh. Thanks, Hugh

2 1

Re: [tei-council] Development version of oxygen-tei plugin available
by Martin Holmes 03 Feb '15

03 Feb '15

Hi there, On 15-02-03 09:44 AM, Sebastian Rahtz wrote: > happy to set up the job on oxjenkins, shall I do that now or wait a > bit? Go for it. I just tested some of my normal stuff using the new plugin, and it seems to work a treat so far. You'll find the config.xml file for Jenkins in the usual place. The job has to be called "oxygen-tei" (there are some paths in the build-for-jenkins.sh script that depend on that). If you read that script, you'll see it's heavily based on your update-and-upload.sh script, but there are some nifty shenanigans around making the updateSite.oxygen script permanently available at the same URL, while behind the scenes it's shifting its location and has to be regenerated every time based on the previous version. But as far as I know, if you just install the config.xml in a job called oxygen-tei, it'll work. I'm keeping ten versions of the plugin, because we need to let people roll back when things go wrong, and because it gets built often (due to changes in itself, the Stylesheets, or P5). I know your Jinks occasionally has space issues, so that might be something to watch out for, but it's not huge. > the work monitoring oxjenkins is fairly small, so leave that with me > for now. OK. >> The next step is to create some tests we can run in Oxygen to check >> core functionality of the add-on. I envisage this as an Oxygen >> project with a bunch of sample files that are transformed or >> otherwise manipulated and the results checked. > > do you know how to drive oxygen from the command line, then? cool. No, I was planning to write some ant tasks that would be run by a user in the Oxygen interface. Along the lines of: - Create sample file based on template X. - Transform using Stylesheets transformation Y. - Validate result with schema Z. That sort of thing. Not very sophisticated, but the idea would be that when we're about to release a new version of the plugin, someone subscribed to the latest Jinks build would run the tests and confirm nothing is wildly broken, then we'd go ahead and build/upload to the release location. It would be nicer to have automated testing happening as part of the build, of course. If I can learn how to do that, I'll have a go at it. But I don't know where to start right now. Cheers, Martin > > -- Sebastian Rahtz Chief Data Architect University of Oxford IT > Services 13 Banbury Road, Oxford OX2 6NN. Phone +44 1865 283431 > > >

1 0

Spring F2F Poll
by Hugh Cayless 02 Feb '15

02 Feb '15

Hi all, I've set up a poll at http://doodle.com/2qzywq8c379atu87 in the window April 13–May 15. Let's see what we can do, and I'll adjust as needed.

7 11

re corresp oddity
by Lou Burnard 01 Feb '15

01 Feb '15

I note the following things in the definition for <correspAction> in the corresp ODD 1) you should not use @mode="add" together with @module on an <elementSpec> -- it's meaningless, since you are not allowed to add new things to existing TEI modules 2) if you want your valList to appear in the schema you must put @type="closed" on it. otherwise your suggested values appear in the schema only as comments 3) since you are replacing the existing (vacuous) declaration for the possible values of @type, you must put @mode="replace" on your valList With these changes, things work as expected for elements in the TEI namespace. I am still puzzling over why they don't for non-TEI namespaced elements, but have to go out now.

3 2

Report on the continuing work of TEI Simple
by James Cummings 30 Jan '15

30 Jan '15

The TEI Simple project has been working and developed things especially over a week in January where Brian Pytlik Zillig came to Oxford to work with Sebastian and Magdalena (and intermittently me). This includes the first draft of TEI Processing Model documentation, with a configuration for TEI Simple and an implementation. See especially http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/maste… for the description of the draft processing model and the <model>, <modelGrp>, and <modelSequence> elements. http://dixit.hypotheses.org/550 is a blog post of Magdalena's explaining some of the work. Upcoming: a) We have a working and advisory group meeting in late March in Berlin to confirm the the processing model proposal b) We’d like the Council to review the PM ODD extensions at its next f2f meeting; though an idea now of whether they are broadly acceptable would be very useful, but we’re not yet asking the Technical Council to consider whether and how they can be implemented (that’s in hand), just whether: 1) the notation conforms to TEI patterns, 2) the re-use of <rendition> is acceptable, and 3) whether the notation is powerful enough _in the circumstances of the Rahtz Rationale_ (this is important). c) We are negotiating now to get a 2nd implementation made of the PM spec (which still has some editing work pending), possibly by the eXist folks (Wolfgang and Adam), to confirm that there no technical barriers. d) We would like to have a hackathon or workshop getting people to test TEI Simple and its PM maybe in the late spring -James == From Sebastian == The following links should help you read about what we have done and are proposing: Documented ODD for Simple:http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blo… for differences andhttp://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/ma… for full version Documented extensions for processing:http://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple… for differences andhttp://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/ma… for full version TEI Simple schema (RELAX NG):https://raw.githubusercontent.com/TEIC/TEI-Simple/master/teisimple.rng Magdalena Turska has done the first implementation for the processing, and has put up some before and after test files for a test file: https://github.com/TEIC/TEI-Simple/blob/master/tests/testsimple.xml (before) andhttp://htmlpreview.github.io/?https://github.com/TEIC/TEI-Simple/blob/ma… (after) Magdalena has also written a nice blog post about work on Simple at http://dixit.hypotheses.org/550 which I commend to everyone. Remember: everything you see today remains a proposal for discussion, and is not fixed in stone. == From Magdalena == The premise of processing model implementation is to generate XSLT stylesheet based solely on TEI Simple ODD file that contains models and renditions that define intended processing for TEI Simple elements. Base TEI Simple ODD can be found athttps://github.com/TEIC/TEI-Simple/blob/master/teisimple.odd Processing model implementation files can be found in polygon subdirectoryhttps://github.com/TEIC/TEI-Simple/tree/master/polygon and this is assumed to be working directory in all examples below. To generate the XSLT stylesheet one can run following command: saxon -xi -s:../teisimple.odd -o:simple.xsl -xsl:simpleoddtoxsl.xsl That will generate simple.xsl file which can be used in turn to transform the TEI Simple documents, eg: saxon -s:../tests/5730.xml -o:../tests/treasureisland.html -xsl:simple.xsl will produce html output for Treasure Island sample file. To change the behaviour of this final transformation one needs to tweak appropriate sections of teisimple.odd and re-run both commands above to 1. regenerate simple.xsl stylesheet and 2. apply it to source document again. There are additional tests at https://github.com/TEIC/TEI-Simple/tree/master/tests == -- Dr James Cummings, James.Cummings(a)it.ox.ac.uk Academic IT Services, University of Oxford

1 0