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

Testing Pure ODD
by James Cummings 09 Feb '16

09 Feb '16

Hi Lou and Council, I've been looking around for a TEI ODD file where I redefined content models. Mostly I just add/delete elements/attributes/classes which isn't really changing. Finally remembered I had changed some content models in my tei_corset ODD. This was a mass-digitisation ODD for the Stationers' Register project where the keying company was willing to use any XML schema but would charge per kilobyte of output. So I renamed everything to be shorter names, etc. in a tei_corset namespace which over a lot of text input saved us money and was easy to convert back. Where I used any relax ng in this it was fairly minimal and the conversion able to be done automatically with no problems: a) to rename <TEI> to be <file> and say that its content model was just <teiHeader> and <body> (both renamed elsewhere) Old ODD: https://github.com/jamescummings/conluvies/blob/master/tei_corset/tei_corse… Pure ODD: https://github.com/jamescummings/conluvies/blob/master/tei_corset/tei_corse… This just changes to two <elementRef>s. b) to rename <teiHeader> to be <header> and give it a content model of <title> followed by zero or more model.pLike Old ODD: https://github.com/jamescummings/conluvies/blob/master/tei_corset/tei_corse… Pure ODD: https://github.com/jamescummings/conluvies/blob/master/tei_corset/tei_corse… This just changes to an <elementRef> followed by a <classRef> c) for various reasons some empty elements were changed to allow text content. For example <gap> was renamed <gp> and had a content of <rng:text> Old ODD: https://github.com/jamescummings/conluvies/blob/master/tei_corset/tei_corse… Pure ODD:https://github.com/jamescummings/conluvies/blob/master/tei_corset/tei_c… <rng:text> just becomes <textNode/> d) exactly the same thing for <space> renamed <spc>: Old ODD: https://github.com/jamescummings/conluvies/blob/master/tei_corset/tei_corse… Pure ODD: https://github.com/jamescummings/conluvies/blob/master/tei_corset/tei_corse… The resulting schema validates against the files I had. I did have to change some other things in the ODD, but these had to do with the moving of rendition things into att.global.rendition from att.global. (Since this ODD was 3 or 4 years old.) I converted the Pure ODD to HTML and everything worked as expected. Clearly not an exhaustive test of all of the functionality of Pure ODD, but just another confirmation that migrating to Pure ODD is able to be semi-automated and for most people's low hanging fruit doesn't introduce any major problems. -James -- Dr James Cummings, James.Cummings(a)it.ox.ac.uk Academic IT Services, University of Oxford

2 1

Roma eXist-db down?
by Peter Stadler 08 Feb '16

08 Feb '16

Dear all, at present, I can’t access Roma (I may enter the first pages but Roma is unable to fetch module information etc.) and it seems the eXist-db is down. Looking in the logs at /var/www/vhosts/tei-c.org/opencms_tomcat/lv1/local/tomcat_6.0.14_teicms/webapps/exist/WEB-INF/logs/exist.log states: 2016-02-08 07:01:18,941 [main] INFO (BrokerPool.java [shutdown]:1495) - shutdown complete ! 2016-02-08 07:23:49,589 [http-8040-9] INFO (XQueryServlet.java [init]:135) - form-encoding = UTF-8 2016-02-08 07:23:49,590 [http-8040-9] INFO (XQueryServlet.java [init]:139) - container-encoding = UTF-8 2016-02-08 07:23:49,590 [http-8040-9] INFO (XQueryServlet.java [init]:143) - encoding = UTF-8 2016-02-08 07:23:49,631 [http-8040-9] WARN (Descriptor.java [<init>]:96) - Giving up unable to read descriptor file from /descriptor.xml 2016-02-08 07:23:49,631 [http-8040-9] WARN (Descriptor.java [<init>]:115) - Giving up unable to read descriptor.xml file from classloader in package org.exist.http So, it looks as if the db was shutdown and failed to restart. Does anyone know any details and how to proceed? (I’m unfamiliar with eXist within Tomcat …) Best Peter

4 5

proc mod queries
by Lou Burnard 06 Feb '16

06 Feb '16

I've made a bit more progress on the "processing model" extensions to ODD proposed by the TEI Simpletons a while ago, and now have a version of P5 based on the current dev branch which includes them AND builds correctly. But I havent yet finished hacking the prose into shape, and I have some questions. Here's the first. The @output attribute "the intended output method" (that's clearly wrong though; surely it should be "the intended output target"?) is defined with a closed list of values "web", "print", and "plaintext". a) why is this a closed list? I can think of lots of other possible values e.g. "mobile device", "PDF", "text-to-speech synthesizer" for starters... b) what exactly does "plaintext" mean? And here's the zero'th. To whom if not the Council should I be addressing this query?

3 8

processing model use of CSS
by Lou Burnard 05 Feb '16

05 Feb '16

Decision please. The current description of the processing model tacitly assumes that CSS is used to express output rendition, and it's hard to see how else the job would be done, but the text of the Guidelines is rather vague on the topic. Should we say a) outputRendition *must* be expressed using CSS b) it is *recommended* that CSS be used c) we don't care what you use, but our examples assume you will use CSS If we choose b or c, we will presumably need to add some complexity to the scheme (e.g. to say what has been used instead if it's not CSS)

5 17

weird example
by Lou Burnard 05 Feb '16

05 Feb '16

The spec for <model> currently has a whole slew of examples, some of which need to go elsewhere I think. And one or two of them are entirely mysterious. This one for example: <exemplum xml:lang="en"> <egXML xmlns="http://www.tei-c.org/ns/Examples"> <model predicate="parent::choice and count(parent::*/*) gt 1" behaviour="omit"/> </egXML> </exemplum> Can someone please explain to me what this is meant to achieve? It seems to be saying "if my parent is <choice> and any of my parents has more than one child node, then suppress me". In the immortal words of Manuel, che?

3 4

outputRendition spec
by Lou Burnard 05 Feb '16

05 Feb '16

The <remarks> for this element currently read: "The <gi>outputRendition</gi> element differs from the <gi>rendition</gi> element describes rendering information in one or more possible outputs, usually recorded in the TEI customization file, the latter must only be used to document the original rendition of the source text." - As far as I know <outputRendition> can only appear inside an ODD file, so why "usually" ? - If @useSourceRendition is true, then the <rendition> element *will* affect the output. I'm proposing the following revision: This component of an element specification describes the rendering or appearance intended for all occurrences of the element in a specified context for a specified type of output. The <rendition> element, by contrast, describes the actual rendering or appearance of all occurrences of the specified element in a source document. The <att>useSourceRendition</att> attribute may however be used to indicate that formatting information provided by a <gi>rendition</gi> element is to be combined with any provided by an <gi>outputRendition</gi> element. It is strongly recommended that the W3C Cascading Stylesheet language (CSS2 or later) be used to express the required formatting information. (The second paragraph modulo whatever we decide to do about the CSS or what debate)

3 2

Proofreading processing model rewrite
by James Cummings 28 Jan '16

28 Jan '16

I'd like to thank Lou again for the rewrite of the draft section for TD that I'd done in the processing-model branch -- it is a substantial rewrite. This is at http://teic.github.io/TEI/TD.html#TDPM or if you prefer the xml https://github.com/TEIC/TEI/blob/lb42-procmod/P5/Source/Guidelines/en/TD-Do… I've given the chapter a quick skim read and my initial suggestions/thoughts are: "22.4.4.4 Processing Models" Should processing models section be a new 22.4.5? It is longer an more substantial than some of its siblings at this level. " In the present implementation, rendition is expressed using the W3C Cascading Stylesheet Language (CSS)" In which implementation? This may be confusing, perhaps just the second half of that sentence? "The intent is that these should be presented in an italic font as inline elements:" maybe: "The intent is that these elements should be presented inline in an italic font" (i.e. They may not be being processed into 'elements', that may be mistaken as suggesting this is only for HTML output or something.) You are right that at the bottom of the Output Rendition section we could say something about 'Why CSS', but this is for the same reason that we suggest elsewhere inside the <rendition> element as a formally declared stylesheet language. This might suggest that we should be having a @scheme attribute like <rendition> with css as a value? In Implementation: "If the useSourceRendition attribute on the model has the value false then any rendition attribute on the source element can be ignored; otherwise its value must be combined with that given in the outputRendition element, if any." Maybe reverse this since it might contradict what was said above in the bit on useSourceRendition? So: "If the @useSourceRendition attribute on the model has the value true then any rendition attribute in the source element must be combined with any given in the outputRendition element, otherwise all rendition attributes in the source should be ignored." -James -- Dr James Cummings, James.Cummings(a)it.ox.ac.uk Academic IT Services, University of Oxford "

4 10

screwy example (was "Re: [TEI] <lg> and <gap> (#1419)")
by Syd Bauman 25 Jan '16

25 Jan '16

Re: the 4th example in section 3.12.1, "Core Tags for Verse"[1] See file TEI/P5/Source/Guidelines/en/CO-CoreElements.xml and search for "#CO-eg-07". The example doesn't seem to exemplify what the prose is talking about at all. Looks to me like the <stage> is supposed to be a sibling of the <l>s, in between the last two. (Otherwise, the @part attributes are not needed, the last two <l> elements could just be one <l> with a <stage> inside. Which, BTW, is a less-than-optimal encoding in this case, because the stage direction doesn't scan. :-) This seems to me to be a corrigible error, which I have just fixed on my home desktop, but don't plan to push for awhile in case someone wants to object. Notes ----- [1] http://www.tei-c.org/release/doc/tei-p5-doc/en/html/CO.html#COVE

1 0

Links for this morning's call
by Hugh Cayless 25 Jan '16

25 Jan '16

Agenda: https://docs.google.com/document/d/1sJgb6aQVJUTs0ENyRSIMfZODtrhXeOSyKoPYrM0… Hangout: https://hangouts.google.com/call/hpffrckgslsfz425fyzfby256ia Phone numbers are in the Agenda if you can’t connect to the Hangout.

1 0

Pure ODD
by Hugh Cayless 25 Jan '16

25 Jan '16

Dear All, Now that Lou’s tremendous work on Pure ODD has been merged into dev, we should try to give it a thorough workout. I’ve regenerated the "bleeding edge" Guidelines at http://teic.github.io/TEI/index.html <http://teic.github.io/TEI/index.html>. It would be extremely helpful if you can take the time to look it over for problems and report them as issues. I’ve experimented in that build with rearranging the order in which things are displayed. See, e.g. http://teic.github.io/TEI/ref-witDetail.html <http://teic.github.io/TEI/ref-witDetail.html>. Your reactions (whether positive or not) will be most welcome!

3 3