oXbytao - oXbytei with Add-Ons

tl;dr

Install from

https://scdh.github.io/oxbytao/descriptor.xml

STATE: in production

About oXbytao

oXbytao is oXbytei with add-ons.

• CSS styles, that can simply be extended on a project level without writing your own framework
• some author mode actions that are too trivial or too biased to a certain markup style for oXbytei
  • highlight referenced text in anchor-based markup (e.g. the portion of the text referenced by an apparatus entry with external double end-point attached variant encoding)
  • append a <rdg> to an apparatus entry
  • delete an apparatus entry
  • <note>
  • <sic>
  • <corr>
  • wrap elements into <choice> and unwrap
  • templates directory in ${pd}/templates, i.e. the directory named templates in the root folder of your oXygen project.

Requirements

• oXygen >= 23.1
• oXbytei

Installation

Installation is just as easy as the installation of oXbytei. Just take the following link instead:

https://scdh.github.io/oxbytao/descriptor.xml

Customization

CSS

oXbytao introduces new CSS styles, which inherit from the Basic style:

• Collapsed: hide details like the critical apparatus
• Expanded: show all details And it offers the additional styles:
• +Anchors: show <anchor> elements as ⚓
• +Header: show/hide header
• +Comments: show/hide notes
• +Diplomatic: show <pb> as linebreaks vs. inline /
• +Edit: offer editing of various attributes etc.

These can be extended on a project level without writing your own framework. There are some empty CSS files in the framework, that can simply be replaced by an XML catalog:

• common-project.css: local CSS definitions used by all the styles in oXbytao. You can use this for adding your own project-wide font definitions etc.
• collapsed-project.css: local CSS definitions used in Collapsed style.
• expanded-project.css: local CSS definitions used in Expanded style
• anchors-project.css: local CSS definitions used in +Anchors style
• header-project.css: local CSS definitions used in +Header style
• note-project.css: local CSS definitions used in +Comments style
• diplomatic-project.css: local CSS definitions used in +Diplomatic style
• edit-project.css: local CSS definitions used in +Edit style

Note: If you want to re-define styles already defined, then you can also replace files without the -project infix.

XML catalog

Let's assame that you have an XML catalog file in resources/catalog.xml in your oXygen project and a customized CSS in resources/css/common.css. Then you should put the following lines in the catalog file:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE catalog PUBLIC "-//OASIS//DTD Entity Resolution XML Catalog V1.1//EN" "http://www.oasis-open.org/committees/entity/release/1.1/catalog.dtd">
<catalog xmlns="urn:oasis:names:tc:entity:xmlns:xml:catalog">

 <!-- redirect to local CSS -->
  <uriSuffix uriSuffix="oxbytoa/css/common-project.css" uri="css/common.css"/>
 <uriSuffix uriSuffix="oxbytoa/css/common-project.css" uri="css/common.css"/>

</catalog>

You also have to activate the catalog file for your oXygen project.

License

Copyright (c) 2021 Christian Lück

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.