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

Agenda for Friday's Telecon
by Hugh Cayless 27 Feb '15

27 Feb '15

Hi all, I’ve put up an agenda for our teleconference on Friday, Jan 30 at 14:00 GMT: http://wiki.tei-c.org/index.php/Council_agenda_2015-01 <http://wiki.tei-c.org/index.php/Council_agenda_2015-01> It’s mostly a copy of the previous one, on the assumption that we probably didn’t make much progress over the holidays and the review will likely be good for all of us, especially our new members. Please do add new items for discussion (or remove items there’s nothing to report on). It will take me a while to figure out how things work, so reminders of anything I may have missed, or suggestions for how things might be done better are most welcome! All the best, Hugh

8 17

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

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

Stylesheets in GLs repo?
by Hugh Cayless 30 Jan '15

30 Jan '15

It looks like a copy of the Stylesheets got checked in to the Guidelines repo last month. I presume this was an accident and it's ok to get rid of it? Hugh

8 21

correspDesc
by Peter Stadler 30 Jan '15

30 Jan '15

Dear all, I updated the formal specification and added some chapter prose (for the header chapter — thanks to Sabine and Marcel!) at our SIG’s GitHub repository. So, at [1] you will find the specs (the prose there section is more or less outdated, so please skip) and at [2] a draft for some chapter prose to go into the header section at 2.4.6 My implementation plan is straightforward: * add the prose <div> from [2] to HD-Header.xml * create files under P5/Source/Specs for the new elements and classes (while removing our namespace from elementSpecs and egXML) * modify existing elements (add membership to the new classes) So, please have a look at the files and point me at those things I don’t see … I have one issue though: In the elementSpec for correspAction I try to set some suggested values for @type (see l. 716 in [1]). I tried to follow the model at P5/Source/Specs/list.xml but my values never made it to the RelaxNG schema. Is there some issue with the stylesheets or am I missing something? Best Peter [1] https://github.com/TEI-Correspondence-SIG/correspDesc/blob/master/odd/propo… [2] https://github.com/TEI-Correspondence-SIG/correspDesc/blob/master/odd/HD-He…

3 4

oxygen-tei now successfully building on Jenkins
by Martin Holmes 30 Jan '15

30 Jan '15

Hi all, I now have a fresh build script for the TEI Oxygen plugin which builds the plugin package using the latest successful builds of P5 and the Stylesheets. It will build automatically after every successful TEI P5 build (which itself is triggered by any change to P5 source or following a Stylesheets build), and will also build if its own Google Code repository changes. What this means is that we should now have a trunk build of the Oxygen TEI plugin which tracks the other changes in our codebase. Most importantly, we'll know immediately if something the Oxygen guys do in the Google code repo breaks the build, or if we do something to our own codebase which breaks it. The next stage is to set up an update file for these trunk builds, like this one: http://www.tei-c.org/release/oxygen/updateSite.oxygen to which the braver among us could subscribe, so that the plugin would always get tested steadily as we work. I think the build process should create this file, so it will probably end up being on the Jenkins server itself somewhere. If anyone is interested in testing now, the latest build is here: <http://teijenkins.hcmc.uvic.ca/job/oxygen-tei/lastSuccessfulBuild/artifact/…> Our current release of this plugin is called "teioxygen..." rather than "oxygen-tei", but since the Google Code project is oxygen-tei, and there is also a TEI deb package called "tei-oxygen" which has nothing to do with this, I've taken the opportunity to name my distro like this: oxygen-tei-2.7.1a-7.30.0.zip If you think it's a good idea to carry this naming over to the release package, shout; we could modify the build-and-upload script accordingly, along with the update file, and reduce potential confusion. Cheers, Martin

1 0

Please take a look at this bug
by Martin Holmes 30 Jan '15

30 Jan '15

Hi all, Could I ask Council to take a look at this bug? <http://sourceforge.net/p/tei/bugs/704/> I believe the explanation in the final comment is correct, that it's a corrigible error, and that it's fairly egregious (we give an example in the Guidelines of something that isn't actually permitted in standard TEI schemas; we get round this ourselves in the actual Guidelines source by customizing our ODD schemas). I'd like the OK to fix this; I think it should be release-blocking, and it's holding up the work Ron is doing to integrate the JTEI schema into our system. If there are no objections in the next week, I'll assume assent and implement the fix suggested on the ticket. Cheers, Martin

5 7

Tickets for the new Council members?
by Martin Holmes 29 Jan '15

29 Jan '15

Hi all, Jens Østergaard Petersen just read the CH-LanguagesCharacterSets.xml prefatory chapter: <http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CH.html> and as he often does, took the trouble to report a bunch of minor issues and typos. I was going to trawl through these tonight, but it crossed my mind that they might be useful for the new Council members to do their first Guidelines edits with. Raffaele and Stefan, what do you think? These are the bugs that are straightforward fixes: <http://sourceforge.net/p/tei/bugs/707/> <http://sourceforge.net/p/tei/bugs/708/> <http://sourceforge.net/p/tei/bugs/709/> <http://sourceforge.net/p/tei/bugs/711/> <http://sourceforge.net/p/tei/bugs/712/> <http://sourceforge.net/p/tei/bugs/714/> <http://sourceforge.net/p/tei/bugs/716/> <http://sourceforge.net/p/tei/bugs/717/> There are a few others, but they need at least a look; the final one calls for a complete section to be deleted or revised, and I tend to agree with him, but it'll need some discussion. Raffaele and Stefan, if you think it would be useful to try editing the Guidelines with some straightforward bugs like this, I'd suggest Raffaele take the even-numbered ones and Stefan the odd-numbered ones, so you don't step on each other's feet, and have a go. Below is a copy of the instructions I sent around in December. If you don't think it's of value to do this, just post to the list and I'll make these fixes. --------------------------------------------------------------- 2. EDITING THE GUIDELINES: --------------------------------------------------------------- Most of the actions taken by Council members involve editing the TEI Guidelines source code. The process basically works like this: 1. Check out the source from Subversion on SourceForge. 2. Make changes. 3. Commit them back to the repository. 4. Wait to see whether our Continuous Integration servers successfully rebuild the schemas and documentation. These are the key URLs for learning how to edit the Guidelines: The Sourceforge SVN repository: <http://sourceforge.net/p/tei/code/HEAD/tree/> (If you log into the SF website, you will see the option RW for a read-write checkout; use this option so that you can easily commit changes back to the repository. All Council members are members of the Developer group, with write permissions.) Bug reports and feature requests (tickets) on SourceForge: <http://sourceforge.net/p/tei/_list/tickets> How to Edit the TEI Guidelines: <http://www.tei-c.org/Activities/Council/Working/tcw20.xml> (This is a vital read before attempting to make any changes to the Guidelines source code.) Style Guide for Editing the TEI Guidelines: <http://www.tei-c.org/Activities/Council/Working/tcw24.xml> (Another important document to read before making any edits.) Currently Unresolved Tickets: <http://www.tei-c.org/Activities/Council/Working/tcw17.html> (This is a good way to see what we're currently working on. New members might find a ticket here that they feel confident about implementing, and could volunteer to take it and work on it with the help of their mentor.) --------------------------------------------------------------- Cheers, Martin

7 11