HTML structure - Geonovum/respec GitHub Wiki

The HTML structure for ReSpec. Each section requires a header, e.g. <h2>Section title</h2>, and a unique identifier id='section-name' to be able to link to specific sections. Sections show up in the Table of Contents, unless a section contains the attribute: `class='notoc', it is possible to used such a section to wrap several elements that should not be included in the Table of Contents.

See w3schools for specific HTML elements, such as: images, tables, lists, comments, or text formatting (e.g. bold and italic). Also see W3C Sample Specification for ReSpec-specific formatting options. Nu HTML Checker can be used to check the HTML structure.

<section id='abstract'>
  <p>
  ...
  </p>
</section>

<section id='sotd'>
  <p>
  ...
  </p>
</section>

<section id='section-1'>
  <h2>Section title</h2>
    <p>
    ...
    </p>
    <section id='section-1.1'>
      <h3>Subsection title</h3>
        <p>
        ...
        </p>
    </section>
</section>