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

how to specify params
by Syd Bauman 10 Nov '17

10 Nov '17

I'm working on a TEI to HTML conversion using the TEI Stylesheets. The recommended method for doing this (I'm told) is to issue $ /path/to/Stylesheets/bin/teitohtml /path/to/INPUT.xml But I do not know how to specify parameters using this mechanism, or if I even can do so. It ends up issuing $ ant -q -Djava.awt.headless=true -f /path/to/Stylesheets/html/build-to.xml -lib /path/to/Stylesheets/lib/saxon9he.jar -Dodd=false -Dsaxon.jar=/path/to/Stylesheets/lib/saxon9he.jar -Dtrang.jar=/path/to/Stylesheets/lib/trang.jar -Dverbose=false -DinputFile=/tmp/INPUT.xml -DoutputFile=/tmp/INPUT.xml.html -Dprofiledir=/path/to/Stylesheets/profiles -Dprofile=default -Dpublisher= -Duid= -DselectedSchema= -Dlang=en -Dsubject= -Dcoverimage= -Doxygenlib=/usr/share/oxygen/lib And the ant build file Stylesheets/html/build-to.xml defines a teitohtml macro that uses (I think) Stylesheets/profiles/tei/ html/to.xsl. So It looks to me like I would have to add <param> elements to common/teianttasks.xml within the definition of the "buildhtml" macro. That doesn't strike me as nearly as user friendly as just specifying 'em on the `saxon` commandline: $ cd /path/to/Stylesheets/ $ saxon -xsl:profiles/tei/html/to.xsl -s:/path/to/INPUT.xml showTitleAuthor=true > /path/to/OUTPUT.html At least, I think that's the right way to do so (setting 1 para, "showTitleAuthor"). I can, of course, do this in oXygen, but the reason I wanted to do it on the commandline was to test a bug I was getting in oXygen. (Ticket https://github.com/TEIC/Stylesheets/issues/293.)

2 1

TEI Stylesheets Restored (whew!)
by Elisa Beshero-Bondar 10 Nov '17

10 Nov '17

Dear Council— I am relieved to report that GitHub Support promptly restored our Stylesheets repo, Issues and all(!) I’m forwarding their message. Meanwhile, I’m taking this as an extreme note of caution about working with forks—I consider myself a pretty experienced GitHub user, and that happened a little too fast and easily for comfort. Elisa -- 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/> > Begin forwarded message: > > From: "lesley (GitHub Staff)" <support(a)github.com> > Subject: Re: help! Deleted a repo origin when I meant to delete my own fork > Date: November 2, 2017 at 12:35:47 AM EDT > To: Elisa Beshero-Bondar <ebbondar(a)gmail.com> > > Hi Elisa, > > Repository deletions from our servers are processed quite promptly, but luckily in this instance your repository was still available for recovery. Please bear in mind that this will not always be the case. > > I've gone ahead and processed the restore for you, so you should see your repository reappear shortly; > > https://github.com/TEIC/Stylesheets <https://github.com/TEIC/Stylesheets> > Let me know if you need anything else! > > All the best, > Lesley > GitHub Support > > I was attempting to delete my fork of the TEI Stylesheets repository, located at https://github.com/TEIC/Stylesheets/ <https://github.com/TEIC/Stylesheets/> , but I deleted the remote origin instead! This is terrible because the TEI community depends on this repo, and we need to restore it ASAP. The repository is years old and has issues on it that we rely on track and correct TEI code. We need to restore the entire repository as it was prior to my deleting it--around 11:30pm EST on November 1, 2017. >

5 12

OxGarage Docker Image
by Peter Stadler 09 Nov '17

09 Nov '17

Hi *, just to let you know, that I’m currently working on a Docker image for OxGarage (for better testing, debugging and deployment purposes). I think I’m almost there and would welcome some feedback/testing. There is no image available at Docker Hub yet, but you can build it from https://github.com/peterstadler/oxgarage-docker Cheers Peter PS: A known issue is the transformation to PDF where the output consists of boxes and digits only. Probably there is a font missing in the image?

3 3

naming odd4odds when it's in Exemplars/
by Syd Bauman 07 Nov '17

07 Nov '17

In Prague we agreed that odd4odds should be put into Exemplars/ and thus the oXygen framework, and that I should have that ready by the conference (on which I'm giving a talk on it). IIRC we decided to call it "tei_customization.odd" (and thus .rng, .rnc, etc.). I was recently reminding Martin of this schema and the differences between it and tei_odds, and he wondered aloud if we shouldn't think of tei_customization as a schema to use when creating a TEI customization that is a profile of, or subset of, or constraint of the TEI. (I.e., the set of documents that conform to the customized TEI is a proper subset of the set of documents that conform to tei_all.) And that we think of tei_odds as a schema to use when creating a TEI customization that is an extension of the TEI. That might mean renaming them to tei_customization_extension and tei_subset_customization or some such. Thoughts? (Remember that the present problem we are worrying about is how to explain to the oXygen user the difference between the two. If I understand correctly, we only get to present the user with the name of the thing, no pop-up or mouse-over gloss available. However, we do get to put comments in the template. :-)

2 1

dreaded conflicting ID types
by Syd Bauman 06 Nov '17

06 Nov '17

The odd4odds RELAX NG schema (soon to be tei_customization.rng in Exemplars/ unless someone comes up with a better name) is itself invalid when ID/IDREF checking is on (in oXygen), or the '-i' switch is not present (using `jing`). This, of course, would break the build process unless we special-case it. And, as you can see in the documentation for the schema, this has been a well-known situation for this schema for a long time. The current version is not readily available, as I am working on it. The version of the schema[1] and the documentation[2] that I showed in Prague are still easily available. Here are the error messages I'm getting from `jing` (w/o '-i') from that version of the schema, re-written a bit for readability: | 877:16: error: conflicting ID-types for "@xml:id" of <tei:sequence> | 1057:14: error: conflicting ID-types for "@defaultPhase" of <sch:schema> | 1037:14: error: conflicting ID-types for "@defaultPhase" of <sch:schema> | 1085:14: error: conflicting ID-types for "@defaultPhase" of <sch:schema> | 1016:14 error: conflicting ID-types for "@defaultPhase" of <sch:schema> Of course, if we fix the latter 4 messages by making @defaultPhase NCName instead of IDREF, something else crops up instead (@id of <sch:rule>), as the errors are not from the Schematron declarations, really, but rather from our definitions of "anyElement-xenoData", "anyElement-egXML", "anyElement-content", and "anyElement-datatype". (The first error is from the definition of "sch_foreign-element".) Excluding elements from the Schematron and TEI namespaces form all of these macros fixes this problem. But of course, that's not OK. You might very well want TEI elements inside your Schematron assertions, and you might very well want to give example code of Schematron in your <egXML>. Besides, it would require altering the Schematron schema, which rubs me the wrong way. Before I go special-casing this particular schema in the build process (so it is validated w/ '-i', as all should be in my opinion) I wanted to know if there are any other solutions I'm missing. Notes ----- [1] http://www.wwp.neu.edu/outreach/seminars/_current/handouts/ODD_exercise_sup… [2] http://www.wwp.neu.edu/outreach/seminars/_current/handouts/ODD_exercise_sup…

1 0

co-operative stylesheet education session #13, take 2
by Syd Bauman 02 Nov '17

02 Nov '17

[I sent this last night at 22:12Z, but have reports that no one received it.] Ack! Sorry I've fallen down. Actually I didn't fall down, but my entire digital life fell down around me.[1] I believe we are scheduled for tomorrow Thu 11-02 13:00Z, i.e.: * 06:00 PDT * 09:00 EDT * 13:00 BST <== different than last meeting * 14:00 CEST <== different than last meeting Not surprisingly, I did not get a chance to do as much set-up work as I would have hoped. But I did chat w/ Martin and pop a request off to Elisa. So I'm hoping that our main topic will be a discussion led by Elisa of where & how to fix Stylesheets ticket 286, <ref> inside <listRef>.[2] I'm also hoping to devote 5 mins (certainly no more than 10) to the goals and purpose of the group. At last Council conference call a week ago, it was implied that the group is actually a Council sub-group or work-group that goes about fixing Stylesheets tickets. I bristled at this and said on the record that it is not a work-group and is tasked not with fixing problems but rather with providing a framework for co-operative self-education about the Stylesheets and how they work. That said, I'm perfectly happy to morph this into a Stylesheets task force (the words "mission impossible" jump to mind :-) that *is* actually where and how Council works on the Stylesheets. But I *don't* want that to happen by accident; I want us to purposefully decide we're happy with the role change (or not). If that all goes quickly, other tickets we may wish to poke at, in numerical (not intelligent) order: * 219 * 220 * 247 * 281 Notes ----- [1] On Fri night 10-27 my e-mail account was compromised, including all e-mail being "deleted" on arrival. (In quotes because MS365 e-mail system does not really deleted it, just moves it to a folder called "Deleted".) I did not notice until Sun afternoon 10-29. After I noticed something was wrong, but before I did anything about it (other than change my password, of course), we lost power due to the storm. Power was restored yesterday, Tue evening 10-31. I had a lot of post-power failure work to do (setting clocks, going through food in fridge, etc.), and had dinner, so did not get to my e-mail until late last night. When I sat down to work on e-mail I discovered our cable connection (which is both TV and internet at my house) was down. Note that my wife was watching TV while I ate dinner, so it had been up a mere hour or so before. Anyway, I checked the TV and it had a message that implied they would probably have it fixed "shortly", but I did not wait, I just went to bed. When I finally got to my e-mail today there were 693 pieces of e-mail waiting for me to sift through. [2] https://github.com/TEIC/Stylesheets/issues/286

1 0

Stylesheets repo
by Elisa Beshero-Bondar 02 Nov '17

02 Nov '17

Council— In preparing for tomorrow morning’s Stylesheets meeting, I was preparing to commit some changes to odd2odds.xsl on my fork. I noticed my fork had some old commits on it that I didn’t want to send with a pull request (old practice code I wrote, not useful to us), so I decided to destroy my fork and create a new one. The problem was—I went online to do it, thought I was accessing my forked origin to delete—I was on the wrong page. Evidently I deleted the remote origin repo because I can’t access it any more (and presumably no one can). I immediately wrote for help to GitHub support to try to restore our Stylesheets repo as it was at 11:30pm EST on November 1. I’m waiting to hear from them, but in the meantime, I wonder if we have a full copy of the repo with the issues. I am hoping that this is known territory to someone among us, that the good people at GitHub can help, that I haven’t destroyed everything! I am reasonably confident we can put the files back as they were tonight—I have them pulled in locally anyway. I am anxious about the tickets, and extremely upset. Anyway, you all need to know what just happened, and I hope we can repair it. It hardly bears mentioning that I think I have a fix for the issue we’re to discuss tomorrow. We need the Stylesheets repo! Elisa, worried sick and anxiously awaiting word from GitHub. -- 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/>

1 1

co-operative stylesheet education session #13
by Syd Bauman 01 Nov '17

01 Nov '17

Ack! Sorry I've fallen down. Actually I didn't fall down, but my entire digital life fell down around me.[1] I believe we are scheduled for tomorrow Thu 11-02 13:00Z, i.e.: * 06:00 PDT * 09:00 EDT * 13:00 BST <== different than last meeting * 14:00 CEST <== different than last meeting Not surprisingly, I did not get a chance to do as much set-up work as I would have hoped. But I did chat w/ Martin and pop a request off to Elisa. So I'm hoping that our main topic will be a discussion led by Elisa of where & how to fix Stylesheets ticket 286, <ref> inside <listRef>.[2] I'm also hoping to devote 5 mins (certainly no more than 10) to the goals and purpose of the group. At last Council conference call a week ago, it was implied that the group is actually a Council sub-group or work-group that goes about fixing Stylesheets tickets. I bristled at this and said on the record that it is not a work-group and is tasked not with fixing problems but rather with providing a framework for co-operative self-education about the Stylesheets and how they work. That said, I'm perfectly happy to morph this into a Stylesheets task force (the words "mission impossible" jump to mind :-) that *is* actually where and how Council works on the Stylesheets. But I *don't* want that to happen by accident; I want us to purposefully decide we're happy with the role change (or not). If that all goes quickly, other tickets we may wish to poke at, in numerical (not intelligent) order: * 219 * 220 * 247 * 281 Notes ----- [1] On Fri night 10-27 my e-mail account was compromised, including all e-mail being "deleted" on arrival. (In quotes because MS365 e-mail system does not really deleted it, just moves it to a folder called "Deleted".) I did not notice until Sun afternoon 10-29. After I noticed something was wrong, but before I did anything about it (other than change my password, of course), we lost power due to the storm. Power was restored yesterday, Tue evening 10-31. I had a lot of post-power failure work to do (setting clocks, going through food in fridge, etc.), and had dinner, so did not get to my e-mail until late last night. When I sat down to work on e-mail I discovered our cable connection (which is both TV and internet at my house) was down. Note that my wife was watching TV while I ate dinner, so it had been up a mere hour or so before. Anyway, I checked the TV and it had a message that implied they would probably have it fixed "shortly", but I did not wait, I just went to bed. When I finally got to my e-mail today there were 693 pieces of e-mail waiting for me to sift through. [2] https://github.com/TEIC/Stylesheets/issues/286

1 0

Jenkins build became unstable: TEIP5-Test-dev #3442
by Victoria TEI Jenkins 31 Oct '17

31 Oct '17

See <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Test-dev/3442/display/redirect?pag…>

1 3

Build failed in Jenkins: TEIP5-Documentation-dev #2631
by Victoria TEI Jenkins 31 Oct '17

31 Oct '17

See <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/2631/display/red…> Changes: [philomousos] Upgrading to Saxon 9.8.0.5. ------------------------------------------ Started by upstream project "TEIP5-Test-dev" build number 3442 originally caused by: Started by an SCM change Building in workspace <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/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 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 e1c281f1a19916b5d145a261ddc0440338a79da5 (refs/remotes/origin/dev) > git config core.sparsecheckout # timeout=10 > git checkout -f e1c281f1a19916b5d145a261ddc0440338a79da5 > git rev-list ceb830c444b3600431d8dd4552f97a1004112f8d # timeout=10 [workspace] $ /bin/bash -xe /tmp/jenkins3587607126152272292.sh + svn update Skipped '.' Summary of conflicts: Skipped paths: 1 [workspace] $ /bin/bash -xe /tmp/jenkins8783435204624508338.sh + cd P5 ++ pwd + make VCS=git INJENKINS=true XSL=<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/ws/P5/../../../S…> clean html-web epub3 Guidelines.pdf (cd Exemplars; make clean) make[1]: Entering directory `<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/ws/P5/Exemplars'> mv tei_lite_fr.nvdl tei_lite_fr.nvdl.bak rm -f *.processed *.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-Documentation-dev/ws/P5/Exemplars'> (cd Test; make clean) make[1]: Entering directory `<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/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-Documentation-dev/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-Documentation-dev/ws/P5/../../../S…> -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-Documentation-dev/ws/P5/../../../S…> for XSL stylesheets [echo] Do ODD processing for p5odds.odd [echo] Do ODD processing for p5odds-examples.odd BUILD SUCCESSFUL Total time: 1 minute 52 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: Making HTML Guidelines for language en rm -rf Guidelines-web perl -p -e \ "s+http://www.tei-c.org/release/xml/tei/stylesheet+<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/ws/P5/../../../S…;> \ s+/usr/share/xml/tei/stylesheet+<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/ws/P5/../../../S…;"> \ Utilities/guidelines.xsl.model > Utilities/guidelines.xsl if [ -n ] ; then curl -s http://www.tei-c.org/index.xml | sed 's/content="text\/html"/content="text\/html; charset=utf-8"/' | xmllint --html --noent --dropdtd --xmlout - > Utilities/teic-index.xml;fi for i in en ;do \ mkdir -p Guidelines-web/$i/html; \ cp odd.css guidelines.css guidelines-print.css Guidelines-web/$i/html; \ (cd Source/Guidelines/en; tar --exclude .svn -c -f - Images) | (cd Guidelines-web/$i/html; tar xf - );\ (cd webnav; tar --exclude .svn -c -f - .) | (cd Guidelines-web/$i/html; tar xf - ); \ done echo '<project basedir="." default="html" name="buildweb"><import file="antbuildweb.xml"/><target name="html">' \ > buildweb.xml for i in en ;do \ echo "<buildweb lang=\"$i\"/>" >> buildweb.xml; \ done echo '</target></project>' >> buildweb.xml ANT_OPTS="-Xss2m -Xmx752m -Djava.awt.headless=true" ant -q -lib Utilities/lib/jing.jar:Utilities/lib/saxon9he.jar -f buildweb.xml -DgoogleAnalytics= [echo] Make Guidelines web pages for language en BUILD SUCCESSFUL Total time: 2 minutes 3 seconds # commented out for DEBUGing: rm -f buildweb.xml Utilities/teic-index.xml touch html-web.stamp ANT_OPTS="-Xss2m -Xmx752m -Djava.awt.headless=true" ant -q -f <http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/ws/P5/../../../S…> -lib Utilities/lib/saxon9he.jar -Dprofiledir=<http://teijenkins.hcmc.uvic.ca/job/TEIP5-Documentation-dev/ws/P5/../../../S…> -Dprofile=tei -DinputFile=`pwd`/p5.xml -DoutputFile=`pwd`/Guidelines.epub -Dcoverimage=`pwd`/Utilities/cover.jpg BUILD SUCCESSFUL Total time: 1 minute 17 seconds java -jar Utilities/epubcheck3.jar Guidelines.epub Epubcheck Version 3.0.1 Validating against EPUB version 3.0 java.lang.NoClassDefFoundError: net/sf/saxon/TransformerFactoryImpl at com.adobe.epubcheck.xml.XMLValidator.<init>(XMLValidator.java:203) at com.adobe.epubcheck.opf.OPFChecker.<init>(OPFChecker.java:62) at com.adobe.epubcheck.opf.OPFChecker30.<init>(OPFChecker30.java:59) at com.adobe.epubcheck.ocf.OCFChecker.runChecks(OCFChecker.java:234) at com.adobe.epubcheck.api.EpubCheck.validate(EpubCheck.java:207) at com.adobe.epubcheck.tool.Checker.validateFile(Checker.java:172) at com.adobe.epubcheck.tool.Checker.run(Checker.java:255) at com.adobe.epubcheck.tool.Checker.main(Checker.java:182) Caused by: java.lang.ClassNotFoundException: net.sf.saxon.TransformerFactoryImpl at java.net.URLClassLoader.findClass(URLClassLoader.java:381) at java.lang.ClassLoader.loadClass(ClassLoader.java:424) at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:335) at java.lang.ClassLoader.loadClass(ClassLoader.java:357) ... 8 more make: *** [epub3] Error 1 Build step 'Execute shell' marked build as failure Not sending mail to unregistered user philomousos(a)gmail.com

1 2