v0.1.2

sync

v0.1.1beta

Compatibility

This release has been tested with oXygen 18.1, DITA-OT 2.4.1 and Saxon 9.6.0.7.

New Features

• Integrated Conbat (content by attributes) for oXygen and DITA-OT
• Integrated Advanced Key-Ref for oXygen and DITA-OT
• display topic-number for topic that are part of the current map in die DTA Maps manager in oXygen
• Added various samples

Known Issues

• The caching (relevant for advanced Key-Ref and topic number sin oXygen) does not work with Relax-NG schemas
• This is more a snapshot than a release. The idea is to give access to the samples presented at XML-Prague 2017

v0.1.0beta

Compatibility

This release has been tested with oXygen 17.1, DITA-OT 2.2.1 and Saxon 9.6.0.7.

Files

• dita-semia.pdf contains some basic documentation and all samples with the resolved content being highlighted.
• org.dita-semia.pdf.zip contains the pdf plugin for DITA-OT.
• org.dita-semia.resolver.zip contains the resolver plugin for DITA-OT as well as all the source code and libraries for the oXygen plugins and frameworks as well as the external libs for log4j and saxonHE.
• org.dita-semia.resolver-without-ext-libs.zip contains the same files as org.dita-semia.resolver.zip but without the external libs.

New Features

• Integration with DITA-OT. (This required to rewrite the XSLT scripts to use only Saon HE features.)
• Added DITA-OT pdf transtype to handle embedded SVG and optionally highlight resolved XSLT-Conrefs.
• All related attributes are put into a specific namespace to be easily identified as non-standard.
• Pass the current XSLT-Conref element (xcr:current) instead of an xpath expression to the XSLT script as standard parameter.
• Added support for xpath exprssions within custom parameters.
• Added some basic documentation and a despriptions for all samples.
• XSLT-Conref working on table rows and entries as well now.
• New attribute to execute the XSL script without initial context but by calling a named template.
• New sample:sequence-diagram (create a graphical sequenec diagram from a list of function calls).
• New sample: dynamic-type-information (add type information to reference based on global field definition).
• Added XSL utility for generating svg graphics.

Bug Fixes

• Special characters in the URLs are decoded correctly.
• Custom parameters are converted automatically to the required type (if possible).

Known Issues

• Documentation still incomplete

Internal Changes

• Use s9api instead of jaxp to use saxon xslt transformer
• Reorganized file structure for integration with DITA-OT.

v0.0.3beta

New Features

• New sample: section-overview (extreme simple xsl script).
• More meaningful error messages when resolving the reference failed.
• Improved Schematron messages and added support of URNs.
• No need to save the xsl scripts in Oxygen before refreshing - the current code is used.
• Automatic recompilation of script when timestamp has changed

Bug Fixes

• XSLT-Conref Buttons:
  • Mo more marking the document as modified.
  • Available within read-only context (e.g. DITA Maps with resolved topics) as well.
  • Available when resolving the reference failed.
• Xrefs within resolved content working properly now.
• Resolving table rows and entries working.

Known Issues

• There is no DITA-OT integration yet.
• No documentation except the README.md.
• Relative URLs can't be resolved when there are special characters in the base URI.

Internal Changes

• New class OxygenExtensionsBundle (required to resolve table rows and entries)
• Use URIResolver in NodeWrapper interface

v0.0.2beta

DitaSemiaXsltGui.zip contains all sources and binaries of XsltConref as well as of the required repositiory JavaBase.

New Features

• Buttons within oXygen for XSLT-Conrefs to open XML input (if seperate URL), open XSLT script or refresh the content.
• Schematron checks for invalid xslt scripts (requires DitaSemiaJavaBase.jar to be placed in oxygen lib folder)
• Added script parameter xPathToXsltConref that allows to identify the current XSLT-Conref element to be resolved within the input document.
• Added support for custom parameters specified as attributes within a specific namespace.
• Added support for empty result with optional content only displayed to the author.
• Support for URNs within XSLT scripts (e.g. for include or import-schema).
• When using the current document as xml input to the XSLT script the source is taken from memory instead of from file.(Thus, no need to save the file before refreshing the XSLT-Conrefs.)
• Support to set a url (@xslt-conref-source) to be used for input instead of the current document.
• Default Attributes (esp. @Class) are expanded in input to xslt-scripts.
• New framework to add XSLT-Conref support to DITA Maps as well (resolve them when displaying the map with resolved topics).

Additional Samples

• import-xml-to-codeblock (generate a codeblock by quoting and indenting an input xml file)
• import-cpp-enums (generates list of enumerations from C++ file as ul-element)
• import-csv-to-table (imports a csv file and puts the data into a simpletable-element)
• import-excel-xml-to-table (imports an MS-Excel table in xml format and puts the data into a simpletable-element)
• import-tdm-entity (Import an entity of a Toad Data Modeler file into a reference)
• svg-simple-test (displays the title within a rectangle)
• local-toc-specialized (defines a specialized element local-toc to be used in any section)
• local-toc-parameterizes (defines a specialized element local-toc to be customized by the author in several ways

Bug Fixes

• oXygen-resolver can deal with DITA-conrefs as well
• Modifying the xslt-conref attribute will refresh the reference
• Hide mandatory child elements required by schema (e.g. li in ul)

Known issues

• There is no DITA-OT integration yet.
• The error messages when something's going wrong are pretty weak. (Check log file.)
• XSLT-Conref Buttons are disabled in DITA Maps.
• No documentation except the README.md

Internal Changes

• Jar files removed from the source (still included in the DitaSemiaXsltConref.zip)
• Changed classpath to include DitaSemiaJavaBase using a variable instead of a relative URL (requires an additional variable DITA_SEMIA)
• JavaBase will be copied on compilation to oxygen lib folder
• Saxon Configuration is read from configuration file within DitaSemiaJavaBase.jar

v0.0.1beta

First version supporting basic functionality in oXygen and a transformation scenario to resolve the xslt-conref

Getting started

1. Download DitaSemiaXsltConref.zip. This file contains the complete repositories of XsltConref as well as JavaBase. This includes the sources, samples and binaries.
2. Configure an additonal custom framework location in oXygen for the XsltConref/framework folder
3. Restart oXygen
4. Open the project XsltConref/samples/xslt-conref-samples.xpr
5. Open the file samples/local-toc/local-toc.dita

Known issues:

• The current reference resolver can only deal with xslt-conrefs. The standard DITA references are not resolved.
• There is no DITA-OT integration yet.
• The transformation scenarion cannot deal with URNs of any kind. Thus, the sample adding-default-attr works only in oXygen, not for the transformation
• The error messages when something's going wrong are pretty weak. Check the log file or wait for the next release when you have difficulties locating the problem.