OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

dita message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Changing info for an Open OASIS repo


Chet, the changes that Eliot has suggested below don't require working with you, I think.

However, I think we might want to slightly modify the description and statement of purpose. If we do, does that need to go through you? Thanks for your help.

Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)




-------- Forwarded Message --------
Subject: [dita] Changes for the DITA RNG Convertor repo that Eliot has suggested
Date: Tue, 7 Sep 2021 08:35:10 -0400
From: Kristen James Eberlein <kris@eberleinconsulting.com>
To: DITA TC <dita@lists.oasis-open.org>


Current info for the DITA RNG Convertor repository
------------------------------------------------------------

Description
The DITA RNG Converter provides cross-platform tools for generating DITA-conforming DTD- and XSD-format versions of RELAX NG DITA grammars: document type shells, vocabulary modules, and constraint modules. It makes it as easy as possible to develop and maintain DITA grammars by allowing use of RELAX NG syntax.

Statement of Purpose
The repository manages the source code and supporting documentation for the RELAX NG-to-DTD and RELAX NG-to-XSD (and any other RNG-to-X transforms that might be developed, such as RELAX NG-to-EDD or RELAX NG-to-Schematron) transforms developed originally for use by the DITA TC in producing the DITA 1.3 DTDs and XSDs from the normative RELAX NG versions of the DITA 1.3 grammar. The converter is intended to make it easy for any DITA user to develop and maintain their own document type shells, constraint modules, and vocabulary modules using RELAX NG, which has proven to be much easier to use than DTD or XSD.

Additions to Statement of Purpose

Tool Overview
This project provides the following transforms from RNG grammars that follow the coding conventions used by the DITA Technical Committee for the TC-defined modules and shells:

The transforms are implemented as XSLT transforms and run through an Ant script. See the project documentation for details.

The transforms can be run standalone or through an Open Toolkit plugin. The transforms have no dependency on the DITA Open Toolkit itself.

You can use these transforms to generate both DITA 1.2 and DITA 1.3 shells and modules: RNG versions of the DITA 1.2 shells and vocabulary are included in the project (as developed by the DITA Technical Committee).

NOTE: At some point the OASIS-defined grammars will be removed from this project and you'll need to get the latest DITA Open Toolkit distribution in order to minimize the number of copies of the OASIS-provided grammars.

Development Plan
The code as added 24 March 2016 is still under development and requires more work to make it ready for general use. The latest code is on the develop branch.

The current development plan is:

  1. Fix bugs related to infinite looping of code when generating shells, as reported by Toshihiko Makita on the DITA Community version of the repo (https://github.com/dita-community/dita-rng-converter/issues/2)
  2. Refine the Ant scripts to ensure that all parameters are appropriate and working.
  3. Finish documentation.

Schedule: Goal is to complete these actions by the end of December 2016 or as early in 2017 as possible.

Additional implementation goals include:

Please use the project issue tracker to report any bugs or log feature requests.

Please use the project Wiki for general discussion not related to specific bugs or features.Development Plan


New wording proposed by Eliot
------------------------------------

...

Tool Overview

This project provides the following transforms from RNG grammars that follow the coding conventions used by the DITA Technical Committee for the TC-defined modules and shells:

The transforms are implemented as XSLT transforms and run through an Ant script. See the project documentation for details.

The transforms can be run standalone or through an Open Toolkit plugin. The transforms have no dependency on the DITA Open Toolkit itself.

You can use these transforms to generate DITA 1.2, DITA 1.3, and DITA 2.x shells and modules: RNG versions of the DITA 1.2 shells and vocabulary are included in the project (as developed by the DITA Technical Committee).

NOTE: At some point the OASIS-defined grammars will be removed from this project and you'll need to get the latest DITA Open Toolkit distribution in order to minimize the number of copies of the OASIS-provided grammars.

Development Plan
The code as added 24 March 2016 is still under development and requires more work to make it ready for general use. The latest code is on the develop branch.

The current development plan is:

  1. Fix bugs related to infinite looping of code when generating shells, as reported by Toshihiko Makita on the DITA Community version of the repo (https://github.com/dita-community/dita-rng-converter/issues/2)
  2. Refine the Ant scripts to ensure that all parameters are appropriate and working.
  3. Finish documentation.

Schedule: Goal is to complete these actions by the end of April 2022.

Additional implementation goals include:

Please use the project issue tracker to report any bugs or log feature requests.

Please use the project Wiki for general discussion not related to specific bugs or features.

--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
OASIS Distinguished Contributor
Principal consultant, Eberlein Consulting LLC
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)


--------------------------------------------------------------------- To unsubscribe from this mail list, you must leave the OASIS TC that generates this mail. Follow this link to all your TCs in OASIS at: https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php .


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]