= {title}
:title:       Standard & Default Navbar
:description: In this tutorial, we will learn how to add a standard navbar with your Asciidoc document
:doctitle:    Example for Asciidoc-Bootstrap - {title}


== Basic navbar

[role="lead"]
To start, navbars are static (not fixed at the top) and include project name and basic navigation.

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

[CAUTION]
=====================================================================
You have to provide a `brand` and `navinfo` (or `navinfo1` or `navinfo2`) attributes to see something.
Otherwise you will see an empty navbar.
=====================================================================

== Result with default theme

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

NOTE: A navbar without links is useless. It's for demo purpose only.

And here are the final result that you should get.

image::images/screenshots/navbar-default-sample.png[link="navbar-default-sample.html",title="My first navbar",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 `demo4.conf`.
..........................
[attributes]
linkcss
numbered
lang=en
jumbotron
jumbotron-fullwidth!
totop
iconsfont=font-awesome
footer!
footer-fullwidth!
brand="My Project"
tocmmenu
stylesheet=user2.css
..........................

With custom user stylesheet called `user2.css`
[source,css]
----
include::user2.css[]
----

include::gendocfile.asciidoc[]