February 2020 - Tei-council

Stylesheets tutorial meeting
by Syd Bauman 31 Mar '20

31 Mar '20

Reminder: our stylesheets tutorial meeting is scheduled for tomorrow, Tue 25 Feb at 14:00Z. That is: * 06:00 PST * 09:00 EST * 14:00 GMT * 15:00 CET I presume we will meet on Google Hangouts. Please have a local working copy of the Stylesheets repo[1] checked out (whether within Docker or not does not matter, I don't think). We will be relying on a few slides[2], a pair of images[3], and the mapping wiki page[4]. Notes ----- [1] https://github.com/TEIC/Stylesheets.git [2] Martin's anatomy_of_a_transformation [3] https://www.wwp-test.northeastern.edu/outreach/seminars/_utils/gfx/tei_odd_…, https://www.wwp-test.northeastern.edu/outreach/seminars/_utils/gfx/tei_odd_… [4] https://wiki.tei-c.org/index.php?title=Mapping_ODD_processing

3 5

next call: Tuesday, Feb 11
by Scholger, Martina (martina.scholger＠uni-graz.at) 23 Mar '20

23 Mar '20

Dear all, our next Council call is on Tuesday, February 11 (EDT 09:00-10:30, GMT 14:00-15:30, CEST 15:00-16:30). Please add topics to the agenda: https://docs.google.com/document/d/1hlKcKJJqW-LV0_-Q3rZQJqBxXySk_fA8qEJWlAu… We do not have a clear result for the F2F meeting location yet - so please fill in the doodle if you haven't done so far: https://doodle.com/poll/vpncpziivf4fcfn6 Best, Martina

7 14

I hate to bring this up, but...
by Hugh Cayless 27 Feb '20

27 Feb '20

We should perhaps be thinking about contingency plans for the F2F, in case we're hit by travel restrictions related to Covid-19. I'm not suggesting calling it off at this stage, but we should be aware of the risks. I'll note that Facebook tells me Elena Pierazzo is under 2 weeks quarantine at home after returning from Italy. So it's far from impossible. And that said, I will almost certainly not be able to make it in person. If things go according to plan, my wife will be in the middle of radiation therapy then. (It's ok—her prognosis is excellent, given what we know right now, but I'm not going to leave for several days under those conditions.) I'd like to participate remotely to the extent I can. Hugh

3 4

Fwd: TEI Question
by Elisa Beshero-Bondar 24 Feb '20

24 Feb '20

Dear Council colleagues, Can any of you shed light on this interesting question? Are we indeed using the words "licence" and "license" inconsistently in the Guidelines vs. the website? Best, Elisa ---------- Forwarded message --------- From: Sarah Ketchley <ketchley(a)uw.edu> Date: Sun, Feb 23, 2020 at 9:09 PM Subject: TEI Question To: Elisa Beshero-Bondar <ebb8(a)pitt.edu> Hi Elisa, I hope you are well! I have a question about spelling on the TEI website and in its guidelines. One of my eagle-eyed students in the Intro to DH class I’m currently teaching questioned the spelling of the TEI element < licence <https://www.tei-c.org/release/doc/tei-p5-doc/en/html/ref-licence.html>>. My immediate response was that it was based on British English, but then I started digging around the website, and came to the ‘Licensing page’ : https://tei-c.org/guidelines/licensing-and-citation/ where the noun is spelled ‘license’. Any insights on this?! Sorry to throw a left-fielder at you! best Sarah [image: Newbook Digital Texts] Dr. Sarah Ketchley / Egyptology | Digital Humanities ketchley(a)uw.edu University of Washington Department of Near Eastern Languages & Civilization M220D Denny Hall www.emmabandrews.org www.sarahketchley.com www.newbookdigitaltexts.org [image: Twitter] <https://htmlsig.com/t/000001CSRE2Z> [image: Facebook] <https://htmlsig.com/t/000001CP3HD8> [image: LinkedIn] <https://htmlsig.com/t/000001CP21K7> [image: Github] <https://htmlsig.com/t/000001CMN2AT> -- 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 <ebb8(a)pitt.edu> Development site: http://newtfire.org

3 2

Debian 9 -> Debian 10
by Luis Meneses 21 Feb '20

21 Feb '20

Hi All, I received an email from Joel at Huma-num about migrating two of our servers (web server and svn server) to Debian 10. I am including the translated message below. In this case, the migration path is an easy one since Huma-num is offering to do it for us. I will ask Joel for a timeframe when this will happen, but the transition should be transparent for us. Best, ----- -Luis Translation (courtesy of https://translate.google.ca): You are in charge of the administration of one or more virtual machines under Linux Debian 9, which run on our infrastructure. Debian 9 support for the Debian project has expired. All that remains is community support in "best effort" mode. We therefore invite you to plan the migration to Debian 10, which is as always easy, and must be almost transparent in a large part of the cases. We can of course help you to accompany you in this migration: - we do it - you validate in the process that everything works, and correct any concerns if necessary. NB: an easy and quick backtrack is always possible if in the last hours you have not changed the data contained in your virtual machine. This via the snapshot mechanism of our NetApp file server. ----- -Luis

2 2

on the content of <mapping>
by Syd Bauman 19 Feb '20

19 Feb '20

There are 21 examples of <mapping> in the _Guidelines_, and 5 different methods of representing the content thereof. (Although three of these methods are variants of the same idea.) The content model of <mapping> is macro.xtext, thus it can have only character data or <g>. Of the 21 of them, the desired mapping is represented in the content as: * straight character content in 15 (1 of those is multi-character, the rest are single characters); * numeric character references[1] in 3 (1 of those is multi-character, the others are single characters); * a <g> element in 1; and * the standard Unicode representation[2] in 2, i.e. they match "U\+[0-9A-F]{4,6}". The first three are variations of the same theme: the *content* of <mapping> *is* the character to which the character or glyph being defined should be mapped (whether expressed as character data, NCR(s), <g>(s), or some combination thereof). The last is entirely different. I think we can all agree that <mapping>U+00B5</mapping> means that the character or glyph currently being defined should be mapped to a single character µ = µ = µ = <g ref="#micro"/>, NOT a sequence of 6 characters U+00B5 = U+00B5. (Note that in the examples in _Guidelines_, the Unicode standard notational convention is used for all <mapping type="PUA">, and no other types of <mapping>.) But, as far as I know *nowhere* is this (the use of Unicode standard notation) mentioned in the _Guidelines_. Although I may be wrong about this, I do not think it would ever make sense to map a <char> onto a literal string "U+0123" (or "V=3456"). Furthermore, I think use of Unicode notation is a *really* good idea, *especially* if the character being represented is in the PUA; furthermore I suspect that the intention of whoever wrote this in the past was just that: Unicode standard convention should be used rather than actually putting PUA characters in a document instance. Thus I think the right solution is to: a) Have a _suggest values include_ list for mapping/@type (after all, we have it in the prose, sort of). b) Add some prose to 5.2 (#D25-20) that explains that in general "U+0123" notation may be used instead of "ģ" or "ģ", and that if the mapping is to the PUA area, this is the (vastly) preferred method. c) If anyone thinks it important to be able to map to absolutely arbitrary strings, then pick some value of @type (say "exact") for which use of "U+0123" would actually map to the string "U+0123". Notes ----- [1] Of course, they occur with "&" instead of an actual ampersand if you are reading the source. [2] Per the Unicode Standard Appendix A, "Notational Conventions".

2 3

guidance on last char of each <desc>
by Syd Bauman 18 Feb '20

18 Feb '20

labels: * TEI: Guidelines & Documentation * Priority: Low * CouncilResponsibility I had intended to submit a ticket on this topic, but after a bit of research realize I don't know what the ticket should say. So I'm asking for guidance from y'all -- what should we do about the following issue? IIRC, in general a <desc> should be 1 sentence that does not start with a capital letter, but does end in a full stop. By my count there are 10,475 <tei:desc> elements in the _Guidelines_. (That's not counting the 228 that are inside <egXML>; they are <teix:desc> elements that probably should be addressed, too.) Of those, 7689 end in a full stop,[1,2] and the other 2786 do not. That's a lot. Of course some of them should not end in full stop (e.g., those that end in ".)" or those that should not be a <desc> at all like the gloss of the value "group" of the @org attribute of <attList>). But most, I suspect, should. What to do? I submit that a) 2786 is way too many for manual intervention b) there are a bunch that end in screwy characters that probably need to be looked at (e.g., '>', superscript digits, '*') c) I am utterly unqualified to deal with non-English cases One thought is to divvy them up by language, so that (for example) I only have to deal with English, and ask for help for the other languages (perhaps ask Peter or Martina to deal with the German cases, Martin the Japanese, Raff the Italian, Alejandro the Spanish). Each language would be much more manageable on its own, I suspect. At least, the English certainly would be. There are only 9 categories: 1424 . 404 [a-z] 15 ) 2 [superscript digit] 2 [A-Z] 1 5 1 … 1 " 1 ; After some spot-checking, I would not be surprised if it made sense to automatically insert a period after all the [a-z] and ')' cases, leaving only 8 cases (in 6 categories) to be examined by hand. Thoughts? In case you want to see them (clicking on a column headings sorts): * All of them: https://bauman.zapto.org/~syd/temp/4TEICouncil/last_of_the_descs/lotd.xhtml * Only those that end in something other than full stop: https://bauman.zapto.org/~syd/temp/4TEICouncil/last_of_the_descs/lotdnfsonl… * Only those that are in English: https://bauman.zapto.org/~syd/temp/4TEICouncil/last_of_the_descs/lotend.xht… * Only those that are in English and do not end in full stop: https://bauman.zapto.org/~syd/temp/4TEICouncil/last_of_the_descs/lotendnfso… Notes ----- [1] I get bizarrely different results with different counting methods, not sure why. [2] 1002 are U+3002, IDEOGRAPHIC FULL STOP, mostly in zh-TW, but 57 in ja 1370 are U+FF0E, FULLWIDTH FULL STOP, most if not all in ja 5317 are U+002E, FULLSTOP, in lots of other languages

1 0

Travis check failures
by Martin Holmes 14 Feb '20

14 Feb '20

Hi all, I haven't really been involved in the setup of the Travis checks, so I don't really know what they're doing. Ron has made a pull request which I'd like to approve: <https://github.com/TEIC/Stylesheets/pull/420/> (I don't see anything wrong with it), but the Travis checks are failing. I can't see how to tell what checks have failed or why they've failed. When I ask Travis to re-run the checks, it shows "Re-running checks", but never seems to complete. Cheers, Martin -- ------------------------------------------ Martin Holmes UVic Humanities Computing and Media Centre

2 2

model.resource
by Peter Stadler 14 Feb '20

14 Feb '20

Hy Syd (hold you responsible), I have to admit that this slipped my notice in the last days but now that I do, I believe renaming model.resourceLike to model.resource was a bad idea. There’s even no deprecation for this class so all the customizations will suddenly break (this is how I noticed) for people using this class for e.g. hooking in other stuff … Just wanted to be the first to complain ;) Best Peter

5 5

Stylesheet BIBL ptrs mess up test?
by Syd Bauman 13 Feb '20

13 Feb '20

I don't get this. I just tried a local `make test` in Stylesheets (setting the DEFAULTSOURCE to my local 'dev' copy of p5subst), and it failed because of an expected results error. But I personally copied over the expected results file in question yesterday or the day before. The diff failure is: result: ! defined in <ref target="http://www.tei-c.org/release/doc/tei-p5-doc/en/html/BIB.html#XSLT2">6.2. </ref>.</p> exptected result: ! defined in <ptr target="#XSLT2"/>.</p> and 1/2 dozen others exactly like that. I.e., w/ full URI instead of just bare name identifier. What gives? Has anyone changed anything that should have anything to do with this? Is it something on my local system? (That's a rhetorical question.) Could one of the CI maintainers kick off the Stylesheets-dev-against-TEIP5-dev job?

4 12

Freeze! Don't push to the dev branch of TEI or Stylesheets
by Elisa Beshero-Bondar 13 Feb '20

13 Feb '20

Dear Council: I'm at last creating the release branches for 3.7.0, so please don't push to dev for a moment until I send the "all clear"! 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

4 6

test issue #1625
by Scholger, Martina (martina.scholger＠uni-graz.at) 11 Feb '20

11 Feb '20

Hi all, does anyone have time to test this issue? https://github.com/TEIC/TEI/issues/1625. It would be great if we could close this issue. Thanks! Best, Martina

2 1

Documentation
by Hugh Cayless 11 Feb '20

11 Feb '20

Hi All, I've been looking at implementing a slightly more robust documentation-publishing scheme for things like TCWs using Travis to automatically publish stuff pushed to the Documentation repo on GitHub Pages (and maybe in future to the website as well). We moved the TCW (Technical Council Working papers) docs over to https://github.com/TEIC/Documentation, but there is also https://github.com/TEIC/TEI/tree/dev/Documents, and in fact some of the content at http://teic.github.io/TCW/ and https://github.com/TEIC/teic.github.io/tree/master/TCW comes from the latter. So not everything in the TCW directory is a TCW, nor is everything listed in our GitHub Pages TCW site from the TCW directory. In short, it's a shambles :-). I would like to organize all this in a more sensible and intuitive way. So I have questions: 1) What documents should we surface? There's a lot of stuff in the TEI/Documents folder that's old (obsolete? Of historical interest?). 2) Should we try to merge all the documentation? We moved the TCWs out of TEI for reasons that may no longer pertain. Or we could move all the stuff in TEI/Documents out into the Documentation repo. What do we think? Hugh

1 1

Council call in 15 minutes
by Scholger, Martina (martina.scholger＠uni-graz.at) 11 Feb '20

11 Feb '20

Dear all, our call starts in 15 minutes. Agenda: https://docs.google.com/document/d/1hlKcKJJqW-LV0_-Q3rZQJqBxXySk_fA8qEJWlAu… To join the video meeting, click this link: https://meet.google.com/qti-toyw-hek Best, Martina

1 0

no longer using sydb-standOff
by Syd Bauman 11 Feb '20

11 Feb '20

Jenkins and Travis maintainers -- You can remove the syd-standOff branch jobs from the CI servers at your leisure.

2 1

Nicholas -- where are you?
by Syd Bauman 10 Feb '20

10 Feb '20

Checking in, Nicholas -- is everything OK? Haven't heard from you in some time. If all is OK, please hurry up and accept the invitation to join the TEIC GitHub group. And get in touch so we can arrange orientation conversations.

3 4

release branch - tomorrow?
by Scholger, Martina (martina.scholger＠uni-graz.at) 10 Feb '20

10 Feb '20

Hi Elisa and Raff, I was just talking to Syd and we found some (small) issues in standOff and unihan that he will look into later today. Could you please wait with building the release branch until after our call tomorrow morning/afternoon? Best, Martina

2 1

release notes
by Scholger, Martina (martina.scholger＠uni-graz.at) 10 Feb '20

10 Feb '20

Dear Council, Please have a look at the release notes and feel free to add and modify. Please pay special attention to the standOff and uniHan issue. https://jenkins.tei-c.org/job/TEIP5-dev/lastSuccessfulBuild/artifact/P5/rel… Best, Martina

1 0

standoff
by Scholger, Martina (martina.scholger＠uni-graz.at) 08 Feb '20

08 Feb '20

Hi Syd, I am currently working on the release notes and found some things in standoff: 1. <standOff> is defined in the textstructure module but the fourth bullet point in textstructure says that it is defined in the linking module and refers to section 16.9.2 The standoff Container, see https://jenkins.tei-c.org/job/TEIP5-dev/lastSuccessfulBuild/artifact/P5/rel… 1. In the <standOff> spec * The description of an element in <desc> usually starts with a lower-case letter (functions as a container ...) * There should be a reference to the GLs in the element description, eg. to SA.html#SASOstdf Best, Martina

1 0

Refridge
by Scholger, Martina (martina.scholger＠uni-graz.at) 06 Feb '20

06 Feb '20

Dear Council, We are in the middle of the “refridge phase” which means that we are getting really busy 😊 Please don’t commit major changes to the schema (except if they have been tested in a branch like standoff and unihan); minor changes (wording, typos, examples) are fine. Freeze is on Monday, which means no more changes can be done in the dev branch after that. There are 35 open issues labeled with “milestone 3.7.0” https://github.com/TEIC/TEI/issues?q=is%3Aopen+is%3Aissue+milestone%3A%22Gu… Please remove the milestone from those issues, that won’t go into the upcoming release. Best, Martina

2 2

change in date of next Stylesheets meeting
by Syd Bauman 04 Feb '20

04 Feb '20

100% of the people at today's Stylehseets meeting cannot make the next scheduled date, Tue 03 Mar 20. Thus we would like to move it to Tue 17 Mar 20 (St. Patrick's Day). I have already changed it on the Google Calendar. (Didn't know I had that power! :-) But if there are objections ...

1 0

Stylesheets meeting?
by Raffaele Viglianti 04 Feb '20

04 Feb '20

Hi all, I see on the calendar that there's a stylesheets meeting tomorrow (Tues) at 9am EST, but haven't heard any concrete plans yet. Is it happening? Raff

4 4

time to merge in <standOff>, eh?
by Syd Bauman 03 Feb '20

03 Feb '20

With great thanks to Peter, Martin, and Martina the changes have been reviewed. I've addressed almost all the issues mentioned (still hoping someone can come up with better wording than "makes explicit the multiplicity of the collection"). Mr. Jenkins is happy with the sydb-standOff branch, and it builds fine locally on my machine here. (Not perfectly, but no worse than the dev branch.)-: So I think perhaps it is time to wrap in the sydb-standOff branch into dev, yes? Any objections?

3 2

F2F meeting location
by Scholger, Martina (martina.scholger＠uni-graz.at) 03 Feb '20

03 Feb '20

Dear all, We have three magnificent options for our F2F meeting and need to make a decision. Peter offered to host us in Paderborn, Nicolas in Oxford, and Magdalena in Warsaw. Thanks to all of you for your willingness to host us! Please fill in the (anonymous) doodle poll by Monday, Feb 3: https://doodle.com/poll/vpncpziivf4fcfn6 Best, Martina

1 1

Internationalization working group proposal
by Scholger, Martina (martina.scholger＠uni-graz.at) 03 Feb '20

03 Feb '20

Dear all, as discussed in our last call, we (the group who met at the Scholarly Communication Institute in Chapel Hill to discuss "TEI and internationalization") want to establish a working group on "Internationalization (I18n)". Please find our proposal in this google doc: https://docs.google.com/document/d/1EyAWLkKF5oBeueSoNaES3NGeA2f_AGLtn8Kx9hb… It would be great if we could get a "go ahead" from the Council members this week. In case of your approval, is there any other formality that we have to observe or could we consider it as an official charge then? Best, Martina

1 0