Hi Martin and Council,

first, many, many thanks for taking care of the Oxygen plugin! 
Not only this time, but the git history reveals that you’re the main contributor and maintainer of the oxygen plugin for several years now (I’d say at least since 2015!)
I wanted to put this out here to a) give credit where credit is due and b) to emphasize the structural dilemma we (the TEI community) are facing – a lot of services, tools, and infrastructure with a Hugh bus factor. I really don’t know what to do with this, but maybe someone on Council has an idea or an interest in diving into the oxygen plugin?


Regarding your second Stylesheets issue: I think this is a known bug and documented at https://github.com/TEIC/Stylesheets/issues/555. In addition to this, at the Stylesheets Group meeting on 2022-08-26 we even discussed deprecating epub(2) completely in favor of epub3: https://github.com/TEIC/Stylesheets/issues/576 
The epub3 transformation had this CSS issue as well but it was hacked around in https://github.com/TEIC/Stylesheets/issues/312; and https://github.com/TEIC/Stylesheets/pull/394 in particular. I think the underlying problem is the copying around of CSS files – as you said – in the Makefile. Yet, I’m a bit hesitant to change this because this will alter our release archive and finally the URLs of the released versions (because the structure of https://tei-c.org/Vault/Stylesheets/current/xml/tei/stylesheet/ is different than https://github.com/TEIC/Stylesheets/tree/released and has been of years – so people and software rely on it)

My proposal would be to not do anything for this release (because it’s too late for breaking changes) but strive for the deprecation of epub in favor of epub3 (for the next release). We would need to get in touch with the oxygen people to let them know about it (so they can switch their transformation as well).

Best
Peter 

Am 21.10.2022 um 20:20 schrieb Martin Holmes <mholmes@uvic.ca>:

Hi All,

Martina, Syd and I met this morning and made changes to the Oxygen plugin build to account for jar file changes in the latest Oxygen release. That seems to have worked, in that the bleeding-edge plugin built successfully on Jenkins, we were able to install it on both Oxygen 24.1 and 25, and it mostly works. The build of the stable plugin, which I ran manually on my Jenkins server, also seems to have been successful, but we haven't tested that.

I say mostly because we found two different issues which are not directly related to the plugin, and which were broken in previous versions of it.

One is that the ODD-to-PDF build fails with an out-of-memory error when transforming tei_all. It's possible that the Oxygen folks have kept it working in their version of the framework by adding additional memory to the transformation, but I can't see how they're doing that, if they are. Anyway, the same transformation works OK for tei_lite.odd, so I don't think this is a major issue.

A more serious problem is that the epub transformation fails because a handful of CSS files are in the wrong place relative to how the transformation runs. If you look at the Makefile in the Stylesheets, you can see that it copies CSS files to a second location where the transformation is expecting to find them (a line added to the file by Sebastian in 2014). However, the framework/plugin does not use the Makefile, so that step never happens, and the build fails. The Oxygen folks have fixed this in their version of the framework by patching our XSLT to point to the files where they actually are. That seems sensible to me, and I think what we actually have is a bug in the Stylesheets, where relative paths are used to point to things and not resolved against a solid location, so running the same transformation in different ways expects to find the same files in two different places. The Makefile solution of making copies of them seems a bit like a hack to me.

If you are subscribed to the bleeding-edge plugin, you should get updates, and if you make use of it over the next few days and have any problems, do raise an issue on the oxygen-tei repo.

I think it would be prudent to fix the Stylesheets bug before the next TEI / Stylesheets release, because a new "stable" version of the plugin will be released at that time, but the bug has been there for a while so it's not crucial.

Cheers,
Martin


--
------------------------------------------
Martin Holmes
UVic Humanities Computing and Media Centre

I acknowledge and respect the lək̓ʷəŋən peoples on whose traditional territory the university stands and the Songhees, Esquimalt and WSÁNEĆ peoples whose historical relationships with the land continue to this day.
_______________________________________________
Tei-council mailing list
Tei-council@lists.tei-c.org
http://lists.lists.tei-c.org/mailman/listinfo/tei-council