SwarmLab-HowTos/labs/Howtos/asciidoc/_includes/ex-section.adoc

////
Included in:

- user-manual: Sections
- quick-ref
////

// tag::base[]
= Document Title (Level 0)

== Level 1 Section Title

=== Level 2 Section Title

==== Level 3 Section Title

===== Level 4 Section Title

====== Level 5 Section Title

== Another Level 1 Section Title
// end::base[]

// tag::b-base[]
// the float style is required to create standalone (non-section) headings
[float]
= Document Title (Level 0)

[float]
== Level 1 Section Title

[float]
=== Level 2 Section Title

[float]
==== Level 3 Section Title

[float]
===== Level 4 Section Title

[float]
====== Level 5 Section Title

[float]
== Another Level 1 Section Title
// end::b-base[]

// tag::bad[]
= Document Title

= Illegal Level 0 Section (violates rule #1)

== First Section

==== Illegal Nested Section (violates rule #2)
// end::bad[]

// tag::content[]
== First Section

Content of first section

=== Nested Section

Content of nested section

== Second Section

Content of second section
// end::content[]

// tag::book[]
= Document Title (Level 0)

== Section Level 1

=== Section Level 2

==== Section Level 3

===== Section Level 4

====== Section Level 5

= Section Level 0
// end::book[]

// tag::b-book[]
// the float style is required to create standalone (non-section) headings
[float]
= Document Title (Level 0)

[float]
== Section Level 1

[float]
=== Section Level 2

[float]
==== Section Level 3

[float]
===== Section Level 4

[float]
====== Section Level 5

[float]
= Section Level 0
// end::b-book[]

// tag::with-anchor-shorthand[]
[#tiger-subspecies]
=== Subspecies of Tiger
// end::with-anchor-shorthand[]

// tag::with-anchor-and-reftext[]
[[tiger-subspecies,Tigers]]
=== Subspecies of Tiger
// end::with-anchor-and-reftext[]

// tag::with-anchor-and-reftext-shorthand[]
[#tiger-subspecies,reftext=Tigers]
=== Subspecies of Tiger
// end::with-anchor-and-reftext-shorthand[]

// tag::num-off[]
:sectnums!:

== Unnumbered Section
// end::num-off[]

// tag::num[]
= Document Title

:sectnums!:

== Colophon Section

== Another Colophon Section

== Last Colophon Section

:sectnums:

== Section One

== Section Two

== Section Three
// end::num[]

// tag::num-out[]
Colophon Section

Another Colophon Section

Last Colophon Section

1. Section One

2. Section Two

3. Section Three
// end::num-out[]

// tag::sectnuml[]
:sectnumlevels: 2 // <1>
// end::sectnuml[]

// tag::md[]
# Document Title (Level 0)

## Section Level 1

### Section Level 2

#### Section Level 3

##### Section Level 4

###### Section Level 5
// end::md[]

// tag::b-md[]
[float]
# Document Title (Level 0)

[float]
## Section Level 1

[float]
### Section Level 2

[float]
#### Section Level 3

[float]
##### Section Level 4

[float]
###### Section Level 5
// end::b-md[]