| I took Michael’s example out of the presentation and created a short page for it in our LwDITA GitHub repo. I hope it makes it easier to read:
Carlos
--- Carlos Evia, Ph.D. Director of Professional and Technical Writing Associate Professor of Technical Communication Department of English Center for Human-Computer Interaction Virginia Tech Blacksburg, VA 24061-0112 (540)200-8201
This presentation includes an overview - I can send you the link to a recording as well if that would be useful:http://www.slideshare.net/mpriestley/lightweight-dita-a-preoverview
Michael Priestley, Senior Technical Staff Member (STSM)
Enterprise Content Technology Strategist
mpriestl@ca.ibm.comFrom: "Birgit Strackenbrock" <birgit@xstructuring.eu>To: Michael Priestley/Toronto/IBM@IBMCACc: <dita-lightweight-dita@lists.oasis-open.org>, "'Eva de Haas'" <eva.de.haas@liones.nl>Date: 08/26/2016 03:14 AMSubject: RE: [dita-lightweight-dita] template approach for specializationSent by: <dita-lightweight-dita@lists.oasis-open.org>
One more question.Is there a document with describes the template approach or should I have to use http://markmail.org/message/pd4u5kfg44xp5x5cand other mails? Van: Birgit Strackenbrock [mailto:birgit@xstructuring.eu]
Verzonden: vrijdag 26 augustus 2016 09:03
Aan: 'Michael Priestley' <mpriestl@ca.ibm.com>
CC: 'dita-lightweight-dita@lists.oasis-open.org' <dita-lightweight-dita@lists.oasis-open.org>; 'Eva de Haas' <eva.de.haas@liones.nl>
Onderwerp: RE: [dita-lightweight-dita] template approach for specialization Dear Michael,That’s right.We will try how we can achieve the specialization we want with the template approach. As fare as we have some “templates” we will send.Kind regards, Birgit Van: Michael Priestley [mailto:mpriestl@ca.ibm.com]
Verzonden: donderdag 25 augustus 2016 23:12
Aan: Birgit Strackenbrock <birgit@xstructuring.eu>
CC: dita-lightweight-dita@lists.oasis-open.org; 'Eva de Haas' <eva.de.haas@liones.nl>
Onderwerp: Re: [dita-lightweight-dita] template approach for specialization Hi Birgit,
As others have said, there is no direct way to get your specializations from a template-based approach today.
However, the template-based approach comes with some assumptions, which hopefully we can reflect in the design of your specializations.
1) no block domains (these actually have only ever been allowed at phrase, attribute, or data element level - this restriction predates the template mechanism)
2) specialization always happens within a specialized topic (this is new with templates)
3) you can reuse specialized elements across specializations by using conref in the template files, so you won't miss block-level domains so much (this is new with the template mechanism, but doesn't affect you since you're not reusing any elements from other specializations anyway)
There is one very minor change that would need to happen to make your specialization compatible with the template based approach:
- add specialized topic/body elements so that the doctype can be used directly for authoring
There are also some other comments we have, which are not related to the template-based approach, but reflect concerns about which element you chose as a base, the availability of attributes in ancestor elements, etc.
For example, two of your list structures are specialized from ul, but seem to be a more natural fit with dl; and one of your list structures is specialized from fig, but seems a more natural fit with ul. And there is an element with an href attribute, when its ancestor element doesn't have an href attribute. We can talk through these in detail in our meeting.
Michael Priestley, Senior Technical Staff Member (STSM)
Enterprise Content Technology Strategist
mpriestl@ca.ibm.com
From: "Birgit Strackenbrock" <birgit@xstructuring.eu>
To: <dita-lightweight-dita@lists.oasis-open.org>
Cc: "'Eva de Haas'" <eva.de.haas@liones.nl>
Date: 08/24/2016 07:49 AM
Subject: [dita-lightweight-dita] template approach for specialization
Sent by: <dita-lightweight-dita@lists.oasis-open.org>
Hi Michael,
At the last LW call Jan has presented the LW marketing specialization we are working on. One comment/question was:
- We might not have used the correct specialization mechanism. LW DITA supports the template-based specialization, we did it the “old way”.
And for sure, we didn’t used the template approach.
Now, I have read again all mails about the template approach and I thing I understand it more or less. I could make a template like the one in http://markmail.org/message/pd4u5kfg44xp5x5cbut I am wondering how I can get/generate the DTD or better XSD from this. Do I need a special tool and/or scripts?
And yes, I do wonder if the template approach really is much easier than the “old way” as used in standard DITA. Maybe an advantage is that the specialization will not become more complex than the basic topic and elements.
Kind regards, Birgit
<Mail Attachment.jpeg>
<www.xstructuring.eu>
<info@xstructuring.eu>
|