diff --git a/docs/assets/css/pygments-manni.css b/docs/assets/css/pygments-manni.css index e9e5c7ca..2bcc4143 100644 --- a/docs/assets/css/pygments-manni.css +++ b/docs/assets/css/pygments-manni.css @@ -1,6 +1,6 @@ .hll { background-color: #ffffcc } { background: #f0f3f3; } -.c { color: #0099FF; font-style: italic } /* Comment */ +.c { color: #999; } /* Comment */ .err { color: #AA0000; background-color: #FFAAAA } /* Error */ .k { color: #006699; } /* Keyword */ .o { color: #555555 } /* Operator */ diff --git a/docs/components.html b/docs/components.html index 62a47d7c..0aea4113 100644 --- a/docs/components.html +++ b/docs/components.html @@ -62,26 +62,26 @@ title: Components -
-<div class="dropdown"> - <!-- Link or button to toggle dropdown --> - <ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu"> - <li><a tabindex="-1" href="#">Action</a></li> - <li><a tabindex="-1" href="#">Another action</a></li> - <li><a tabindex="-1" href="#">Something else here</a></li> - <li class="divider"></li> - <li><a tabindex="-1" href="#">Separated link</a></li> - </ul> -</div> -+{% highlight html linenos %} +
Add .pull-right to a .dropdown-menu to right align the dropdown menu.
-<ul class="dropdown-menu pull-right" role="menu" aria-labelledby="dLabel">
+{% highlight html linenos %}
+
+{% endhighlight %}
Add .disabled to a <li> in the dropdown to disable the link.
-<ul class="dropdown-menu" role="menu" aria-labelledby="dropdownMenu"> - <li><a tabindex="-1" href="#">Regular link</a></li> - <li class="disabled"><a tabindex="-1" href="#">Disabled link</a></li> - <li><a tabindex="-1" href="#">Another link</a></li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %} @@ -118,46 +118,46 @@ title: Components
Wrap a series of buttons with .btn in .btn-group.
-<div class="btn-group"> - <button class="btn">Left</button> - <button class="btn">Middle</button> - <button class="btn">Right</button> -</div> -+{% highlight html linenos %} +
Combine sets of <div class="btn-group"> into a <div class="btn-toolbar"> for more complex components.
-<div class="btn-toolbar"> - <div class="btn-group"> - ... - </div> -</div> -+{% highlight html linenos %} + +{% endhighlight %}
Make a set of buttons appear vertically stacked rather than horizontally.
@@ -169,11 +169,11 @@ title: Components -
-<div class="btn-group btn-group-vertical">
+{% highlight html linenos %}
+
...
-</div>
-
+
+{% endhighlight %}
Justified button groups
Make a group of buttons stretch at the same size to span the entire width of its parent. This only works with <a> elements as the <button> doesn't pick up these styles.
@@ -184,11 +184,11 @@ title: Components
Middle
-
-<div class="btn-group btn-group-justified">
+{% highlight html linenos %}
+
...
-</div>
-
+
+{% endhighlight %}
@@ -316,36 +316,45 @@ title: Components
-
-<-- Single button -->
-<div class="btn-group">
- <button type="button" class="btn dropdown-toggle" data-toggle="dropdown">
- Action
- <span class="caret"></span>
- </button>
- <ul class="dropdown-menu">
- <!-- dropdown menu links -->
- </ul>
-</div>
+{% highlight html linenos %}
+
+
+
+
+
-<-- Split button -->
-<div class="btn-group">
- <button class="btn">Action</button>
- <button class="btn dropdown-toggle" data-toggle="dropdown">
- <span class="caret"></span>
- </button>
- <ul class="dropdown-menu">
- <!-- dropdown menu links -->
- </ul>
-</div>
-
+
+
+
+
+
+
+{% endhighlight %}
Works with all button sizes
Button dropdowns work at any size: .btn-large, .btn-small, or .btn-mini.
+{% highlight html linenos %}
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+{% endhighlight %}
Dropup buttons
Trigger dropdown menus above elements by adding .dropup to the parent.
@@ -405,17 +449,17 @@ title: Components
-
-<div class="btn-group dropup">
- <button class="btn">Dropup</button>
- <button class="btn dropdown-toggle" data-toggle="dropdown">
- <span class="caret"></span>
- </button>
- <ul class="dropdown-menu">
- <!-- dropdown menu links -->
- </ul>
-</div>
-
+{% highlight html linenos %}
+
+
+
+
+
+{% endhighlight %}
@@ -439,15 +483,13 @@ title: Components
-<ul class="nav nav-tabs"> - <li class="active"> - <a href="#">Home</a> - </li> - <li><a href="#">...</a></li> - <li><a href="#">...</a></li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %}
Swap the tabs class for .nav-list.
-<ul class="nav nav-list"> - <li class="active"> - <a href="#">Home</a> - </li> - <li><a href="#">...</a></li> - <li><a href="#">...</a></li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %}
Take that same HTML, but use .nav-pills instead:
-<ul class="nav nav-pills"> - <li class="active"> - <a href="#">Home</a> - </li> - <li><a href="#">...</a></li> - <li><a href="#">...</a></li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %}
Pills are also vertically stackable. Just add .nav-stacked.
-<ul class="nav nav-pills nav-stacked">
+{% highlight html linenos %}
+
+{% endhighlight %}
-<ul class="nav nav-tabs nav-justified">
+{% highlight html linenos %}
+
+
+{% endhighlight %}
For any nav component (tabs, pills, or list), add .disabled for gray links and no hover effects. Links will remain clickable, however, unless you remove the href attribute. Alternatively, you could implement custom JavaScript to prevent those clicks.
-<ul class="nav nav-pills">
+{% highlight html linenos %}
+
+{% endhighlight %}
+
To align nav links, use the .pull-left or .pull-right utility classes. Both classes will add a CSS float in the specified direction.
-<ul class="nav nav-tabs"> - <li class="dropdown"> - <a class="dropdown-toggle" - data-toggle="dropdown" - href="#"> - Dropdown - <b class="caret"></b> - </a> - <ul class="dropdown-menu"> - <!-- links --> - </ul> - </li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %}
-<ul class="nav nav-pills"> - <li class="dropdown"> - <a class="dropdown-toggle" - data-toggle="dropdown" - href="#"> - Dropdown - <b class="caret"></b> - </a> - <ul class="dropdown-menu"> - <!-- links --> - </ul> - </li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %} @@ -644,20 +684,16 @@ title: Components -
-<div class="navbar"> - <a class="brand" href="#">Title</a> - <ul class="nav"> - <li class="active"><a href="#">Home</a></li> - <li><a href="#">Link</a></li> - <li><a href="#">Link</a></li> - </ul> -</div> -- - -
-<a class="brand" href="#">Project name</a> -+{% highlight html linenos %} +Title +{% endhighlight %}
Nav items are simple to add via unordered lists.
@@ -683,15 +719,13 @@ title: Components --<ul class="nav"> - <li class="active"> - <a href="#">Home</a> - </li> - <li><a href="#">Link</a></li> - <li><a href="#">Link</a></li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %}
You can easily add dividers to your nav links with an empty list item and a simple class. Just add the appropriate class to <li> elements between links. Dividers will be horizontal to start, but at resolutions above 768px they become vertical with the navigation.
-<ul class="nav">
+{% highlight html linenos %}
+
+{% endhighlight %}
To properly style and position a form within the navbar, add the appropriate classes as shown below. For a default form, include .navbar-form and either .pull-left or .pull-right to properly align it.
-<form class="pull-left"> - <input type="text" style="width: 200px;"> - <button type="submit" class="btn">Submit</button> -</form> -+{% highlight html linenos %} + +{% endhighlight %}
Align nav links, search form, or text, use the .pull-left or .pull-right utility classes. Both classes will add a CSS float in the specified direction.
Add dropdowns and dropups to the nav with a bit of markup and the dropdowns JavaScript plugin.
--<ul class="nav"> - <li class="dropdown"> - <a href="#" class="dropdown-toggle" data-toggle="dropdown"> - Account - <b class="caret"></b> - </a> - <ul class="dropdown-menu"> - ... - </ul> - </li> -</ul> --
Visit the JavaScript dropdowns documentation for more markup and information on calling dropdowns.
Wrap strings of text in an element with .navbar-text, usually on a <p> tag for proper leading and color.
Fix the navbar to the top or bottom of the viewport with an additional class on the outermost div, .navbar.
-<div class="navbar navbar-fixed-top">
+{% highlight html linenos %}
+
+{% endhighlight %}
Fixed to bottom
Add .navbar-fixed-bottom instead.
@@ -796,11 +813,11 @@ title: Components
-
-<div class="navbar navbar-fixed-bottom">
+{% highlight html linenos %}
+
+{% endhighlight %}
Static top navbar
Create a full-width navbar that scrolls away with the page by adding .navbar-static-top. Unlike the .navbar-fixed-top class, you do not need to change any padding on the body.
@@ -816,14 +833,11 @@ title: Components
-
-<div class="navbar navbar-static-top">
+{% highlight html linenos %}
+
+{% endhighlight %}
Responsive navbar
@@ -873,40 +887,36 @@ title: Components
-
-
-
+
+
-
-<div class="navbar">
- <div class="container">
+{% highlight html linenos %}
+
+{% endhighlight %}
- </div>
-</div>
-
Heads up! The responsive navbar requires the collapse plugin and responsive Bootstrap CSS file.
-
-
-
Inverted variation
Modify the look of the navbar by adding .navbar-inverse.
@@ -957,11 +967,11 @@ title: Components
-
-<div class="navbar navbar-inverse">
+{% highlight html linenos %}
+
+{% endhighlight %}
@@ -989,13 +999,14 @@ title: Components
-<ul class="breadcrumb"> - <li><a href="#">Home</a></li> - <li><a href="#">Library</a></li> - <li class="active">Data</li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %} + @@ -1022,17 +1033,17 @@ title: Components
-<ul class="pagination"> - <li><a href="#">Prev</a></li> - <li><a href="#">1</a></li> - <li><a href="#">2</a></li> - <li><a href="#">3</a></li> - <li><a href="#">4</a></li> - <li><a href="#">5</a></li> - <li><a href="#">Next</a></li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %}
Links are customizable for different circumstances. Use .disabled for unclickable links and .active to indicate the current page.
-<ul class="pagination">
- <li class="disabled"><a href="#">«</a></li>
- <li class="active"><a href="#">1</a></li>
+{% highlight html linenos %}
+You can optionally swap out active or disabled anchors for spans to remove click functionality while retaining intended styles.
-
-<ul class="pagination">
- <li class="disabled"><span>«</span></li>
- <li class="active"><span>1</span></li>
+
+{% endhighlight %}
+ You can optionally swap out active or disabled anchors for <span> to remove click functionality while retaining intended styles.
+{% highlight html linenos %}
+Fancy larger or smaller pagination? Add .pagination-large, .pagination-small, or .pagination-mini for additional sizes.
-<ul class="pagination pagination-large"> - ... -</ul> -<ul class="pagination"> - ... -</ul> -<ul class="pagination pagination-small"> - ... -</ul> -<ul class="pagination pagination-mini"> - ... -</ul> -+{% highlight html linenos %} +
Quick previous and next links for simple pagination implementations with light markup and styles. It's great for simple sites like blogs or magazines.
@@ -1137,12 +1142,12 @@ title: Components-<ul class="pager"> - <li><a href="#">Previous</a></li> - <li><a href="#">Next</a></li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %}
Alternatively, you can align each link to the sides:
@@ -1152,16 +1157,13 @@ title: Components-<ul class="pager"> - <li class="previous"> - <a href="#">← Older</a> - </li> - <li class="next"> - <a href="#">Newer →</a> - </li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %} +
Pager links also use the general .disabled utility class from the pagination.
-<ul class="pager"> - <li class="previous disabled"> - <a href="#">← Older</a> - </li> - ... -</ul> -+{% highlight html linenos %} + +{% endhighlight %} + @@ -1195,12 +1196,9 @@ title: Components -
-<a href="#"> - Inbox - <span class="counter">42</span> -</a> -+{% highlight html linenos %} +Inbox 42 +{% endhighlight %}
When there are no new or unread items, counters will simply collapse (via CSS's :empty selector) provided no content exists within.
-<ul class="nav nav-list"> - <li class="active"> - <a href="#">Home</a> - </li> - <li><a href="#">...</a></li> - <li><a href="#">...</a></li> -</ul> -+{% highlight html linenos %} + +{% endhighlight %} @@ -1260,17 +1260,13 @@ title: Components -
-<div class="jumbotron"> - <h1>Heading</h1> - <p>Tagline</p> - <p> - <a class="btn btn-primary btn-large"> - Learn more - </a> - </p> -</div> -+{% highlight html linenos %} + +{% endhighlight %}
A simple shell for an h1 to appropriately space out and segment sections of content on a page. It can utilize the h1's default small, element as well most other components (with additional styles).
-<div class="page-header"> - <h1>Example page header <small>Subtext for header</small></h1> -</div> -+{% highlight html linenos %} +
-<div class="row">
- <div class="span3">
- <a href="#" class="thumbnail">
- <img src="holder.js/260x180" alt="">
- </a>
- </div>
+{% highlight html linenos %}
+
+
+
+
+
+
...
-</div>
-
+
+{% endhighlight %}
Custom content thumbnails
With a bit of extra markup, it's possible to add any kind of HTML content like headings, paragraphs, or buttons into thumbnails.
@@ -1370,18 +1366,22 @@ title: Components
-
-<div class="row">
- <div class="span4">
- <div class="thumbnail">
- <img data-src="holder.js/300x200" alt="">
- <h3>Thumbnail label</h3>
- <p>Thumbnail caption...</p>
- </div>
- </div>
+{% highlight html linenos %}
+
+{% endhighlight %}
+
@@ -1404,12 +1404,12 @@ title: Components
Warning! Best check yo self, you're not looking too good.
-
-<div class="alert">
- <button type="button" class="close" data-dismiss="alert">×</button>
- <strong>Warning!</strong> Best check yo self, you're not looking too good.
-</div>
-
+{% highlight html linenos %}
+
+
+ Warning! Best check yo self, you're not looking too good.
+
+{% endhighlight %}
Block alerts
For longer messages, increase the padding on the top and bottom of the alert wrapper by adding .alert-block.
@@ -1420,13 +1420,13 @@ title: Components
Best check yo self, you're not looking too good. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.
-
-<div class="alert alert-block">
- <button type="button" class="close" data-dismiss="alert">×</button>
- <h4>Warning!</h4>
- Best check yo self, you're not...
-</div>
-
+{% highlight html linenos %}
+
+
+ Warning!
+ ...
+
+{% endhighlight %}
Contextual alternatives
Add optional classes to change an alert's connotation.
@@ -1444,11 +1444,11 @@ title: Components
Heads up! This alert needs your attention, but it's not super important.
-
-<div class="alert alert-error">... </div>
-<div class="alert alert-success">...</div>
-<div class="alert alert-info">...</div>
-
+{% highlight html linenos %}
+...
+...
+...
+{% endhighlight %}
@@ -1471,11 +1471,11 @@ title: Components
-
-<div class="progress">
- <div class="progress-bar" style="width: 60%;"></div>
-</div>
-
+{% highlight html linenos %}
+
+
+
+{% endhighlight %}
Additional colors
Progress bars use some of the same button and alert classes for consistent styles.
@@ -1493,20 +1493,20 @@ title: Components
-
-<div class="progress">
- <div class="progress-bar progress-bar-info" style="width: 20%"></div>
-</div>
-<div class="progress">
- <div class="progress-bar progress-bar-success" style="width: 40%"></div>
-</div>
-<div class="progress">
- <div class="progress-bar progress-bar-warning" style="width: 60%"></div>
-</div>
-<div class="progress">
- <div class="progress-bar progress-bar-danger" style="width: 80%"></div>
-</div>
-
+{% highlight html linenos %}
+
+
+
+
+
+
+
+
+
+
+
+
+{% endhighlight %}
Striped
Uses a gradient to create a striped effect. Not available in IE8.
@@ -1524,20 +1524,20 @@ title: Components
-
-<div class="progress progress-striped">
- <div class="progress-bar progress-bar-info" style="width: 20%"></div>
-</div>
-<div class="progress progress-striped">
- <div class="progress-bar progress-bar-success" style="width: 40%"></div>
-</div>
-<div class="progress progress-striped">
- <div class="progress-bar progress-bar-warning" style="width: 60%"></div>
-</div>
-<div class="progress progress-striped">
- <div class="progress-bar progress-bar-danger" style="width: 80%"></div>
-</div>
-
+{% highlight html linenos %}
+
+
+
+
+
+
+
+
+
+
+
+
+{% endhighlight %}
Animated
Add .active to .progress-striped to animate the stripes right to left. Not available in all versions of IE.
@@ -1546,11 +1546,11 @@ title: Components
-
-<div class="progress progress-striped active">
- <div class="progress-bar" style="width: 40%;"></div>
-</div>
-
+{% highlight html linenos %}
+
+
+
+{% endhighlight %}
Stacked
Place multiple bars into the same .progress to stack them.
@@ -1561,13 +1561,13 @@ title: Components
-
-<div class="progress">
- <div class="progress-bar progress-bar-success" style="width: 35%;"></div>
- <div class="progress-bar progress-bar-warning" style="width: 20%;"></div>
- <div class="progress-bar progress-bar-danger" style="width: 10%;"></div>
-</div>
-
+{% highlight html linenos %}
+
+
+
+
+
+{% endhighlight %}
@@ -1613,22 +1613,17 @@ title: Components
-
-<div class="media">
- <a class="pull-left" href="#">
- <img class="media-object" data-src="holder.js/64x64">
- </a>
- <div class="media-body">
- <h4 class="media-heading">Media heading</h4>
+{% highlight html linenos %}
+
+
+
+
+
+ Media heading
...
-
- <!-- Nested media object -->
- <div class="media">
- ...
- </div>
- </div>
-</div>
-
+
+
+{% endhighlight %}
Media list
With a bit of extra markup, you can use media inside list (useful for comment threads or articles lists).
@@ -1684,24 +1679,19 @@ title: Components
-
-<ul class="media-list">
- <li class="media">
- <a class="pull-left" href="#">
- <img class="media-object" data-src="holder.js/64x64">
- </a>
- <div class="media-body">
- <h4 class="media-heading">Media heading</h4>
+{% highlight html linenos %}
+-<div class="well"> - ... -</div> -+{% highlight html linenos %} +
Control padding and rounded corners with two optional modifier classes.
-<div class="well well-large"> - ... -</div> -+{% highlight html linenos %} +
-<div class="well well-small"> - ... -</div> -+{% highlight html linenos %} +
Use the generic close icon for dismissing content like modals and alerts.
<button class="close">×</button>-
iOS devices require an href="#" for click events if you would rather use an anchor.
<a class="close" href="#">×</a>+{% highlight html linenos %} + +{% endhighlight %}
Simple, focused classes for small display or behavior tweaks.
Float an element left
--class="pull-left" --
+{% highlight html linenos %}
+...
+{% endhighlight %}
+{% highlight css linenos %}
.pull-left {
float: left;
}
-
+{% endhighlight %}
Float an element right
--class="pull-right" --
+{% highlight html linenos %}
+...
+{% endhighlight %}
+{% highlight css linenos %}
.pull-right {
float: right;
}
-
+{% endhighlight %}
Change an element's color to #999
-class="muted" --
+{% highlight html linenos %}
+...
+{% endhighlight %}
+{% highlight css linenos %}
.muted {
color: #999;
}
-
+{% endhighlight %}
+
Clear the float on any element. Utilizes the micro clearfix as popularized by Nicolas Gallagher.
-class="clearfix" --
+{% highlight html linenos %}
+...
+{% endhighlight %}
+{% highlight css linenos %}
.clearfix {
&:before,
&:after {
@@ -1812,7 +1799,8 @@ class="clearfix"
clear: both;
}
}
-
+{% endhighlight %}
+