anchor.diff:  include::attributes.asciidoc[]
   :navinfo2:
   :icons!:
  -:iconsfont: font-awesome
  -:iconsfontdir: ./fonts/font-awesome
  -:stylesheet: admonition-iconsfont.css
  -
  -ifdef::basebackend-bootstrap[]
  -:span3:   col-md-3
  -:options: responsive
  -:icon-prefix: glyphicon-
  -endif::[]
  -
  -ifndef::basebackend-bootstrap[]
  -:span3:
  -:options:
  -:icon-prefix:
  -endif::[]
  +:iconsfont:   font-awesome
   
   
   == Download
   
  -=== Download the asciidoc backend
  -
  -link:http://laurent-laville.org/asciidoc/bootstrap/bootstrap-{revnumber}.zip["Download version {revnumber}",role="success",icon="{icon-prefix}download",options="block,white"]
  +[role="col-md-6"]
  +.Backend
  +--
  +Uncompressed, Minified CSS and Javascripts, and Fonts.
  +Source files are included but without html documentation.
  +
  +ifdef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/bootstrap-{revnumber}.zip["Download backend",role="primary",icon="glyphicon-download-alt",options="block,white"]
  +endif::[]
  +
  +ifndef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/bootstrap-{revnumber}.zip[Download backend]
  +endif::[]
  +--
  +
  +[role="col-md-6"]
  +.Documentation
  +--
  +User documentation built with AsciiDoc-Boostrap backend and the Cerulean theme is available to read it offline.
  +
  +ifdef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/userdoc-{revnumber}.zip["Download html documentation",role="primary",icon="glyphicon-download-alt",options="block,white"]
  +endif::[]
  +
  +ifndef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/userdoc-{revnumber}.zip[Download html documentation]
  +endif::[]
  +--
  +
  +unfloat::[]
   
   Install as any other plugins:
   ----
  -$ asciidoc --backend install bootstrap-<version>.zip
  -----
  -NOTE: `<version>` is to be replaced by the latest version available of the backend.
  +$ asciidoc.py --backend install bootstrap-<version>.zip
  +----
  +NOTE: `<version>` is to be replaced by the latest version available of the backend. Currently is {revnumber}
   
   [NOTE]
   =====================================================================
  -The Asciidoc bootstrap backend standard version included :
  -
  -* version 2.3.2 ( +themes/2+ ) and 3.1.0 ( +themes/3+ ) of the default theme from http://bootswatch.com/[Bootswatch] template provider.
  -* version 2.3.2 ( +bootstrap/2+ ) and 3.1.1 ( +bootstrap/3+ ) of Bootstrap.
  -* version 4.0.3 ( +fonts/font-awesome/+ ) of Font-Awesome.
  +The Asciidoc Bootstrap backend standard version included :
  +
  +* version 3.1.1+1 ( +themes/+ ) of the default, flatly, readable, cerulean and united themes from http://bootswatch.com/[Bootswatch] template provider.
  +* version 3.1.1 ( +bootstrap/+, +less/bootstrap/+ ) of http://getbootstrap.com[Bootstrap].
  +* version 4.0.3 ( +fonts/+, +/less/font-awesome/+ ) of http://fortawesome.github.io/Font-Awesome/[Font-Awesome].
  +* version 1.5.2 ( +fonts/+, +less/ionicons/+ ) of http://ionicons.com/[Ionicons].
   =====================================================================
   
  -You can download additional themes AsciiDoc-Bootstrap backend v3 ready.
  -
  -image::images/flatly.png[link="http://bootswatch.com/flatly",title="Flatly theme",role="thumbnail",style="{span3}",options="{options}"]
  -image::images/readable.png[link="http://bootswatch.com/readable",title="Readable theme",role="thumbnail",style="{span3}",options="{options}"]
  -image::images/cerulean.png[link="http://bootswatch.com/cerulean",title="Cerulean theme",role="thumbnail",style="{span3}",options="{options}"]
  -
  -.For Bootstrap 3
  -* http://laurent-laville.org/asciidoc/bootstrap/flatly-theme3-3.1.0.zip[]
  -* http://laurent-laville.org/asciidoc/bootstrap/readable-theme3-3.1.0.zip[]
  -* http://laurent-laville.org/asciidoc/bootstrap/cerulean-theme3-3.1.0.zip[]
  -
  -.For Bootstrap 2
  -* http://laurent-laville.org/asciidoc/bootstrap/flatly-theme2-3.0.2.zip[]
  -* http://laurent-laville.org/asciidoc/bootstrap/readable-theme2-3.0.2.zip[]
  -* http://laurent-laville.org/asciidoc/bootstrap/cerulean-theme2-3.0.2.zip[]
  -
  -Extract archive contents in +themes/2/+ or +themes/3/+ folder of the backend distribution.
  +=== Themes from Bootswatch _a free template provider_
  +
  +[role="lead"]
  +AsciiDoc-Bootstrap backend v4 standard distribution included these following templates :
  +
  +You can download pre-compiled CSS (uncompressed and/or minified) with default behavior :
  +
  +* Admonition blocks used Font-Awesome icons font
  +* Support both Glyphicon, Font-Awesome and Ionicons icons font
  +
  +TIP: These files are already included in AsciiDoc-Bootstrap backend standard distribution (see +stylesheets/+ folder)
  +
  +[role="col-md-4"]
  +====
  +[panel,info]
  +.Basic Flatly theme
  +--
  +image::images/flatly.png[link="http://bootswatch.com/flatly",options="responsive"]
  +
  +ifdef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.flatly.min.css["asciidoc-bootstrap.flatly.min.css",role="info",icon="glyphicon-download-alt",options="block,white"]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.flatly.css["asciidoc-bootstrap.flatly.css",role="info",icon="glyphicon-download-alt",options="block,white"]
  +endif::[]
  +
  +ifndef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.flatly.min.css[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.flatly.css[]
  +endif::[]
  +--
  +====
  +
  +[role="col-md-4"]
  +====
  +[panel,info]
  +.Basic Readable theme
  +--
  +image::images/readable.png[link="http://bootswatch.com/readable",options="responsive"]
  +
  +ifdef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.readable.min.css["asciidoc-bootstrap.readable.min.css",role="info",icon="glyphicon-download-alt",options="block,white"]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.readable.css["asciidoc-bootstrap.readable.css",role="info",icon="glyphicon-download-alt",options="block,white"]
  +endif::[]
  +
  +ifndef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.readable.min.css[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.readable.css[]
  +endif::[]
  +--
  +====
  +
  +[role="col-md-4"]
  +====
  +[panel,info]
  +.Basic Cerulean theme
  +--
  +image::images/cerulean.png[link="http://bootswatch.com/cerulean",options="responsive"]
  +
  +ifdef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.cerulean.min.css["asciidoc-bootstrap.cerulean.min.css",role="info",icon="glyphicon-download-alt",options="block,white"]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.cerulean.css["asciidoc-bootstrap.cerulean.css",role="info",icon="glyphicon-download-alt",options="block,white"]
  +endif::[]
  +
  +ifndef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.cerulean.min.css[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.cerulean.css[]
  +endif::[]
  +--
  +====
  +
  +[role="col-md-4"]
  +====
  +[panel,info]
  +.Basic United theme
  +--
  +image::images/united.png[link="http://bootswatch.com/united",options="responsive"]
  +
  +ifdef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.united.min.css["asciidoc-bootstrap.united.min.css",role="info",icon="glyphicon-download-alt",options="block,white"]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.united.css["asciidoc-bootstrap.united.css",role="info",icon="glyphicon-download-alt",options="block,white"]
  +endif::[]
  +
  +ifndef::basebackend-bootstrap[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.united.min.css[]
  +link:http://laurent-laville.org/asciidoc/bootstrap/asciidoc-bootstrap.united.css[]
  +endif::[]
  +--
  +====
  +
   
   == File structure
   
  
positive.code: ----
   bootstrap/
    ├── bootstrap/
    │   ├── 2/
    │   │   ├── css/
    │   │   ├── js/
    │   │   └── img/
    │   └── 3/
    │       ├── css/
    │       ├── js/
    │       └── fonts/
    ├── docs/
    ├── examples/
    ├── images/
    │   ├── icons/
    │   │   ├── apple-touch-icon-57-precomposed.png
    │   │   ├── apple-touch-icon-72-precomposed.png
    │   │   ├── apple-touch-icon-114-precomposed.png
    │   │   ├── apple-touch-icon-144-precomposed.png
    │   │   ├── ui.totop.png
    │   │   └── favicon.ico
    ├── javascripts/
    │   ├── asciidoc.js
    │   ├── jquery.min.js
    │   └── jquery.ui.totop.min.js
    ├── stylesheets/
    │   ├── asciidoc-bootstrap.css
    │   ├── ui.totop.css
    │   ├── iconfonts-bootstrap.css
    │   ├── pygments-bootstrap.css
    │   └── pygments.monokai.css
    │   └── pygments.pastie.css
    │   └── pygments.css
    ├── fonts/
    │   └── font-awesome/
    └── themes
        ├── 2/
        │   ├── img/
        │   └── default/
        │       ├── bootstrap.css
        │       ├── bootstrap.min.css
        │       ├── default.css
        │       ├── default.js
        │       └── user.css
        └── 3/
            ├── fonts/
            └── default/
                ├── bootstrap.css
                ├── bootstrap.min.css
                ├── default.css
                ├── default.js
                └── user.css
  ----
  
  NOTE: The default theme follow the basic look and feel of Bootstrap 2 or 3
  
  == Attributes
  
  [role="lead"]
  Specifics bootstrap backend attributes
  
  [options="header", cols="1,7", role="table table-bordered"]
  |===========================
  | Name | Description
  | bootstrapdir | The name of the directory containing the boostrap compiled version resources.
  | sidebar      | The TOC can be place on a sidebar on _left_ (default value) or _right_ of the main document body.
  | brand        | A simple link to show your brand or project name
  | brandref     | A link to the main page of your project. By default it's a simple anchor #
  | brandver     | Control display of a dynamic versions list of your project.
  | navinfo,
  navinfo1,
  navinfo2
  | Control which navigation information files will be included in the output file.
  | footer       | Control which footer informations will be included in the output file.
  | totop        | Control which _back to top_ system you want to include in the output file.
  | jumbotron    | Enhance the title of the document.
  | jumbotron-fullwidth
  | Enhance the title of the document with a full width jumbotron in all resolution.
  | navbar       | Define the style of navigation bar: _default_ (default value), _fixed_ or _static_.
  | navbar-inverse
  | Inverted variation of the basic navbar.
  | pygments-style
  | Change the Pygments style. Default theme is `emacs` with a variant background: the one provided by AsciiDoc.
  | iconsfont    | The name of the icons font provider: either `glyphicon`, `font-awesome`, `ionicons` or `icomoon`.
  | iconsfontdir | The name of the directory containing linked icons stylesheets and fonts files.
  | rssref       | Specify an URL of RSS feed to be linked with output document.
  | favicon      | Add a link to your favorite icon
  | tocaffix     | Use Bootstrap affix plugin to pin the TOC2 on left or right side triggered at offset specified.
  |===========================
  
  == Your own theme
  
  The AsciiDoc `theme` attribute is used to select an alternative CSS stylesheet
  and to optionally include additional JavaScript code.
  
  * Theme files are located by default (in the distribution) from the configuration directory named `themes/<bsver>/<theme>/`
  (where `<theme>` is the the theme name set by the theme attribute, and `<bsver>` identify the major Bootstrap version (2 or 3).
  * The `<theme>.css` file replaces some declarations from the standard (bootswatch) theme.
  * The `user.css` empty file is available for you to make your own changes.
  * The `<theme>.js` file is included in addition to the default `asciidoc.js` JavaScript file.
  
  == What is next?
  
  
negative.code: Inline Macros occur in an inline element context. Predefined Inline
  macros include 'image' and 'link' macros.
  
  === link:attributes-ref.html[Backend Attributes]
  
  List all specifics attributes of this backend.
  
  === link:customizing.html[Customizing]
  
  AsciiDoc-Bootstrap v4 includes support of http://lesscss.org[LESS] 
  one of the most popular CSS preprocessor. 
  
  Easy to maintain, and change skins of your favorite Asciidoc documents.
  
  
  footnote:[{rawbaseurl}/docs/getting-started.asciidoc].
  