======================== The EOA document model ======================== The schema, documented and maintained in https://github.molgen.mpg.de/EditionOpenAccess/eoa-publication-model/blob/master/schema/resource/eoa-tei-strict.rnc is the central point for what is allowed and what not in the whole EOA infrastructure with regards to the publications. The model itself has its roots in the original specification of EOATeX and has been codified as a Relax NG schema for TEI documents. Making changes to the schema ============================ New publications might make it necessary to expand the model in one way or another. Recent additions were as big as the inclusion of Hyperimage (https://mprl-series.mpg.de/studies/12/) linkings between original text and its translation (https://edition-open-sources.org/sources/13) or adding an asterisk to separate sections in a chapter, rather than using section titles (https://mprl-series.mpg.de/studies/14). These changes need to be carried through the whole toolchain, because they need to be integrated into the whole document conversion workflow. Example: asterisk as section marker =================================== Exemplified by the commits in the source code this shows how the changes to schema and workflow are done: Change the schema ----------------- This commit (https://github.molgen.mpg.de/EditionOpenAccess/eoa-publication-model/commit/03947a5594dfba1b224dbbd0a6d4b4ae3b3f2182) shows how the schema is expanded. Since the divider can occur in either chapter or section, it needs to be inserted in those places. CSS in XXE ---------- In order to make the element visible in XMLmind XML Editor, the css was adapted: https://github.molgen.mpg.de/EditionOpenAccess/eoa-xmlmind/commit/abd165945fb3c5de385f12c0d3e311b412e14b76 TEI to other formats -------------------- As a next step, the three different converters out of TEI XML need to be adjusted. TEI to EOATeX ~~~~~~~~~~~~~ This step is shown in several commits: - https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/commit/bc3b2a51c9f2aea6af085a5fb811b2fd63811506 - https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/commit/6759000ad65713da0cbe45215b415540b1e76002#diff-0f995dd4c0d73853739651193d732c82 Pretty straightforward. TEI to IMXML ~~~~~~~~~~~~ The divider is converted to a paragraph for the other formats and assigned an attribute. https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/commit/51a5089ab1a4cf3a1461629abf275faec0a75cd7 The IMXML (Intermediate XML) is then picked up by the scripts ``imxml2django`` and ``imxml2epub`` for further processing. See :ref:`imxml-otherformats`. TEI to HTML ~~~~~~~~~~~ This code is as of now (beginning of March 2020) incomplete, since the XSL is rather difficult. https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/commit/e8c2f285463ebf0f9d82ae10b3985b4073c27866 .. _imxml-otherformats: IMXML to other formats ---------------------- IMXML serves as the intermediate step to other formats: Ingest into EOAPP 1.5 as well as conversion to EPUB. IMXML to Django ~~~~~~~~~~~~~~~ The following commit shows how the paragraph is treated here https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/commit/ea181fedfd4dd5b5018ae9a2508a2373a3b5cfa0 See section :ref:`django-extension` below for modifications on the Django platform. IMXML to EPUB ~~~~~~~~~~~~~ Changes were necessary in ``imxml2epub.py`` as well as the epub CSS files: https://github.molgen.mpg.de/EditionOpenAccess/EOASkripts/commit/0e11d1319a645ca221ce8f13df2cae090cc90053 .. _django-extension: Django ------ Since there was no easy way to handle the new feature just by extending a template, the new feature was added to the ``eoapublication`` model. See :ref:`changing-models` for the details. More to come ============ This change has not yet been propagated to the EOATeX workflow. That is, there is as of now no code to go into the TeX and XML preambel to cater for the conversion from EOATeX via tralics to XML.