I was in Rockville, Maryland on May 5th for an all day meeting of the DC area oXygen XML Editor users. Hosted by George Bina and Radu Coravu, who outlined the new features in oXygen version 19 released last month. This meeting was special in that it doesn’t happen every year so I availed myself of an interesting opportunity.
Many Improvements to DITA
DITA reusable components view, insert DITA Key References
Improvements included converting DITA to PDF using CSS, DocBook 5.1 schema updates and stylesheets, and Markdown, XSLT improvements with Saxon 188.8.131.52, convert between multiple xsl:if and xsl:choose, using partial XPath paths to create new code and templates, and other refactoring features. Many of the improvements are designed to speed up workflow. TEI Schemas 3.1.0 were updated. Web Author improvements including CMS connectivity.
User Assistance with Schematron
Schematron is a ISO standard (ISO/IEC 19757)–DSDL (Document Schema Definition Language); a very simple schema language less than 10 elements and 20 elements in total; a different kind of schema–defines business rules, not the document structure, the error messages are specified inside the schema. XPath uses Schematron to match and assert; XSLT to extend XSLT based Schematron implementations; and SQF provides quick-fixes to identified issues defined as small scripts annotating the Schematron assertions. Schematron can help you in the authoring phase of a project instead of review time, publishing time, and production time. Identify and fix the problems as early as possible, says George! Intelligence style guide project for Dynamic Information Model; https://github.com/dim
Learn DITA from a Markdown perspective
Markdown is a text-to-HTML conversion tool for web writers. Markdown recognizes Markdown fragments in DITA topics and convert them automatically to DITA markup. the code is on GitHub: https://github.com/oxygenxml/ditamark. Recognized Markdown patterns include lists, quotes, links, images, tables, and titles.
Schematron Quickfix with SQF can be found here: https://github.com/schematron-quickfix/sqf. SQF is a simple language to use (only 4 actions!).
Changing XML with XSLT and XQuery
Implement Author actions and refactoring options
XML refactoring actions allow making repetitive structural changes in XML documents based on specific use cases.
There were some short presentations on oXygen XML editor features and applications.
oXygen for training sessions
JATS Support in Oxygen XML Editor
Wendell Piez from Piez Consulting Services provided an overview of JATS support. A wiki is available: http://jatswiki.org/wiki/Tools#JATS_Framework_for_oXygen_XML_Editor .
XSpec is a unit test and Behaviour Driven Development (BDD) framework for XSLT and XQuery. https://github.com/xspec/xspec/wiki
Code is available at GitHub: https://github.com/xspec/xspec
Three common ways for testing XSLT: matching scenarios, named scenarios, and function scenarios.
Discover the Author mode
For development XML based languages like:
- XML Schema
- Relax NG
- XProc (http://xproc.org/)
Making XML Editable on the Web
XAAS –XML Authoring as Service
oXygen XML Web Author = A REST service to interact with XML content!
- URL –pointing to the file to edit
- ditamap — pointing to a DITA map for editing context
- … — more parameters are available
Integration is key
The web XML editor DOES NOT EQUAL opening XML to edit in browser. The real power of a web editor can be seen when it is integrated into your workflow.
xproc.org and exproc.org are similar services (GitHub, Travis).
Integration is the key for web XML authoring!
Discover the oXygen Collaboration Platform
Why oXygen Content Fusion?
You need to:
- have access to specific tools
- work within a specific workflow
- access a repository
- approve changes before reaching the repository
- have a less formal way of receiving feedback.
Content Fusion allows you to create a review/collaboration task, share tasks URL with your contributors, and get changes back . There is a Content Fusion Connector plugin for oXygen as well.
Using Saxon JS
Wendell Piez gave a presentation on using Saxon JS.
George Bina outlined future plans for oXygen. The summary can be found here: https://www.oxygenxml.com/events/2017/futurePlans.pdf