# Customizing AsciiDoc-Bootstrap

Build your own version that will match your needs

Release v4.0.0 included the default Bootstrap theme and four more free themes from Bootswatch template provider.

If all those skins does not match your needs, you can either :

- download other alternative pre-compiled CSS (uncompressed and/or minified).

- download other alternative pre-setting templates (required the LESS source code).

- build yourself your own theme.

All these alternatives are not equals, and requires different skill.

# Switch theme

If you decide to modify LESS source files, remember that switching from one theme to another require only to change `theme` variable at line 2 in following file.

Source file `less/asciidoc-bootstrap.less`

     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    @import "variables.less";
    @theme:     "default";
    @themesdir: "../themes/@{theme}";

    // Bootstrap 3.3
    @import "bootstrap/bootstrap.less";
    @import "@{themesdir}/variables.less";

    // Font-Awesome 4.3
    @import "font-awesome/font-awesome.less";

    // Ionicons 2.0
    @import "ionicons/ionicons.less";

    // Octicons 2.1 with '@octicons-font-path' modified
    @import "octicons/octicons.less";

    // AsciiDoc 8.6
    @import "asciidoc/common.less";
    @import "asciidoc/pygments.less";
    @import "asciidoc/iconsfont.less";
    //@import "asciidoc/admonition-text.less";
    @import "asciidoc/admonition-iconsfont.less";

# Icons font support by Font-Awesome

If you don’t want to use Font-Awesome, just remove or comment line 10.

    //@import "font-awesome/font-awesome.less";

Be careful, that admonition block used Font-Awesome by default (see file `asciidoc/admonition-iconsfont.less` )

# Icons font support by Ionicons

If you don’t want to use Ionicons, just remove or comment line 13.

    //@import "ionicons/ionicons.less";

# Icons font support by Octicons

If you don’t want to use Octicons, just remove or comment line 16.

    //@import "octicons/octicons.less";

# Admonition Blocks

- If you want to use text rather then icons font or standard PNG image files, then you have to activate line 22 and comment line 23.

      @import "asciidoc/admonition-text.less";
      //@import "asciidoc/admonition-iconsfont.less";

- If you want to use icons font, don’t change anything.

- If you want to use only PNG image files ( with AsciiDoc `icons` attribute ), just remove or comment 23.

      //@import "asciidoc/admonition-iconsfont.less";

## Apply a theme

The AsciiDoc `theme` attribute is used to select an alternative CSS stylesheet.

E.g

    $ asciidoc.py -b bootstrap -a theme=united {docfile}