Learning and training specialization topics/elements

Learning and training specialization topics/elements

Postby gwhite » Fri Feb 01, 2013 2:26 am

I'm exploring use of the learning and training specialization elements included in DITA OT 1.2, but I've been frustrated by unexpected behaviors when I try using these in Oxygen, and by a general lack of information here or on the usual DITA user forums.

It seems that using Interactions domain elements I should be able to generate xhtml (WebHelp) that allows a user to click on a set of possible answers to quiz questions that should provide instant feedback. Instead, whether in PDF (where it obviously should not work) or in WebHelp (where it theoretically should), the questions and accompanying feedback elements simply display with no interactivity. What is a good resource for details on how to set up these sorts of interactions?

Also, some learning and training elements do not display at all in WebHelp (the lcTime sub-element for Duration in learning content overview topics, for example).

I guess my primary question would be, where in oXygen or the DITA-OT are characteristics of these learning specialization topics/elements controlled and where can I learn more about how to implement them?

Thanks,

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

Re: Learning and training specialization topics/elements

Postby Radu » Fri Feb 01, 2013 3:20 pm

Hi Gary,

Oxygen uses the DTDs/schemas provided by the DITA 1.2 specification for editing Learning specialization topics. It also uses the DITA Open Toolkit to publish the content to various output sources.

I cannot help you much in this regard because we are not using the Learning specializations internally. And there do not seem to be a lot of people who do, searching around (or asking questions on) the DITA Users List might be a good place to start:

http://tech.groups.yahoo.com/group/dita-users/message/29486

It seems that using Interactions domain elements I should be able to generate xhtml (WebHelp) that allows a user to click on a set of possible answers to quiz questions that should provide instant feedback. Instead, whether in PDF (where it obviously should not work) or in WebHelp (where it theoretically should), the questions and accompanying feedback elements simply display with no interactivity. What is a good resource for details on how to set up these sorts of interactions?


No, learning topics are not translated in interactive HTML form controls. This was not the intended purpose from what I saw in a previous discussion on the DITA Users List (cannot find the thread now).
Actually this is quite hard to do, where would that feedback be sent and how would you identify the person who sent it? You need a PHP script running on a server with a database in order to store that information. You need each user to authenticate.

Our WebHelp with Feedback transformation does something like this. Each published topic has a feedback area at the bottom which can be used by users to comment on the read topic.

Probably the DITA 1.2 specification is about the place to start (and maybe the only place to start):

http://docs.oasis-open.org/dita/v1.2/os/spec/archSpec-learningTraining.html#archspec-learningtraining

Also, some learning and training elements do not display at all in WebHelp (the lcTime sub-element for Duration in learning content overview topics, for example).


The DITA Open Toolkit XSLT processing may not handle properly all the Learning specialization elements.
Actually I added a bug for your problem about a year ago:
https://github.com/dita-ot/dita-ot/issues/655

The issue points to a more detailed discussion on the DITA Users List.

I guess my primary question would be, where in oXygen or the DITA-OT are characteristics of these learning specialization topics/elements controlled and where can I learn more about how to implement them?


The DITA Open Toolkit applies a series of XSLT stylesheets on the DITA content, stylesheets which can be potentially changed and improved to match what you need.

Regards,
Radu
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Radu
 
Posts: 2723
Joined: Fri Jul 09, 2004 5:18 pm

Re: Learning and training specialization topics/elements

Postby gwhite » Fri Feb 01, 2013 6:10 pm

Thanks for your detailed reply, Radu. I may simply rethink using the specialization, because I'm not sure the value-add is that significant. Sounds as if others have reached a similar conclusion.

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


Return to DITA

Who is online

Users browsing this forum: No registered users and 0 guests