How to use CETEIcean server-side (if possible)?

[kibin-app]

How to use CETEIcean server-side (if possible)?

[raffazizzi]

Hello @kibin-app thanks for your question! I think the Server Side Rendering comment you quoted is somewhat misleading because in order to define the Custom Elements, window needs to be available (see define()). However, that process only needs to happen on the client side.

In order to implement SSR, it's helpful to think of CETEIcean as performing three main tasks:

• transforming the TEI source data into tei- prefixed elements with the addition of some helpful data- attributes to avoid data loss. This is handled by makeHTML5()
• register the transformed elements as Custom Elements, handled by define()
• apply behaviors

The last two tasks need to happen in the client and will require window. But the first task can be done server side. The example XSLT included in the repository, for example, takes care of that. In short, you would have to implement that code on your own.

There is an example of this in the wild: I adapted CETEIcean code to work with Gatsby specifically to take advantage of SSR, but also for being able to use React components instead of behaviors. You can find the code and some docs at https://github.com/raffazizzi/gatsby-transformer-ceteicean . It performs the required transformation step I mentioned above and allows users to queue further transformations if they need them. Feel free to open issues there if you have questions about that code.

This transformer has a companion Gatsby "theme" that performs the other two steps on the client: register the Custom Elements and route React components to handle behaviors. The code is here: https://github.com/raffazizzi/gatsby-theme-ceteicean

I hope this helps!

[kibin-app]

Thank you for the swift reply and the example! That does help a lot indeed. I'll debate with myself if it's worth the extra mile or just leave it on the client side.