# `pandoc-template-bootstrap-toc`
 
 A single-file [pandoc][] HTML5 [template][] using [Bootstrap 4.3][] and
 [Tocbot][].
 

 Place [`bootstrap-toc.html`](bootstrap-toc.html) in the `templates` directory
 (optionally in a subdirectory) in your pandoc [`--data-dir`][] (which defaults
 to `$XDG_DATA_HOME/pandoc`, `$HOME/.local/share/pandoc` or `$HOME/.pandoc` on
 Unix-like systems) and invoke pandoc with [`--template`][]`=bootstrap-toc.html`
 ( [`--template`][] implies [`--standalone`][]).
 
 To make this the default HTML template, symlink (or rename)
 `bootstrap-toc.html` to `$data_dir/default.html` (and
 `$data_dir/default.html5`). To enable templating without explicitly specifying
 one you need to use [`--standalone`][].
 
 Options you probably want include [`--toc`][], and perhaps

 [`--toc-depth`][]`=6`. Another nice option is [`--mathjax`][], which can take a
 URL. The pandoc default is something like the TeX only
 
 ```
 https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS_CHTML-full
 ```
 
 to also have AsciiMath available (with `%%` delimiters) use instead something
 like
 
 ```
 https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-MML-AM_CHTML-full
 ```

 [pandoc]: https://pandoc.org
 [template]: https://pandoc.org/MANUAL.html#templates
 [Bootstrap 4.3]: https://getbootstrap.com/docs/4.3
 [Tocbot]: https://tscanlin.github.io/tocbot

 [`--data-dir`]: https://pandoc.org/MANUAL.html#option--data-dir
 [`--template`]: https://pandoc.org/MANUAL.html#option--template
 [`--standalone`]: https://pandoc.org/MANUAL.html#option--standalone
 [`--toc`]: https://pandoc.org/MANUAL.html#option--toc
 [`--toc-depth`]: https://pandoc.org/MANUAL.html#option--toc-depth
 [`--mathjax`]: https://pandoc.org/MANUAL.html#option--mathjax

 
 ## License
 
 Licensed under the [ISC license][], see the [`LICENSE`](LICENSE) file.
 
 [ISC license]: https://en.wikipedia.org/wiki/ISC_license