diff options
| author |   Ulrich Müller <ulm@gentoo.org> | 2021-03-12 18:51:37 +0100 |
|---|---|---|
| committer | Ulrich Müller <ulm@gentoo.org> | 2021-03-19 20:19:39 +0100 |
| commit | 91b323cd575dff579191a767190e9d56ff255d44 (patch) | |
| tree | 4a5acdbd8f82e119d5f986e22cba5fce2be2d66a /appendices | |
| parent | devbook-guide: Move all inline elements together (diff) | |
| download | devmanual-91b323cd575dff579191a767190e9d56ff255d44.tar.gz devmanual-91b323cd575dff579191a767190e9d56ff255d44.tar.bz2 devmanual-91b323cd575dff579191a767190e9d56ff255d44.zip | |
devbook-guide: Clearer section structure
Drop the "Devbook XML" section header which was not very useful.
Instead, promote "Basic structure" from subsection to section,
and introduce two new sections "Body elements" and "Inline elements".
So, the resulting section structure is:
DevBook XML design goals
Basic structure
Sections and subsections
Including sub-documents
An example <body>
Body elements
Code samples and colour-coding
Figures
Tables
Lists
Inline elements
<c>, <b>, and <e>
<uri>
Intra-document references
Coding Style
Internal Coding Style
External Coding Style
Signed-off-by: Ulrich Müller <ulm@gentoo.org>
Diffstat (limited to 'appendices')
| -rw-r--r-- | appendices/devbook-guide/text.xml | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/appendices/devbook-guide/text.xml b/appendices/devbook-guide/text.xml index 28fbacd..64d1178 100644 --- a/appendices/devbook-guide/text.xml +++ b/appendices/devbook-guide/text.xml @@ -24,8 +24,6 @@ documents. </section> <section> -<title>Devbook XML</title> -<subsection> <title>Basic structure</title> <body> @@ -71,7 +69,7 @@ All tags must be closed of course, so the document ends with: </codesample> </body> -</subsection> + <subsection> <title>Sections and subsections</title> <body> @@ -221,8 +219,10 @@ This is a warning. </body> </subsection> -<subsection> -<title>The <body> tags</title> +</section> + +<section> +<title>Body elements</title> <body> <p> @@ -248,7 +248,7 @@ preserve their whitespace exactly, making them well-suited for code excerpts: </codesample> </body> -</subsection> + <subsection> <title>Code samples and colour-coding</title> <body> @@ -454,6 +454,10 @@ together: </body> </subsection> +</section> + +<section> +<title>Inline elements</title> <subsection> <title><c>, <b>, and <e></title> <body> |