Page 1 of 1

Ordered list before note in step

Posted: Mon Sep 18, 2023 11:07 am
by Sergio_7
Hi all,
I would like to know how to avoid the ordered list when it comes to a note in a step before.
image.png
The number should be regular after the note. But before that I just want to have the note.
Thanks in advance!

Re: Ordered list before note in step

Posted: Mon Sep 18, 2023 1:07 pm
by Radu
Hi,
I assume the question is for a DITA XML task, a DITA note can be inserted inside an <info> element inside a step like:

Code: Select all

<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">
<task id="task_ogw_3ff_vyb">
    <title />
    <shortdesc />
    <taskbody>
        <context>
            <p />
        </context>
        <steps>
            <step>
                <cmd>Step 1</cmd>
                <info>
                    <note>Step 1 note</note>
                </info>
            </step>
            <step>
                <cmd>Step 2</cmd>
            </step>
        </steps>
    </taskbody>
</task>
Regards,
Radu

Re: Ordered list before note in step

Posted: Mon Sep 18, 2023 5:11 pm
by Sergio_7
Hi Radu,
thank you very much for your reply. Indeed, at some places you can work around the problem by adding an <info> element. But at other places it is not possible, like here:
<stepsection></stepsection>
<step>
<note></note>
<cmd/>
</step>

The <note> should appear before the <step>. Is this a dedicated topic in terms of customization with custom dtd?

Re: Ordered list before note in step

Posted: Tue Sep 19, 2023 7:37 am
by Radu
Hi,
In your last example why not put the note inside the step section?

Code: Select all

<stepsection>
                <p>...</p>
                <note>...</note>
            </stepsection>
            <step>
                <cmd/>
            </step>
Indeed the DITA task content model is restrictive, it was intended by the DITA specification to be as such. Maybe in certain cases you can use DITA topics instead of tasks.
We have some content in the user's guide about specializing DITA:
https://www.oxygenxml.com/doc/versions/ ... pport.html
Basically the reference specialization tutorial is this one created by Eliot Kimber:
https://www.oxygenxml.com/doc/versions/ ... pport.html
but I think the examples shown here are only for DITA concepts.

Regards,
Radu