Fix #60: Consolidate admon content model

* Force admons to have at least one para as first child
* Allow informal{example,figure,table,equation} in admon
  content model (as suggested by Stefan)
* Disallow formalpara as a first child in admonitions
  (to avoid layout issues)
* Add test cases

Author: tomschr

geekodoc/rng/geekodoc5-flat.rnc

@@ -10514,16 +10514,24 @@ div {
   div {
     db.admonition.contentmodel =
       db._info.title.only,
-      db.remark*,
-      db.para,
-      (db.list.blocks
-       | db.formalpara
-       | db.verbatim.blocks
-       | db.remark
-       | db.para
-       | db.xi.include
-       | db.informalexample
-       | db.informalfigure)*
+      (db.remark*,
+       (db.para | db.xi.include),
+       (db.list.blocks
+        | db.informalexample
+        | db.informalfigure
+        | db.informaltable
+        | db.informalequation
+        | db.informal.blocks
+        | db.publishing.blocks
+        | db.graphic.blocks
+        | db.technical.blocks
+        | db.verbatim.blocks
+        | db.remark
+        | db.para
+        | db.formalpara
+        | db.simpara
+        | db.extension.blocks
+        | db.xi.include)*)
     db.admonition.blocks =
       # Removed caution
       db.important

geekodoc/rng/geekodoc5.rnc

@@ -1177,17 +1177,22 @@ include "docbookxi.rnc"
   div {
     db.admonition.contentmodel =
       db._info.title.only,
-      db.remark*,
-      db.para,
-      (db.list.blocks
-      | db.formalpara
-      | db.verbatim.blocks
-      | db.remark
-      | db.para
-      | db.xi.include
-      | db.informalexample
-      | db.informalfigure
-      )*
+      (db.remark*,
+       (db.para | db.xi.include),
+       (db.list.blocks
+       | db.informalexample
+       | db.informalfigure
+       | db.informaltable
+       | db.informalequation
+       | db.informal.blocks
+       | db.publishing.blocks
+       | db.graphic.blocks
+       | db.technical.blocks
+       | db.verbatim.blocks
+       | db.remark
+       | db.para | db.formalpara | db.simpara
+       | db.extension.blocks
+       | db.xi.include)*)
 
     db.admonition.blocks =
       # Removed caution

geekodoc/tests/good/article-admons.xml renamed to geekodoc/tests/good/article-admonitions.xml

@@ -41,4 +41,26 @@
  <warning>
   <para>bla</para>
  </warning>
+ <tip>
+  <remark/>
+  <para/>
+  <screen/>
+  <informalexample><screen/></informalexample>
+  <informalfigure>
+   <mediaobject>
+    <textobject>
+     <phrase/>
+    </textobject>
+   </mediaobject>
+  </informalfigure>
+  <informaltable>
+   <tgroup cols="1">
+    <tbody>
+     <row>
+      <entry/>
+     </row>
+    </tbody>
+   </tgroup>
+  </informaltable>
+ </tip>
 </article>