Integrated Style Guide - Dynamic Information Model

[gwhite]

Hi,

To exercise the new integrated style guide feature of Author 17, do I need Oxygen Editor, or can I perform all setup in Author?

Whichever is the case, what are the specific setup steps? I have seen George Bina's presentations in video and PDF, but nothing I have seen gives the actual step-by-step implementation, from modifying the sample style guide to generating the Schematron rules, to rollout and use by the technical authors. Is the procedure documented anywhere?

Gary

[gwhite]

As side note to this question, the ditamap for the information model in the DIM resource files located on github throws an error when opened:

Description: Resource "file:/C:/Users/..../dim-master/info-model/c_MapsAndBookMaps.dita" is referenced with incorrect path capitalization.
Suggestion: replace file name "c_MapsAndBookMaps.dita" with "c_MapsAndBookmaps.dita".

Gary

[gwhite]

One last thing: Is there a legal statement available that gives assurances users may use and modify the Information Model bookmap and topics provided by Comtech Services as part of the Dynamic Information Model?

[george]

Hi Gary,

I will try to create a step by step tutorial on how to get started with this and different options to setup the Schematron file and the configuration file that provides links to the styleguide topics.

The project is made available under Apache license, see
https://github.com/oxygenxml/dim/blob/master/LICENSE

Best Regards,
George

[gwhite]

Hi George,

Any progress on the task of documenting the step-by-step procedure to implement/modify the DIM based on a user's corporate style?

Gary

[george]

Hi Gary,

Not yet, I scheduled work on this for June 10 - I will be in London for the oXygen users meetup and XML London until then.

Best Regards,
George

[aremaci]

On GitHub there are two different projects: Intelligent Integrated Style Guide (https://github.com/oxygenxml/integrated-styleguide) and Dynamic Information Model (https://github.com/oxygenxml/dim). Could you explain the differences between the two? Should one be preferred over the other?
Thank you.

[george]

Hi,

The integrated style guide is a newer project, derived from DIM with the goal to provide a wiki-like experience to the style guide development. That is the UI that allows to add new rules in the style guide was developed to work for both the oXygen desktop and for the oXygen web author, so the content of the style guide can be edited online, and we also re-publish the style guide automatically using GitHub pages after any change on the master branch. The published style guide contain "edit" links for each topic, and this coupled to the automatic publishing gives the wiki-like interaction.

Best Regards,
George