https://github.com/bcdh/tei-strip-and-include
A quick and dirty workaround for including TEI fragments with xi:include into <egXML>
https://github.com/bcdh/tei-strip-and-include
Last synced: 3 months ago
JSON representation
A quick and dirty workaround for including TEI fragments with xi:include into <egXML>
- Host: GitHub
- URL: https://github.com/bcdh/tei-strip-and-include
- Owner: BCDH
- Created: 2019-10-05T17:26:20.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2019-10-05T18:32:53.000Z (over 6 years ago)
- Last Synced: 2025-10-28T16:48:28.069Z (7 months ago)
- Language: HTML
- Size: 105 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TEI Strip and Include Examples
TEI uses `` in a separate namespace (`http://www.tei-c.org/ns/Examples`) for encoding XML fragments demonstrating the use of some XML, in which the egXML element functions as the root element.
I was driven on the brink of insanity by the fact that the content of `` cannot include any other namespace including `http://www.tei-c.org/ns/1.0`. Because of this restriction, it is impossible to xi:include fragments from a separate TEI file.
Not being able to validate or reuse one's examples is a total pain in the neck, especially in longer documents.
You can use my quick and dirty workaround, as illustrated by this repo:
- open the oXygen project file `TEI-strinp-and-include-examples.xpr`
- use `examples.xml` to store and validate all your TEI examples
- associate this file with an XSLT transformation scenario (in the attached oXygen project `TEI-ns-stripper`) which uses the provided `tei-stripper.xsl`
- every time you add and validate some new TEI content in `examples.xml`, run the `TEI-ns-stripper` scenario. It will create a file called `examples-stripped.xml`, which will be exactly the same as your original `example.xml`, but it will artificially put the TEI root element in the `http://www.tei-c.org/ns/Examples` namespace, making it legit for inclusion in ``
- to include TEI fragments in a TEI document (in this repo, `call4examples.xml`), use `xi:include` to include from `examples-stripped.xml` as opposed to `examples.xml`, like this:
```xml
```
- The included fragments will now be in the same namespace as `` which means that your `call4examples.xml` file will not cause any validation errors, but your included (and potentially reusable) fragments will be the same as those that you validated im `examples.xml`.
Of course, if there is an easier way to do all this, I'd be thrilled to learn about it.
This is something that should have been considered when deciding on ``. Creating fake TEI files in the wrong namespace is not what I consider best practice.
