Integrated Style Guide - Dynamic Information Model

gwhite
Posts: 70
Joined: Fri Jul 27, 2012 1:46 am

Integrated Style Guide - Dynamic Information Model

Post by gwhite » Mon May 11, 2015 8:18 pm

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
Posts: 70
Joined: Fri Jul 27, 2012 1:46 am

Re: Integrated Style Guide - Dynamic Information Model

Post by gwhite » Wed May 13, 2015 8:44 pm

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
Posts: 70
Joined: Fri Jul 27, 2012 1:46 am

Re: Integrated Style Guide - Dynamic Information Model

Post by gwhite » Thu May 14, 2015 1:38 am

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
Site Admin
Posts: 2101
Joined: Thu Jan 09, 2003 2:58 pm

Re: Integrated Style Guide - Dynamic Information Model

Post by george » Thu May 14, 2015 1:05 pm

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
George Cristian Bina

gwhite
Posts: 70
Joined: Fri Jul 27, 2012 1:46 am

Re: Integrated Style Guide - Dynamic Information Model

Post by gwhite » Sat May 30, 2015 1:19 am

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
Site Admin
Posts: 2101
Joined: Thu Jan 09, 2003 2:58 pm

Re: Integrated Style Guide - Dynamic Information Model

Post by george » Tue Jun 02, 2015 9:19 am

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
George Cristian Bina

aremaci
Posts: 3
Joined: Wed Jul 03, 2019 12:31 pm

Re: Integrated Style Guide - Dynamic Information Model

Post by aremaci » Wed Jul 03, 2019 1:00 pm

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
Site Admin
Posts: 2101
Joined: Thu Jan 09, 2003 2:58 pm

Re: Integrated Style Guide - Dynamic Information Model

Post by george » Mon Jul 08, 2019 3:42 pm

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
George Cristian Bina

Post Reply