1. Left/Right margin Table Of Contents (TOC)

This TOC is located in the left or right side of the main content of the document.

You will used the standard toc2 attribute of AsciiDoc. See http://asciidoc.org/userguide.html#X91

2. Result with flatly theme

With this theme we will put a TOC in right margin of the document

Invoke the following command:

$ asciidoc
  -b bootstrap
  -f /path/to/examples/demo.conf
  -o toc2-sample2.html
  -a toc2
  -a toc-placement=right
  -a theme=flatly
  /path/to/examples/demo.asciidoc

And here are the final result that you should get.

Figure 1. My first TOC2 with flatly theme

3. Result with default theme

With this theme we will put a TOC in left margin of the document (default behavior).

Invoke the following command:

$ asciidoc
 -b bootstrap
 -f /path/to/examples/demo.conf
 -o toc2-sample.html
 -a toc2 /path/to/examples/demo.asciidoc

And here are the final result that you should get.

Figure 2. My first TOC2 with default theme

4. 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

invoke the following command:

$ asciidoc
  -b bootstrap
  -f /path/to/examples/bootstrap3.conf
  /path/to/examples/{docfile}
See
[http://asciidoc.org/userguide.html#X60]
for docfile attribute.

With this configuration file called bootstrap3.conf

[attributes]
linkcss
numbered
tocmmenu
toclevels=2
lang=en
jumbotron
jumbotron-fullwidth
totop
stylesheet=user.css
iconsfont=font-awesome
theme=readable
themeswitcher
themeswitcher-cookiethemename=adocbsexamples.bootstrapTheme.name
themeswitcher-cookiethemecss=adocbsexamples.bootstrapTheme.css
navbar=fixed
navinfo1
footer!
footer-fullwidth

And custom user stylesheet called user.css

a.toc-top-link {
    right: 0.5em;
    position: absolute;
}
.mm-menu {
    width: 70%;
}
.mm-listview .mm-next::before {
    border-left-style: none;
}
.jumbotron .toc-top-link {
    display: none;
}