February 2016 - Tei-council

Pre-release
by Hugh Cayless 19 Feb '16

19 Feb '16

Hi All, In advance of next Thursday’s meeting, I’ve been doing some work on tickets, mainly moving fixed, closed tickets into the 3.0.0 milestone (https://github.com/TEIC/TEI/milestones/Guidelines-3.0.0 <https://github.com/TEIC/TEI/milestones/Guidelines-3.0.0>). This looks like a really good way to easily point to what’s been done for a given release! I’ve created a 3.1.0 milestone we can use to capture work that happens towards the following release. I think in the future that as soon as we mark a ticket "Go", we should also give it a milestone. We have 38 tickets in a Green state (https://github.com/TEIC/TEI/issues?q=is%3Aopen+is%3Aissue+label%3A%22Status… <https://github.com/TEIC/TEI/issues?q=is:open+is:issue+label:%22Status:+Go%22>), meaning there should be no obstacles to their implementation. Can I ask you all to have a look through these and ask a) is this really Green? Does it need more discussion or is it blocked? b) if it’s assigned to you, can you do it, or do you need to hand it off? c) If you’re not assigned a ticket, but think you could do it and are sufficiently bored, can you take it over? It would be nice if we could get at least some of these into 3.0.0. Some of them have been around an awful long time. On Thursday, we need to decide if we’re ready to "freeze" for the release, when that release will be, and who will be the release technician. This will be only our second release from GitHub, and the first under our new repo organization scheme, so we’re essentially doing this for the first time. Git Flow, which we’re emulating, recommends something like the following as a release procedure: 1) Create a release branch - Changes made during the run-up to release should be made here, then merged back into dev - Given this separation, there should be no need for an actual freeze on dev, but no big changes should be merged into release. 2) Merge the release branch into master 3) Push master to GitHub. Ideally, this would trigger a test process, à la https://github.com/TEIC/TEI/issues/1411 <https://github.com/TEIC/TEI/issues/1411>, which is not in place yet 4) Assuming tests pass, tag the release 5) Post release, the release branch can be merged into dev and removed. From there on, more or less as in http://www.tei-c.org/Activities/Council/Working/tcw22.xml <http://www.tei-c.org/Activities/Council/Working/tcw22.xml>, which needs some work (which itself is a problem due to the brokenness of the TEI website CMS). Thoughts?

1 0

Build failed in Jenkins: TEIP5-Test #2762
by Victoria TEI Jenkins 19 Feb '16

19 Feb '16

See <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/2762/changes> Changes: [stefanie.gehrke] rephrasing and addition of a `<gi>` element close #1310 [stefanie.gehrke] addition of msFrag in manuscriptDescription, msDesc, msFrag, msPart [stefanie.gehrke] added msFrag in //specList/specDesc etc. and replaced Amiens BM exemple [stefanie.gehrke] <origin> deleted inside msFrag [martindholmes] Minor edits to the new prose added by Stefanie on issue [stefanie.gehrke] added Peters example from the Weber-Gesamtausgabe to msFrag.xml [stefanie.gehrke] some changes in the prose (english and frensh) [philomousos] Content model fixes. ------------------------------------------ Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Started by an SCM change Building in workspace <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/> > git rev-parse --is-inside-work-tree # timeout=10 Fetching changes from the remote Git repository > git config remote.origin.url https://github.com/TEIC/TEI.git # timeout=10 Fetching upstream changes from https://github.com/TEIC/TEI.git > git --version # timeout=10 > git -c core.askpass=true fetch --tags --progress https://github.com/TEIC/TEI.git +refs/heads/*:refs/remotes/origin/* > git rev-parse refs/remotes/origin/dev^{commit} # timeout=10 > git rev-parse refs/remotes/origin/origin/dev^{commit} # timeout=10 Checking out Revision bf360896d19bea68c2a79551f57873d62efc35be (refs/remotes/origin/dev) > git config core.sparsecheckout # timeout=10 > git checkout -f bf360896d19bea68c2a79551f57873d62efc35be > git rev-list 267926631ad4e5cdfc7c8da56cbb04e8f58ab2fd # timeout=10 [workspace] $ /bin/bash -xe /tmp/hudson3656605424350548654.sh + cd P5 ++ pwd + make VCS=git INJENKINS=true XSL=<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/../../../Stylesheets/la…> clean validate test (cd Exemplars; make clean) make[1]: Entering directory `<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/Exemplars'> mv tei_lite_fr.nvdl tei_lite_fr.nvdl.bak rm -f *.xsd *.dtd *.doc.* *.rnc tei*.xsl tei*.rng *.compiled* *~ *.xi *.isosch *.epub *.pdf *.html *.nvdl *-teix* mv tei_lite_fr.nvdl.bak tei_lite_fr.nvdl rm -f exnames.xml rm -f enrich.rng isofs.rng rm -f names.xml *properties rm -f [A-Z]*xml make[1]: Leaving directory `<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/Exemplars'> (cd Test; make clean) make[1]: Entering directory `<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/Test'> rm -f test*.doc.xml test*.rnc test*.dtd test*.compiled.* test*.xsd test*.rnc test*.rng test*.xsl test*.isosch rm -rf LOG *~ *.xsd Schema RomaResults DTD rm -rf *.doc.* rm -f detest.log detest.log.all rm -f *-examples.rng *-examples.rnc *test*.nvdl *-ex.odd rm -f detest.rnc detest.rng detest.dtd detest.isosch make[1]: Leaving directory `<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/Test'> rm -rf release Guidelines Guidelines-web Schema DTD dtd Split rm -rf Guidelines.??? Guidelines-* rm -f *.isosch.xsl rm -f *.stamp rm -f *.xsd rm -f Exemplars/stdout rm -f Test/*.isosch rm -f Test/detest.dtd Test/detest.rnc Test/detest.rng Test/detest.xsl rm -f Test/stdout rm -f Utilities/guidelines.xsl rm -f anything buildweb.xml rm -f p5.sch p5.isosch p5.xml p5subset.xml p5subset.json p5subset.js rm -f p5attlist.txt rm -f p5odds-examples.rng p5odds-examples.rnc p5odds.rng p5odds.rnc p5odds.isosch rm -f pdfbuild.log rm -f stripspace.xsl.model rm -f tei-*.zip rm -f tei-p5-*_*build rm -f tei-p5-*_*changes rm -f tei-p5-*_*deb rm -f teiwebsiteguidelines.zip rm -rf FASC-* rm -rf catalogue.* modList rm -rf valid v.xml ValidatorLog.xml Utilities/pointerattributes.xsl graphics.sh missfont.log v.body v.header Schematron1.xml Schematron2.xml Checking you have running XML tools and Perl before trying to run transform... Ant:/usr/bin/ant Perl:/usr/bin/perl Java:/usr/bin/java xmllint:/usr/bin/xmllint touch check.stamp get latest date: VCS is git if [ "git" = "svn" ] ; \ then \ if [ true = "true" ] ; \ then svn info --xml svn://svn.code.sf.net/p/tei/code/trunk/P5 ; \ else svn info --xml ; \ fi > repodate.xml ; \ fi if [ git = "git" ] ; \ then \ git log --max-count=1 --pretty=format:"<info type=\"git\"><entry><commit revision=\"%h\"><date>%ai</date></commit></entry></info>" > repodate.xml ; \ fi BUILD: Generate modular DTDs, Schemas, Schematron and miscellaneous outputs ANT_OPTS="-Xss2m -Xmx752m -Djava.awt.headless=true" ant -q -lib Utilities/lib/jing.jar:Utilities/lib/saxon9he.jar -f antbuilder.xml -DXSL=<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/../../../Stylesheets/la…> -DDRIVER=Source/guidelines-en.xml base subset outputs [echo] make modular DTDs, RELAXNG schemas, json, odd schemas, schematron files [echo] Using <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/../../../Stylesheets/la…> for XSL stylesheets [echo] Do ODD processing for p5odds.odd [echo] Do ODD processing for p5odds-examples.odd BUILD SUCCESSFUL Total time: 1 minute 12 seconds BUILD: Generate modular RELAX NG (compact) schemas using trang (cd Schema; for i in *rng; do java -jar ../Utilities/lib/trang.jar $i `basename $i .rng`.rnc;done) touch schemas.stamp BUILD: Check validity with rnv if we have it command -v rnv && rnv -v p5odds.rnc p5.xml /usr/local/bin/rnv rnv version 1.7.10 p5.xml BUILD: Check validity with special-purpose XSL code, looking for bad links etc ANT_OPTS="-Xss2m -Xmx752m -Djava.awt.headless=true" ant -q -lib Utilities/lib/saxon9he.jar -f antbuilder.xml -DXSL=<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/../../../Stylesheets/la…> validators [echo] Run Schematron script (normal part of Guidelines) [echo] Run Schematron script (Examples in Guidelines marked as valid) [echo] Run ad hoc XSLT validators BUILD SUCCESSFUL Total time: 31 seconds <Messages> <WARNING>Schematron warning: WARNING: use of deprecated method — the use of the altIdentifier element as a direct child of the msPart element will be removed from the TEI on 2016-09-09 [Test: child::tei:altIdentifier] Location: /TEI[1]/text[1]/body[1]/div[10]/div[10]/specGrp[1]/elementSpec[1]/exemplum[2]/egXML[namespace-uri()='http://www.tei-c.org/ns/Examples'][1]/msDesc[namespace-uri()='http://www.tei-c.org/ns/Examples'][1]/msPart[namespace-uri()='http://www.tei-c.org/ns/Examples'][2]</WARNING> </Messages> (grep -q "<ERROR>" ValidatorLog.xml;if [ $? -ne 1 ] ; then echo "Oh dear me. ERROR found";diff ValidatorLog.xml expected-results/ValidatorLog.xml;false; fi) sh graphics.sh BUILD: Check validity with nvdl, first examples with feasible validity, and then the valid ones ./run-onvdl p5.nvdl p5.xml /usr/bin/onvdl <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/p5.xml>:67929:7: error: element "note" from namespace "http://www.tei-c.org/ns/Examples" not allowed in this context <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/p5.xml>:67998:31: error: element "note" from namespace "http://www.tei-c.org/ns/Examples" not allowed in this context <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/p5.xml>:67929:7: error: element "note" from namespace "http://www.tei-c.org/ns/Examples" not allowed in this context <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test/ws/P5/p5.xml>:67998:31: error: element "note" from namespace "http://www.tei-c.org/ns/Examples" not allowed in this context Error: nvdl run found problems make: *** [valid] Error 1 Build step 'Execute shell' marked build as failure

1 1

msFrag
by Hugh Cayless 18 Feb '16

18 Feb '16

Hi All, I'm about to merge the msFrag branch and I'm looking at content models. I seem to remember, but can't find in the minutes, that we thought msPart and msFrag were mutually exclusive. I.e., you wouldn't want to use them together. I can *imagine* a scenario in which I might, but I'm thinking that absent a request for it, we should start conservatively and say you can either have 0-∞ msParts of 0-∞ msFrags, but not both. What do you all think?

2 3

Dear Jenkins maintainers
by Hugh Cayless 18 Feb '16

18 Feb '16

I added a warning message to the transformtei script that tells you if you haven't set a local source, meaning it will download the last released one. This is usually fine, but at times, and particularly now, when our last release doesn't use Pure ODD, it can mean spurious bugs appear. Jenkins doesn't like warnings it hasn't been told about, so I added a rule: https://github.com/TEIC/TEI/commit/267926631ad4e5cdfc7c8da56cbb04e8f58ab2fd This change will need to be applied to Jenkins so that future builds are stable. Thanks, Hugh

1 0

dataRef attr descriptions
by Syd Bauman 18 Feb '16

18 Feb '16

The description of dataRef/@key is "the identifier used for this datatype specification". This is confusing, if not outright nuts: the identifier used for this particular data reference element would be specified on @xml:id. I'm of a mind that the three "what I'm referring to" attributes should have parallel descriptions. Something like: key = The datatype being referred to from the set of provided or custom TEI datatypes, indicated by its identifier (e.g., "teidata.language") name = The datatype being referred to from the datatypes found in _XML Schemas: Part 2: Datatypes_, indicated by its name (e.g., "gYear") ref = The datatype being referred to in an external datatype library, indicated by a URI although I'm sure those can be improved upon. Meanwhile I've discovered that the dataRef.xml/elementSpec/listRef/ptr/@target pointed to the wrong section, and that in that file @ref was defined as a name, not a URI. I have fixed these corrigible errors, but did not want to muck with the wording on my own.

2 1

@restriction doesn't make it to documentation
by Syd Bauman 18 Feb '16

18 Feb '16

Apologies if this has been pointed out before, I'm a bit behind on PureODD. I just realized that although the pattern specified on @restriction of <dataRef> makes it into the .rnc file (and .rng, and I presume .xsd although I couldn't care less), it does not make it into the HTML customized documentation file.

2 1

need input on ticket 1331, dating attributes
by Syd Bauman 15 Feb '16

15 Feb '16

[Insert pun about the attributes required to get a ticket for a medieval match.com here.] [New folks -- e-mail from me should almost always be read with a fixed-width or monospaced font. This one is no exception.] For ticket 1331 (https://github.com/TEIC/TEI/issues/1331) I'm supposed to jigger the prose a bit, and develop a table of the semantics of the various combinations of @from, @to, @notBefore, and @notAfter. I've gotten a very good start on this, but am running into trouble with the table, and am seeking help and advice. Issues, in rough order of importance: 1. There are two combinations of these attributes that I don't know what to do with. As far as I'm concerned, it makes no sense to use the pairs @from & @notBefore or @to & @notAfter. That said, some *might* argue that using three of the four (either @from with @notBefore & @notAfter, or @to with @notBefore & @notAfter) does make sense. (Specifying a duration that starts at @from and ends sometime in the range specified by the other two, or that ends at 3A@to and starts sometime in the range specified by the other two.) So: a) What should I put for the makes-no-sense pairs? b) Should I be writing prose to support the ( (@from|@to), @notBefore, @notAfter ) encoding? Or is that too wild? Or is there some other interpretation we should be considering? 2. Since order of attribute specification is inconsequential, and an attribute may only be specified once, making a full 4x4 table of these attributes results in 4 cells that make no sense because they are for the same attribute twice, and each of the other unique 6 cells is duplicated (for a total of 16 cells). A B C D A XX ba ca da B ba XX cb db C ca cb XX dc D da db dc XX Should we display all 16 cells? Or make an abbreviated chart, e.g.: A B C D A XX -- -- -- B ba XX -- -- C ca cb XX -- D da db dc XX Or, noting that in the above chart row A and column D are useless, make a truncated chart, e.g.: A B C B ba XX -- C ca cb XX D da db dc If you look at the draft of the chapter I have at the moment (http://paramedic.wwp.neu.edu/~syd/temp/TEI_Council/html/ND.html#NDATTSda) you'll see that there several (ugly) versions of this table. Which one should we use? 3. The default HTML styling of <table>, <tr>, and <td> is not good for this purpose, and I see no easy way to special-case this. (Putting @style on <td>, and maybe <tr>, does not work; the attribute does not get propagated to the HTML.) Does anyone know of a way around this, or already know where in the Stylesheets I should be working to get @style working? If you take a look at http://paramedic.wwp.neu.edu/~syd/temp/TEI_Council/test-table-of-attrs-layo…, you'll see a set of tables closer to what I think they should look like.

3 2

versions
by Lou Burnard 13 Feb '16

13 Feb '16

I've been asked to run a workshop on ODD at the Ecole Nationale des Chartes at the start of March, and I'd like to use the latest version of pure ODD, plus Stylesheets that process it. So, remind me chaps, what do I need to do to ensure that workshop participants get the right stuff installed in their oxygens? Or will we really have a release 2.9 out before then? (My workshop is on the 3rd, so this is cutting it fine in any case...)

1 0

odd reminder
by Lou Burnard 09 Feb '16

09 Feb '16

I haven't heard from anyone since I asked Council members to check that their existing ODDs continue to work as expected using the lb42-pureodd branch. So maybe no Council members actually have any ODDs to check, or maybe those who do have all checked and have nothing to report, or maybe they just haven't got round to it yet. I don't know, but just in case it's the 3rd possibility, please could I urge you to give it a go this weekend? If you prefer, you could just bung me a copy of the ODD and I'll test it for you! Why the pressure? Well, mostly that I've just been reminded that we're aiming for a pre-release freeze for the end of the current month, and I'm going to be buried in the French countryside with only intermittent net access until then.

7 20

Re: [tei-council] Testing Pure ODD
by James Cummings 09 Feb '16

09 Feb '16

Well, as I said, mostly this was very very simple relaxng content models in any case. I might mock up some more complex ODD doing something bizarre with datatypes.... when I get some time. -James On 09/02/16 11:41, Lou Burnard wrote: > Thanks James.. V encouraging! > > Sent from my Honor Mobile > > -------- Original Message -------- > Subject: [tei-council] Testing Pure ODD > From: James Cummings > To: TEI Council > CC: > > 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 > -- > tei-council mailing list > tei-council(a)lists.tei-c.org > http://lists.lists.tei-c.org/mailman/listinfo/tei-council > > PLEASE NOTE: postings to this list are publicly archived -- Dr James Cummings, James.Cummings(a)it.ox.ac.uk Academic IT Services, University of Oxford

2 1