Subsection heading - - … - -

Subsection headings devide a section further into subsections. Subsection headings are usually printed bigger than regular text or in a bold font, but not as prominent as a section heading or the main heading.

How to

Mark both the start and the end of a subsection heading with two hyphens that are separated by a single space. See the examples below.

As block markup, a subsection heading usually requires a blank line before it. Lines of text immediately below the subsection heading like in the third example are called sublines and are associated with the subection heading. Another blank line separates the subsection heading or its last subline respectively from the subsection’s content.

Examples

The following examples that demonstrate how section headings work in Aneamal use song titles by Kate Bush. The first example is quite simple:

- - Hello Earth - -

The second example shows a subsection heading with two components, the original song title on the first line and its version below. The second line is printed in a smaller font on the webpage, but it is still part of the subsection heading. It would be included in a table of contents or track listing for instance, probably in parantheses:

- - The Big Sky
Meteorological Mix - -

The third example has a subline below the actual subsection heading, so after the final – – mark. The subline says how the song in the heading was published. The subline is associated with the subsection heading, but not part of it. It would not be listed in the table of contents.

- - Not This Time - -
B-side to "The Big Sky"

For developers

When Aneamal is translated to HTML, subsection headings become h3 elements. So the first example is turned into:

<h3>Hello Earth</h3>

Line breaks in a heading become HTML br elements and each line in the heading except for the first is wrapped in an HTML span element. So the second example is translated to:

<h3>The Big Sky<br><span>Meteorological Mix</span></h3>

CSS can be used to style individual lines of the subsection heading differently. The following code reduces the font size of all but the first line:

h3 > br + span {
	font-size: smaller;
}

A subsection heading’s sublines get wrapped in an HTML p element, which is wrapped together with the h3 element in an hgroup element. Hence the third example becomes:

<hgroup>
<h3>Not This Time</h3>
<p>B-side to <q>The Big Sky</q></p>
</hgroup>