You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

34 lines
1.3 KiB

4 years ago
////
Sections
Included in:
- user-manual
////
To make a discrete heading, you add the `discrete` attribute to any <<Sections,section title>>.
//This demotes the section title to a normal heading.
A discrete heading is styled in a manner similar to a section title, but is not part of the section hierarchy (i.e., and thus excluded from section nesting requirements), it does not enclose subsequent blocks, and it is not included in the table of contents.
The `discrete` style effectively demotes the section title to a normal heading.
NOTE: Alternately, you may use the `float` attribute to identify a discrete heading.
In this context, the term "`float`" does not imply layout, meaning it does not float to the left or right of other content blocks.
It just means it's not anchored to the section hierarchy.
Here's an example of a discrete heading in use.
[source]
----
**** // <1>
Discrete headings are useful for making headings inside of other blocks, like this sidebar.
[discrete] // <2>
== Discrete Heading // <3>
Discrete headings can be used where sections are not permitted.
****
----
<1> A delimiter line that indicates the start of a sidebar block.
<2> Set the `discrete` attribute above the section title to demote it to a discrete heading.
<3> The discrete heading title is designated by one to six equal signs, just like a section title.