co-operative stylesheet education session #2
Reminder: we are scheduled to meet at 17:00Z today, Tue 10-18. That's 10:00 in Vancouver, 13:00 in New York, 18:00 in London, and 19:00 in Vienna. A few hours ago my sister found her husband dead. So I may not be at our meeting, and if I do I will be in less than optimal surroundings and w/o any preparation. Someone else should set up the Google Hangout. (Or we should use Skype, and someone else should set that up. :-)
Hi all, We have a speaker coming to MITH today and I forgot that I'm supposed to join him for lunch. Sorry to miss this again... Raff On Tue, Oct 18, 2016 at 2:09 AM, <> wrote:
Reminder: we are scheduled to meet at 17:00Z today, Tue 10-18. That's 10:00 in Vancouver, 13:00 in New York, 18:00 in London, and 19:00 in Vienna.
A few hours ago my sister found her husband dead. So I may not be at our meeting, and if I do I will be in less than optimal surroundings and w/o any preparation. Someone else should set up the Google Hangout. (Or we should use Skype, and someone else should set that up. :-) -- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
Sorry to say that I can't be there later today either. :-( -J On 18/10/16 14:54, Raffaele Viglianti wrote:
Hi all,
We have a speaker coming to MITH today and I forgot that I'm supposed to join him for lunch. Sorry to miss this again...
Raff
On Tue, Oct 18, 2016 at 2:09 AM, <> wrote:
Reminder: we are scheduled to meet at 17:00Z today, Tue 10-18. That's 10:00 in Vancouver, 13:00 in New York, 18:00 in London, and 19:00 in Vienna.
A few hours ago my sister found her husband dead. So I may not be at our meeting, and if I do I will be in less than optimal surroundings and w/o any preparation. Someone else should set up the Google Hangout. (Or we should use Skype, and someone else should set that up. :-) -- tei-council mailing list tei-council@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@it.ox.ac.uk Academic IT Services, University of Oxford
This means that we don't have: Elisa Syd (probably) Raff James Do we think it's worth going ahead? Cheers, Martin On 2016-10-18 07:08 AM, James Cummings wrote:
Sorry to say that I can't be there later today either. :-(
-J
On 18/10/16 14:54, Raffaele Viglianti wrote:
Hi all,
We have a speaker coming to MITH today and I forgot that I'm supposed to join him for lunch. Sorry to miss this again...
Raff
On Tue, Oct 18, 2016 at 2:09 AM, <> wrote:
Reminder: we are scheduled to meet at 17:00Z today, Tue 10-18. That's 10:00 in Vancouver, 13:00 in New York, 18:00 in London, and 19:00 in Vienna.
A few hours ago my sister found her husband dead. So I may not be at our meeting, and if I do I will be in less than optimal surroundings and w/o any preparation. Someone else should set up the Google Hangout. (Or we should use Skype, and someone else should set that up. :-) -- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
I think we should reschedule.
Syd: so sorry to hear about your brother-in-law.
Hugh
On Tue, Oct 18, 2016 at 12:00 PM, Martin Holmes
This means that we don't have:
Elisa Syd (probably) Raff James
Do we think it's worth going ahead?
Cheers, Martin
On 2016-10-18 07:08 AM, James Cummings wrote:
Sorry to say that I can't be there later today either. :-(
-J
On 18/10/16 14:54, Raffaele Viglianti wrote:
Hi all,
We have a speaker coming to MITH today and I forgot that I'm supposed to join him for lunch. Sorry to miss this again...
Raff
On Tue, Oct 18, 2016 at 2:09 AM, <> wrote:
Reminder: we are scheduled to meet at 17:00Z today, Tue 10-18.
That's 10:00 in Vancouver, 13:00 in New York, 18:00 in London, and 19:00 in Vienna.
A few hours ago my sister found her husband dead. So I may not be at our meeting, and if I do I will be in less than optimal surroundings and w/o any preparation. Someone else should set up the Google Hangout. (Or we should use Skype, and someone else should set that up. :-) -- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
--
tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
Syd— A bunch of us are online now on Google Hangouts (Martin, Lou, Martina, Peter, and me)—and you’re *not* there…Can you log into Hangouts and join the call?—Elisa
On Oct 18, 2016, at 1:02 PM, Syd Bauman <> wrote:
Well, I'm here, and happy to either re-schedule (as apparently wee are) or not.
I think we should reschedule. Syd: so sorry to hear about your brother-in-law. -- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
Syd— A bunch of us are online now on Google Hangouts (Martin, Lou, Martina, Peter, and me)—and you’re *not* there…Can you log into Hangouts and join the call?—Elisa
Sorry, not any more. (I waited until 18 past, then gave up and left.)
Apologies. I got pulled into a last minute meeting. Hope it was productive!
On Tue, Oct 18, 2016 at 1:32 PM, Elisa Beshero-Bondar
Syd— A bunch of us are online now on Google Hangouts (Martin, Lou, Martina, Peter, and me)—and you’re *not* there…Can you log into Hangouts and join the call?—Elisa
On Oct 18, 2016, at 1:02 PM, Syd Bauman <> wrote:
Well, I'm here, and happy to either re-schedule (as apparently wee are) or not.
I think we should reschedule. Syd: so sorry to hear about your brother-in-law. -- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
-- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
Hi all, [I don't have permission to post to the Council list, so could someone on Council copy this to the list? Also please add any clarifications if you were present for the meeting; this is from memory, not from notes.] Today's session was a bit disorganized because our Great Leader Syd was unavoidably absent, but we did have some useful discussion. These are some things we managed to clarify: We explained the difference between calling the command-line scripts (bin/teitohtml5, bin/teitoodt) and directly calling the actual ant build files which do the real work (html5/build-to.xsl, odt/build-from.xml). We established that while the scripts are appropriate for most simple use-cases, they can result in confusion when the actual transformation you need to do is not served exactly by a script; then you need to call the ant task with the appropriate parameters, and that can be quite tricky to figure out. We established that when ODDs are converted to documentation, there is an intermediate conversion to TEI Lite, from which the documentation output is then generated. This puts TEI Lite at the centre of a range of different core processes, meaning that its maintenance remains crucial for the TEI infrastructure. We established that the transformations in the Oxygen TEI Framework are of course based on the ant tasks rather than the scripts, and that it would probably be a good idea for us to create detailed documentation for each of those tasks and their parameters. Peter (IIRC) pointed out at least one case where what Oxygen is doing is not what you would expect, and that might be a bug that should be raised on the oxygen-tei repo. [Peter, what were the details of this?] Lou pointed out that the bug which he reported here: https://github.com/TEIC/TEI/issues/1501 is urgent and release-blocking; since it looks like a Stylesheets bug to me, I raised a parallel issue: https://github.com/TEIC/Stylesheets/issues/176 but if it turns out to be a bug in oxygen-tei, then we should move it there. Lou understands exactly what the problem is here, so he will clarify it in as much detail as possible, so we can all look through the relevant code and see if we arrive at the same understanding before proposing a fix. This is the task we want to be working on between now and the next session: if we can agree on a fix, and implement it before the meeting, we can talk everyone through what we ended up doing, learning a lot in the process. Finally, we looked briefly at this bug: https://github.com/TEIC/Stylesheets/issues/176 which Syd and I raised recently, and for which we are moving towards a possible solution. This I think should also be release-blocking, so it should be fixed soon (Peter pointed out that we're approaching a release in December and such changes shouldn't be made in the dev branch close to the release). Cheers, Martin On 2016-10-18 07:08 AM, James Cummings wrote:
Sorry to say that I can't be there later today either. :-(
-J
On 18/10/16 14:54, Raffaele Viglianti wrote:
Hi all,
We have a speaker coming to MITH today and I forgot that I'm supposed to join him for lunch. Sorry to miss this again...
Raff
On Tue, Oct 18, 2016 at 2:09 AM, <> wrote:
Reminder: we are scheduled to meet at 17:00Z today, Tue 10-18. That's 10:00 in Vancouver, 13:00 in New York, 18:00 in London, and 19:00 in Vienna.
A few hours ago my sister found her husband dead. So I may not be at our meeting, and if I do I will be in less than optimal surroundings and w/o any preparation. Someone else should set up the Google Hangout. (Or we should use Skype, and someone else should set that up. :-) -- tei-council mailing list tei-council@lists.tei-c.org http://lists.lists.tei-c.org/mailman/listinfo/tei-council
PLEASE NOTE: postings to this list are publicly archived
Hi Martin, thanks for the minutes! I’ll add some comments inline.
Am 18.10.2016 um 20:24 schrieb Martin Holmes
: Hi all,
[I don't have permission to post to the Council list, so could someone on Council copy this to the list? Also please add any clarifications if you were present for the meeting; this is from memory, not from notes.]
Today's session was a bit disorganized because our Great Leader Syd was unavoidably absent, but we did have some useful discussion. These are some things we managed to clarify:
We explained the difference between calling the command-line scripts (bin/teitohtml5, bin/teitoodt) and directly calling the actual ant build files which do the real work (html5/build-to.xsl, odt/build-from.xml).
We established that while the scripts are appropriate for most simple use-cases, they can result in confusion when the actual transformation you need to do is not served exactly by a script; then you need to call the ant task with the appropriate parameters, and that can be quite tricky to figure out.
We established that when ODDs are converted to documentation, there is an intermediate conversion to TEI Lite, from which the documentation output is then generated. This puts TEI Lite at the centre of a range of different core processes, meaning that its maintenance remains crucial for the TEI infrastructure.
We established that the transformations in the Oxygen TEI Framework are of course based on the ant tasks rather than the scripts, and that it would probably be a good idea for us to create detailed documentation for each of those tasks and their parameters. Peter (IIRC) pointed out at least one case where what Oxygen is doing is not what you would expect, and that might be a bug that should be raised on the oxygen-tei repo. [Peter, what were the details of this?] I was referring back to https://github.com/TEIC/Stylesheets/issues/161 which I thought was a parameter issue rather than a Stylesheets bug. I understood from the discussion that for people running teitohtml it worked while for people running the oXygen transformation scenario „TEI ODD to XHTML“ it didn’t. And the magic key was the ‚--odd‘ flag. Now, I was trying to reproduce this and I couldn’t. teitohtml --odd --profile=tei teitohtml5 --odd --profile=tei teitohtml --odd teitohtml … all produced the wrong output, i.e. the merged paragraphs <p>aaa</p><p>bbb</p> —> aaabbb. NB: I tried with an older version of the Stylesheets, since Martin already committed a fix.
Lou pointed out that the bug which he reported here:
https://github.com/TEIC/TEI/issues/1501
is urgent and release-blocking; since it looks like a Stylesheets bug to me, I raised a parallel issue:
https://github.com/TEIC/Stylesheets/issues/176 That should be https://github.com/TEIC/Stylesheets/issues/180
but if it turns out to be a bug in oxygen-tei, then we should move it there. Lou understands exactly what the problem is here, so he will clarify it in as much detail as possible, so we can all look through the relevant code and see if we arrive at the same understanding before proposing a fix. This is the task we want to be working on between now and the next session: if we can agree on a fix, and implement it before the meeting, we can talk everyone through what we ended up doing, learning a lot in the process.
Finally, we looked briefly at this bug:
https://github.com/TEIC/Stylesheets/issues/176
which Syd and I raised recently, and for which we are moving towards a possible solution. This I think should also be release-blocking, so it should be fixed soon (Peter pointed out that we're approaching a release in December and such changes shouldn't be made in the dev branch close to the release). Sorry, I misunderstood. #176 is definitely release blocking and should be fixed in the dev branch. I was looking at https://github.com/TEIC/Stylesheets/issues/178 which I’d not classify as crucial – hence my suggestion to postpone this until after the release or doing it in a branch.
Thanks again and all the best Peter
participants (7)
-
Elisa Beshero-Bondar
-
Hugh Cayless
-
James Cummings
-
Martin Holmes
-
Peter Stadler
-
Raffaele Viglianti
-
Syd Bauman