Reply To: Using Sections in a Concept Topic

[Derek Read]

I would recommend the DITA Language Reference, but it does not get into things at this detail level (ie: which elements can follow others). However, just in case it might help in future you can press Alt+F1 and our help system will bring up the DITA LangRef documentation for the current element.

To answer your question, what you are seeing is a result of this rule in the DITA 1.1 DTDs:

[code][/code]

That rule brings in a bunch of other stuff, provided here for a little more context…

[code][/code]

[code]                        %sl; | %pre; | %lines; | %fig; | %image; |
                        %object; |  %table; | %simpletable;”>[/code]

Basically, what this all means is that may optionally contain

(and a bunch of other things – the “basic.block” stuff), BUT these things must come before

or (which are also optional). So, if (as in the default template we ship that you are probably using) already has a

as its first child element you cannot put a

before it.

This is also why, when you remove the

you can insert a

as the first element inside . And it is also why, if you select the entire

(including tags) you can wrap it with

using the Element List as

can also contain

.

What it comes down to I think, is that you should believe whatever the Element List tells you as long as “Rules Checking” is turned on, which is usually the case in TagsOn and Normal views, but never the case in Plain Text view where you are free to do whatever you like.

If you prefer to always start your concept topics with

then you may wish to create a template for that (ie: one that has

instead of

as the first element), or you might wish to create a template that has nothing inside so you can decide when you open it what the first child of should be.

Reply