Home › Forums › DITA and XMetaL Discussion › Using Sections in a Concept Topic › Reply To: Using Sections in a Concept Topic
Reply to: Using Sections in a Concept Topic
August 25, 2010 at 6:59 pmI 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
(and a bunch of other things – the “basic.block” stuff), BUT these things must come before
or
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
(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