aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Müller <ulm@gentoo.org>2019-12-26 20:28:37 +0100
committerUlrich Müller <ulm@gentoo.org>2019-12-26 21:40:28 +0100
commit88fdd7e242a75846bd149c5e6c02d804701d58e6 (patch)
tree0692c16b503e3dede2065b3f4b24bb9b2e85c4fb /appendices
parentRemove all p elements below dd. (diff)
downloaddevmanual-88fdd7e242a75846bd149c5e6c02d804701d58e6.tar.gz
devmanual-88fdd7e242a75846bd149c5e6c02d804701d58e6.tar.bz2
devmanual-88fdd7e242a75846bd149c5e6c02d804701d58e6.zip
Revert "appendices/contributing/devbook-guide: remove information on definition lists"
This reverts commit a1cad38db2fa2096b1161bf5a6ec85048d5a3a74. Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'appendices')
-rw-r--r--appendices/contributing/devbook-guide/text.xml47
1 files changed, 47 insertions, 0 deletions
diff --git a/appendices/contributing/devbook-guide/text.xml b/appendices/contributing/devbook-guide/text.xml
index d39e794..5af7226 100644
--- a/appendices/contributing/devbook-guide/text.xml
+++ b/appendices/contributing/devbook-guide/text.xml
@@ -430,6 +430,53 @@ that you can have lists inside lists. Don't forget that you are writing XML and
that you must close all tags including list items unlike in HTML.
</p>
+<p>
+Definition lists (<c>&lt;dl&gt;</c>) are also supported. Please note that
+neither the definition term tag (<c>&lt;dt&gt;</c>) nor the definition data tag
+(<c>&lt;dd&gt;</c>) accept any other block level tag such as paragraphs or
+admonitions. A definition list comprises:
+</p>
+
+<dl>
+ <dt><c>&lt;dl&gt;</c></dt>
+ <dd>A <b>D</b>efinition <b>L</b>ist Tag containing</dd>
+ <dt><c>&lt;dt&gt;</c></dt>
+ <dd>Pairs of <b>D</b>efinition <b>T</b>erm Tags</dd>
+ <dt><c>&lt;dd&gt;</c></dt>
+ <dd>and <b>D</b>efinition <b>D</b>ata Tags</dd>
+</dl>
+
+<p>
+The following list copied from <uri
+link="http://www.w3.org/TR/REC-html40/struct/lists.html">w3.org</uri> shows
+that a definition list can contain ordered and unordered lists. It may not
+contain another definition list though.
+</p>
+
+<dl>
+ <dt><b>The ingredients:</b></dt>
+ <dd>
+ <ul>
+ <li>100 g. flour</li>
+ <li>10 g. sugar</li>
+ <li>1 cup water</li>
+ <li>2 eggs</li>
+ <li>salt, pepper</li>
+ </ul>
+ </dd>
+ <dt><b>The procedure:</b></dt>
+ <dd>
+ <ol>
+ <li>Mix dry ingredients thoroughly</li>
+ <li>Pour in wet ingredients</li>
+ <li>Mix for 10 minutes</li>
+ <li>Bake for one hour at 300 degrees</li>
+ </ol>
+ </dd>
+ <dt><b>Notes:</b></dt>
+ <dd>The recipe may be improved by adding raisins</dd>
+</dl>
+
</body>
</subsection>
<subsection>