commit: 88fdd7e242a75846bd149c5e6c02d804701d58e6 Author: Ulrich Müller <ulm <AT> gentoo <DOT> org> AuthorDate: Thu Dec 26 19:28:37 2019 +0000 Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org> CommitDate: Thu Dec 26 20:40:28 2019 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=88fdd7e2
Revert "appendices/contributing/devbook-guide: remove information on definition lists" This reverts commit a1cad38db2fa2096b1161bf5a6ec85048d5a3a74. Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org> appendices/contributing/devbook-guide/text.xml | 47 ++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) 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><dl></c>) are also supported. Please note that +neither the definition term tag (<c><dt></c>) nor the definition data tag +(<c><dd></c>) accept any other block level tag such as paragraphs or +admonitions. A definition list comprises: +</p> + +<dl> + <dt><c><dl></c></dt> + <dd>A <b>D</b>efinition <b>L</b>ist Tag containing</dd> + <dt><c><dt></c></dt> + <dd>Pairs of <b>D</b>efinition <b>T</b>erm Tags</dd> + <dt><c><dd></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>