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

Re: [Tei-council] Spring F2F meeting
by James Cummings 12 Oct '18

12 Oct '18

Apologies for the delay in responding. To confirm, I'd be willing to host a council meeting here in Newcastle. I could also do so in future years if that was preferable. Venues: There are two possible venues: A) One is the city centre campus, for which I could find one or more meeting rooms, downtown has plenty of hotels, airbnb, restaurants and that sort of thing. B) The other possible venue would be about 9 miles out of the city centre (direct metro line) in either a hotel conference room (at charge) or the Dove Marine Laboratory. This is a research institution in a victorian building right on the beach in Cullercoats bay https://goo.gl/maps/cJLSCEX8jHS2, a short walk south is Tynemouth (lots of trendy restaurants, cafes, lovely ruined medieval priory). I've been to university workshops at the Dove and will investigate the rules for booking it. No idea if it is free then. There is also a 'Premier Inn' hotel with conference rooms in Whitley Bay right next to the iconic recently refurbished Spanish City building (mentioned in a Dire Straits song if you are into such trivia). Travel: Newcastle Airport is connected to the city by a quick, fairly inexpensive and frequent metro system (that goes out to the coast and covers the whole metropolis area between Newcastle, the coast, and Sunderland.) Newcastle Airport is usually 1 hop to most major interchanges (via Heathrow, Schiphol, etc.) Dates: As we're really far North (literally, Hadrian's wall used to run through Newcastle), then later is better in terms of weather. In terms of the university calendar the Easter Break is from Friday 29 March to Monday 29 April. Good Friday is 19 April, Easter Monday: 22 April. I only mention it because these are probably not good days to travel or find open restaurants for large groups. I'm busy in the week 1-5 April doing a TEI workshop. This actually presents an opportunity where we might have budget to help with the travel for 1 (or 2 max) council members if they were also teaching on that workshop. This would mean maybe having it sometime in 6 - 12 April. According to weather.com historically that is like 9-10C/48-50F around that time of year (and windy on the coast). Some random videos: University promotional ones https://www.youtube.com/watch?v=E3jR3NvU-TY https://www.youtube.com/watch?v=htlYW8RppWA https://www.youtube.com/watch?v=Okf1pmDkem8 Cullercoats bay with Dove Marine Laboratory in the middle, boring drone footage https://www.youtube.com/watch?v=9BKf4hZNWRM Whitley Bay and Tynemouth, better drone footage https://www.youtube.com/watch?v=Hn5nx6VIAhw Spanish City (during refurb) boring drone footage: <https://www.youtube.com/watch?v=K4dHu_t9ETM>https://www.youtube.com/watch?v=CxHW3j83IDY Many thanks, James -- Dr James Cummings, James.Cummings(a)newcastle.ac.uk School of English Literature, Language, and Linguistics, Newcastle University ________________________________ From: Tei-council <tei-council-bounces(a)lists.tei-c.org> on behalf of Mylonas, Elli <elli_mylonas(a)brown.edu> Sent: 03 October 2018 23:23:52 To: TEI Council Subject: Re: [Tei-council] Spring F2F meeting I can host at Brown most of the spring term. Some better and some blackout dates: When students aren't here: Long weekend Feb 16-19 Spring break Mar 23-31 NOT POSSIBLE - April 4-5 best, --elli On Wed, Oct 3, 2018 at 4:05 PM Scholger, Martina (martina.scholger(a)uni-graz.at<mailto:martina.scholger@uni-graz.at>) <martina.scholger(a)uni-graz.at<mailto:martina.scholger@uni-graz.at>> wrote: Dear all, picking up on the minutes from our last call I would ask everyone who offered to host the next Spring F2F meeting to confirm their willingness to do so and to set out the possibilities in terms of place and date before our next call. We should figure out what is feasible as soon as possible. We have offers from: Elli at Brown University in Providence James at Newcastle University Magdalena in Warsaw Raff at Folger Library in Washington D.C. Best wishes, Martina _______________________________________________ Tei-council mailing list Tei-council(a)lists.tei-c.org<mailto:Tei-council@lists.tei-c.org> http://lists.lists.tei-c.org/mailman/listinfo/tei-council

6 6

Re: [Tei-council] oxgarage missing
by Peter Stadler 09 Oct '18

09 Oct '18

Hi Ian thanks for your immediate reaction! If I recall correctly, we regularly had some memory issues with OxGarage, thus restarting it every(?) night via a cron job. I don’t think that’s necessary, but we could improve it in a more docker-like way by adding a health check to the Dockerfile. Do you have some monitoring software which could read that information and restart the container if necessary? Best Peter > Am 04.10.2018 um 00:51 schrieb Ian Rifkin <irifkin(a)brandeis.edu>: > > Hi, > > Java heap memory issues in the log file. I restart the oxgarage docker and it seems to be back up and running. Peter, let me know if you think it was a fluke or if something needs to be adjusted. > > Thanks, > Ian > > On Wed, Oct 3, 2018 at 6:21 PM Peter Stadler <stadler(a)edirom.de> wrote: > Hi Nick, > > I can confirm that I’m unable to connect to oxgarage.tei-c.org, as well. > Seems to be a server issue and probably needs a restart of the service (which I can’t do, sadly) … > In the meantime, please use oxgarage2.tei-c.org. > > Thanks for reporting! > Peter > > >> Am 03.10.2018 um 21:42 schrieb Nick Thieberger <thien(a)UNIMELB.EDU.AU>: >> >> I'm getting '504 Gateway Time-out' on ox-garage, is there any update on its availability please? >> >> Thanks, >> Nick >> >> On Tue, 26 Jun 2018 at 01:43, Hugh Cayless <philomousos(a)gmail.com> wrote: >> I haven't heard anything about it yet, but it looks like OxGarage and Roma are back. >> >> Hugh >> >> On Mon, Jun 25, 2018 at 7:28 AM Hugh Cayless <philomousos(a)gmail.com> wrote: >> It looks to me like the site has been switched over to the new version that's been waiting in the wings for a while, but that none of the configuration for handling the Tools section has been set up. The good news is that OxGarage is still running, it's just temporarily inaccessible. I've emailed our sysadmin. I'm afraid I don't have the necessary permissions to actually fix (or even see) the web server configuration. >> >> Hugh >> >> On Mon, Jun 25, 2018 at 6:22 AM Toma Tasovac <ttasovac(a)humanistika.org> wrote: >> Hi, >> >> what happened to OxGarage? >> >> http://www.tei-c.org/oxgarage/ (which is the link given in the Tools dropdown menu) gives oops that page can't be found >> >> All best, >> Toma >> -- >> Belgrade Center for Digital Humanities >> http://humanistika.org >> > > > > -- > Ian Rifkin '04, MS '09 > Director of Data and Systems Integration > Brandeis University, Information Technology Services (ITS) > Email: irifkin(a)brandeis.edu | Phone: (781) 736-4216 | Fax: (781) 736-4577 > Learn more about our campus move to Workday

2 2

Monthly call
by Scholger, Martina (martina.scholger＠uni-graz.at) 09 Oct '18

09 Oct '18

Dear all, we still need to find a solution for our monthly call. Unfortunately there is no slot that suits all of us. I had again a closer look at our "best" options with 9 or 10 "yes/if need be" answers. This is it (initials in brackets indicate those members who voted "no, I can't make it"): Mon 13Z (VB, EB) Tue 19Z (MT, EB); 20Z (MT, HC); 21Z (MT, HC) Fri 19Z (MT, EB); 20Z (MT); 21Z (MT, HC) Narrowing this down to the smallest overlap of people who can't make it, Mon 13Z and Fri 20Z are remaining. Therefore, I suggest to alternate every month between Monday and Friday in order to enable everyone to at least attend once every second month. I created another doodle poll with dates in the 3rd and 4th week of October to set a starting date. Please vote! https://doodle.com/poll/vwdvmm67xztq4csk (I hope you can see it in your time zone) I am aware that this is hardly an ideal solution, but I don't see another option yet. Best wishes, Martina

2 1

Monthly call
by Scholger, Martina (martina.scholger＠uni-graz.at) 09 Oct '18

09 Oct '18

Dear all, looking at the doodle I am somewhat at a loss. There is no single date and time where everyone on the Council is available. The "best" we could do is Friday at 20:00Z, but Magdalena would not be able to join and three people would rather not. The next best would be Friday at 19:00Z, but with two people missing. I don't think that we should schedule a regular date where we already know that at least one person will not be able to make it. I would ask everyone to have one more look at the doodle and consider if you can possibly make more choices. Keep in mind that we are meeting just once a month. https://doodle.com/poll/kk9hsr6z9csxhkub If we can't find a common date that way, would it make a difference if the call would be just 60 instead of 90 minutes? Are there other suggestions to solve our dilemma? Best wishes, Martina

2 3

Travis ne Jenkins ne local
by Syd Bauman 05 Oct '18

05 Oct '18

The dev branch now has all the deprecations valid until 2018-10-01 removed, and its build working ala Travis. However, said build is not working in Jenkins (on either jenkins or jenkins2 -- for some reason the former does not have parsed console output, but it is the same error), and is working on my local system, after a fashion. The error on Jenkins, however, is completely mysterious. It has *nothing* to do with anything that I am aware of having changed. The ONVDL validation of Exemplars/tei_enrich.odd against Exemplars/tei_enrich.nvdl is failing with error: bad value for attribute "columns" where the value for @columns is "1", and thus is perfectly fine. I can, with some effort, reproduce this error on my local system. All of the @columns attrs in tei_enrich.odd are on elements in the teix: namespace, i.e. within <egXML>. I am pretty sure the only schema tei_enrich.nvdl runs against that namespace is tei_enrich-examples.rng. And lo and behold, when I look at that schema the definition of @columns of <layout> is obviously screwball: | <attribute name="columns"> | <a:documentation xmlns:a="http://relaxng.org/ns/compatibility/annotations/1.0">specifies | the number of columns per page</a:documentation> | <list> | <rng:empty xmlns:rng="http://relaxng.org/ns/structure/1.0"/> | </list> | </attribute> I poked around and found that the tei_enrich.odd file changes the definition of <layout> a teeny bit: | <elementSpec ident="layout" mode="change" module="msdescription"> | <attList> | <attDef ident="columns" mode="change" usage="req"/> | </attList> | </elementSpec> But that specification is in a paragraph of prose that essentially negates it: | <p>Note that if (as in the last example above) no value is given for | the <att>columns</att> attribute, the assumption is that there is a | single column of writing on each page. (And is incorrect, in that the prior example does have a value for layout/@columns.) So I claim that a) This is a Stylesheets issue. Somehow changing @columns to required has nuked its datatype, which is supposed to be ( data.count, data.count? ) b) The Enrich ODD has other problems, too I'm too tired now to do much more on this tonight.

4 5

cannot build
by Lou Burnard 04 Oct '18

04 Oct '18

I updated Stylesheets, and pulled the latest P5 sources, and ran "make clean; make" Everything worked up to the point where the "special purpose" validity checks began. At that point I got a shed load of annoying errors, starting with 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=/usr/share/xml/tei/stylesheet 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: 27 seconds <Messages> <ERROR>Schematron error: The data.certaintyconstruct is outdated (as of 2018-10-01); ODD processors may ignore it, and its use is no longer supported [Test: @validUntil cast as xs:date ge current-date()] Location: /TEI[1]/text[1]/body[1]/div[1]/div[6]/macroSpec[1]</ERROR> <WARNING>Schematron warning: The data.certainty construct becomes outdated on 2018-10-01 [Test: @validUntil cast as xs:date ge $advance_warning_period] Location: /TEI[1]/text[1]/body[1]/div[1]/div[6]/macroSpec[1]</WARNING> [and so on for a few screens, concluding with] <WARNING>Schematron warning: The macro.anyXML construct becomes outdated on 2018-06-12 [Test: @validUntil cast as xs:date ge (current-date() + (60*xs:dayTimeDuration('P1D')))] Location: /TEI[1]/text[1]/body[1]/div[1]/div[4]/div[1]/specGrp[1]/macroSpec[7]</WARNING> > <ERROR>Schematron error: > Error: both the versionDate and xml:lang attributes on "remarks" are required when it is a child of "attDef". > [Test: not( @xml:lang and @versionDate )] Location: /TEI[1]/text[1]/body[1]/div[22]/div[3]/specGrp[1]/elementSpec[4]/attList[1]/attDef[1]/remarks[1]</ERROR> Makefile:185: recipe for target 'valid' failed make: *** [valid] Error 1 lou@foxglove:~/Public/TEI/P5$ Tell me, what have I done to deserve this?

3 6

Spring F2F meeting
by Scholger, Martina (martina.scholger＠uni-graz.at) 04 Oct '18

04 Oct '18

Dear all, picking up on the minutes from our last call I would ask everyone who offered to host the next Spring F2F meeting to confirm their willingness to do so and to set out the possibilities in terms of place and date before our next call. We should figure out what is feasible as soon as possible. We have offers from: Elli at Brown University in Providence James at Newcastle University Magdalena in Warsaw Raff at Folger Library in Washington D.C. Best wishes, Martina

2 1

Re: [Tei-council] Stylesheets v7.46.0 released
by James Cummings 03 Oct '18

03 Oct '18

re: council responsibility. Council responsibility for stylesheets is for those that we use to generate the website and those that we use to process ODDs. Everything else is optional but nice for the community (IMHO) Many thanks, James -- Dr James Cummings, James.Cummings(a)newcastle.ac.uk School of English Literature, Language, and Linguistics, Newcastle University ________________________________ From: Tei-council <tei-council-bounces(a)lists.tei-c.org> on behalf of Raffaele Viglianti <raffaeleviglianti(a)gmail.com> Sent: 02 October 2018 15:35:45 To: Peter Stadler Cc: tei-council(a)lists.tei-c.org; Martin Holmes Subject: Re: [Tei-council] Stylesheets v7.46.0 released I added a couple paragraphs to the document, let me know what you think. This conversation we're having echos the worry I expressed in my first email: > I don't know if stylesheets releases need to be announced on TEI-L, especially since we don't assemble a document listing changes besides a generated changelog. Perhaps the paragraph I added are enough, but it's easy to go down a rabbit hole. The Stylesheets are important, but it's still unclear how much of a responsibility council has towards them since our primary goal is maintaining and improving the TEI Guidelines. All best, Raff On Tue, Oct 2, 2018 at 8:18 AM Peter Stadler <stadler(a)edirom.de<mailto:stadler@edirom.de>> wrote: I agree that the current draft is not very helpful except for saying "there is a new release“. We should add a) the main motivation. It is unusual that we are doing a Stylesheets release out of sync with the Guidelines. AFAIK, the main motivation is Raff’s work on RomaJS and his need for p5subset.json, leading to various changes to odd2json.xsl in the Stylesheets repo. That need to be mentioned. @raff: could you elaborate a little bit on those changes? what’s different now in the resulting p5subset.json? (and what’s the difference to p5subset.js?) b) nothing more. The rest is indeed technical stuff and won’t improve any research. Best Peter > Am 02.10.2018 um 13:01 schrieb Vanessa Bigot-Juloux <vanessa.bigot-juloux(a)ephe.psl.eu<mailto:vanessa.bigot-juloux@ephe.psl.eu>>: > > Dear all, > > I have added a comment on the doc two days ago. However, it needs further explanations: > I have looked to TEI council profiles; from what I understood, you have a lot of knowledge in encoding, more than a lot of digital practitioners who use TEI (and other encoding languages needed to work with TEI) mostly for their investigation in a text/corpus/artefact. This is my case: I use TEI and other languages because I need these tools for investigating my corpus. By saying this, I have not the same background/knowledge (and goal) than most of you. Thus, if you agree, my first remarks will rather be (at least for now) to make sure than beginners or digital practitioners (but no experts in programming languages) will be able to understand not only encoding but also how it can help them to improve their research. In addition, I think we need to take advantage of each opportunity for doing a little pedagogy and the Stylesheets released is a good opportunity. > When you did the release of the Guidelines http://www.tei-c.org/release/doc/tei-p5-doc/readme-3.1.0.html (thanks James), you tried to give a few helpful information—although we can always be improved. > As for this Stylesheets release, I think we need to give further information regarding the issues resolved--not for all topics since a few of them will not be as much interest for beginners or average level. For example, something like: > “Among other issues resolved in the last stylesheets v7.46.0 released: > - In order to avoid a schematron [link] processor (in other words rule-based validation language) error regarding @ageAtDeath [link], rather used teidata.count [link] attribute group instead of teidana.numeric [link] (https://github.com/TEIC/Stylesheets/issues/322)”--I don’t know if it was updated on TEI website, but if this is the case, also add the TEI link updated. > - …” > > However, we need to ask ourselves the following question: how the issues resolved can be helpful to beginner and average level practitioners, in order to choose the issues which need more information. > Lastly, I’m not convince all readers will understand what is “stylesheets released.” —maybe under bracket something like “improvements according to issues resolved.” > > I suggest that the message has two sections: one for experts and one for beginners and average levels practitioners. > > Hope my explanation is clear enough… and that I’m not getting wrong in TEI council goals. > > Best, > Vanessa > > >> Le 30 sept. 2018 à 17:19, Scholger, Martina (martina.scholger(a)uni-graz.at<mailto:martina.scholger@uni-graz.at>) <martina.scholger(a)uni-graz.at<mailto:martina.scholger@uni-graz.at>> a écrit : >> >> Ah, thanks. Changed the milestone to 7.46 in Github. >> >> Best, Martina >> >> -----Ursprüngliche Nachricht----- >> Von: Tei-council <tei-council-bounces(a)lists.tei-c.org<mailto:tei-council-bounces@lists.tei-c.org>> Im Auftrag von Syd Bauman >> Gesendet: Samstag, 29. September 2018 21:56 >> An: tei-council(a)lists.tei-c.org<mailto:tei-council@lists.tei-c.org>; Martin Holmes <mholmes(a)uvic.ca<mailto:mholmes@uvic.ca>> >> Betreff: Re: [Tei-council] Stylesheets v7.46.0 released >> >> Sorry, hit "send" before I was even done writing, let alone editing, that. >> >> Martina -- I don't know if you created a 7.45, 7.46, or 7.47 milestone. You may need to tweak the GiHub milestones or the e-mail to fit. >> _______________________________________________ >> Tei-council mailing list >> Tei-council(a)lists.tei-c.org<mailto:Tei-council@lists.tei-c.org> >> http://lists.lists.tei-c.org/mailman/listinfo/tei-council >> _______________________________________________ >> Tei-council mailing list >> Tei-council(a)lists.tei-c.org<mailto:Tei-council@lists.tei-c.org> >> http://lists.lists.tei-c.org/mailman/listinfo/tei-council > > _______________________________________________ > Tei-council mailing list > Tei-council(a)lists.tei-c.org<mailto:Tei-council@lists.tei-c.org> > http://lists.lists.tei-c.org/mailman/listinfo/tei-council _______________________________________________ Tei-council mailing list Tei-council(a)lists.tei-c.org<mailto:Tei-council@lists.tei-c.org> http://lists.lists.tei-c.org/mailman/listinfo/tei-council

3 2

Adding or Editing an Appendix - TCW20
by Scholger, Martina (martina.scholger＠uni-graz.at) 03 Oct '18

03 Oct '18

Dear all, Martin asked me to forward a message: "I've added a section to TCW20 on how to add or edit appendices to the Guidelines, since Syd and I have just been figuring out how that works for issue #1657: <http://teic.github.io/TCW/tcw20.html#appendices>" Thanks Martin for adding this! Best wishes, Martina

1 0

Re: [Tei-council] TCW 20 Revision on Branch Practice?
by James Cummings 03 Oct '18

03 Oct '18

I'd say that not all tickets are Guidelines related (e.g. we have a label for TEI:Website and another for TEI:Build Process), so perfectly reasonable to have a ticket as a place for conversation about this that we might return to in the future. That is assuming that this is something that might have several iterations, tests, decision about which is the best way, etc. If it is a straightforward "Let's test this, oh look, it works now let's document that." then maybe a ticket is not needed. My two pence, James -- Dr James Cummings, James.Cummings(a)newcastle.ac.uk School of English Literature, Language, and Linguistics, Newcastle University ________________________________ From: Tei-council <tei-council-bounces(a)lists.tei-c.org> on behalf of Elisa Beshero-Bondar <ebb8(a)pitt.edu> Sent: 03 October 2018 12:10:28 To: TEI Council Subject: Re: [Tei-council] TCW 20 Revision on Branch Practice? PS: Should I open that as a ticket? Since it's not specifically Guidelines-related, I'm not sure...figured I'd sound us out here first. Thanks, Elisa On Wed, Oct 3, 2018 at 7:08 AM Elisa Beshero-Bondar <ebbondar(a)gmail.com<mailto:ebbondar@gmail.com>> wrote: Dear Council, I was just re-reading TCW 20 to remind myself what we advise each other on working in feature branches, and how to update them. You may remember some excitement during our Tokyo face-to-face as I first nearly bungled a branch merge and then we fixed it. This was, I think, a bit too much excitement, and lots of us do work in branches. When it comes time to update them and/or merge them back into dev, we don't always know exactly what to do, and just relying on looking stuff up is, as we saw, a little brittle and error prone. We are pretty confident we can fix anything that goes wrong, but perhaps we can minimize the excitement with a little more guidance to our future selves. So, I'm writing this to propose some revision to this portion of TCW 20: "If you are working on a particularly complex change involving multiple files, it may be better to create a branch in which to work on your changes, and then to merge the branch when you are confident that the work is successfully completed. See any guide to git for instructions on how to approach that. Bear in mind that our Jenkins servers only build the dev branch, so you cannot depend on them to test-build your working branch." I'd like to propose rewriting that with some more detailed steps on our TEI Technical Council preferred process for reconciling branches with dev, to help prevent future excitement. :-) I've been reading about the "best" ways to keep branches updated, and the differences, for example, between rebase and merge for keeping a branch tip updated. Rebasing is pretty dangerous in that it "rewrites history" by resequencing commits, so I am not sure we ever want to use it for updating a branch from dev, before merging it back. Do we want to always advise, then, to update a branch by merging it with dev? I'm not 100% certain of that either. What I'd like to do is (very careful) test a few approaches and work with you all to try to plot out an excitement-proof set of safe guidelines for Council members on Best Practices for Working in Branches as part of TCW 20. What say you all? Elisa -- Elisa Beshero-Bondar, PhD Associate Professor of English University of Pittsburgh at Greensburg Humanities Division 150 Finoli Drive Greensburg, PA 15601 USA E-mail: ebb8(a)pitt.edu<mailto:ebb8@pitt.edu> -- Elisa Beshero-Bondar, PhD Director, Center for the Digital Text | Associate Professor of English University of Pittsburgh at Greensburg | Humanities Division 150 Finoli Drive Greensburg, PA 15601 USA E-mail: ebb8(a)pitt.edu<mailto:ebb8@pitt.edu> Development site: http://newtfire.org<http://newtfire.org/>

4 3