= {title}
:title:       Default TOC
:description: In this tutorial, we will learn how to add a table of contents at start of your AsciiDoc document
:doctitle:    Example for Asciidoc-Bootstrap - {title}


== Basic Table Of Contents (TOC)

[role="lead"]
A basic TOC start at top of your AsciiDoc document.

Example of Asciidoc document. See source text
footnote:[https://raw.github.com/llaville/asciidoc-bootstrap-backend/master/examples/demo.asciidoc].

NOTE: You will used the standard `toc` attribute of AsciiDoc.
See http://asciidoc.org/userguide.html#X91[]

== Result with flatly theme

Invoke the following command:
[source,bash]
----
$ asciidoc
  -b bootstrap
  -f /path/to/examples/demo.conf
  -o toc1-sample2.html
  -a toc
  -a theme=flatly
  /path/to/examples/demo.asciidoc
----

And here are the final result that you should get.

image::images/screenshots/toc1-sample2.png[link="toc1-sample2.html",title="My first TOC with flatly theme",role="thumbnail",options="align,responsive"]

== Result with default theme

Invoke the following command:
[source,bash]
----
$ asciidoc
  -b bootstrap
  -f /path/to/examples/demo.conf
  -o toc1-sample.html
  -a toc
  /path/to/examples/demo.asciidoc
----

And here are the final result that you should get.

image::images/screenshots/toc1-sample.png[link="toc1-sample.html",title="My first TOC with default theme",role="thumbnail",options="align,responsive"]

== About options @to generate documents@

We reused and group all common attributes to generate documents in a standard asciidoc configuration file called `demo.conf`.
..........................
[attributes]
linkcss
numbered
lang=en
jumbotron
jumbotron-fullwidth
totop
iconsfont=font-awesome
footer!
footer-fullwidth
..........................

include::gendocfile.asciidoc[]
