rewrite the split button dropdowns section

docs/components.html

@@ -196,11 +196,11 @@
     <h1>Button dropdown menus <small>Built on button groups to provide contextual menus</small></h1>
   </div>
 
-  <h2>Button dropdowns</h2>
 
-  <h3>Overview and examples</h3>
+  <h2>Overview and examples</h2>
   <p>Use any button to trigger a dropdown menu by placing it within a <code>.btn-group</code> and providing the proper menu markup.</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
       <div class="btn-group">
         <button class="btn dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
         <ul class="dropdown-menu">
@@ -231,8 +231,6 @@
           <li><a href="#">Separated link</a></li>
         </ul>
       </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
       <div class="btn-group">
         <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown">Warning <span class="caret"></span></button>
         <ul class="dropdown-menu">
@@ -274,9 +272,7 @@
         </ul>
       </div><!-- /btn-group -->
     </div><!-- /btn-toolbar -->
-
-  <h3>Example markup</h3>
-  <p>Similar to a button group, our markup uses regular button markup, but with a handful of additions to refine the style and support Bootstrap's dropdown jQuery plugin.</p>
+  </div>
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
   &lt;a class="btn dropdown-toggle" data-toggle="dropdown" href="#"&gt;
@@ -291,7 +287,8 @@
 
   <h3>Works with all button sizes</h3>
   <p>Button dropdowns work at any size. your button sizes to <code>.btn-large</code>, <code>.btn-small</code>, or <code>.btn-mini</code>.</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
       <div class="btn-group">
         <button class="btn btn-large dropdown-toggle" data-toggle="dropdown">Large button <span class="caret"></span></button>
         <ul class="dropdown-menu">
@@ -323,18 +320,20 @@
         </ul>
       </div><!-- /btn-group -->
     </div><!-- /btn-toolbar -->
+  </div>
 
   <h3>Requires javascript</h3>
   <p>Button dropdowns require the <a href="./javascript.html#dropdowns">Bootstrap dropdown plugin</a> to function.</p>
   <p>In some cases&mdash;like mobile&mdash;dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.</p>
 
-  <br>
+
+  <hr class="bs-docs-separator">
+
 
   <h2>Split button dropdowns</h2>
-
-  <h3>Overview and examples</h3>
   <p>Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
       <div class="btn-group">
         <button class="btn">Action</button>
         <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
@@ -368,8 +367,6 @@
           <li><a href="#">Separated link</a></li>
         </ul>
       </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
       <div class="btn-group">
         <button class="btn btn-warning">Warning</button>
         <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
@@ -403,8 +400,6 @@
           <li><a href="#">Separated link</a></li>
         </ul>
       </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
       <div class="btn-group">
         <button class="btn btn-inverse">Inverse</button>
         <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
@@ -417,8 +412,22 @@
         </ul>
       </div><!-- /btn-group -->
     </div><!-- /btn-toolbar -->
+  </div>
+<pre class="prettyprint linenums">
+&lt;div class="btn-group"&gt;
+  &lt;button class="btn"&gt;Action&lt;/button&gt;
+  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
+    &lt;span class="caret"&gt;&lt;/span&gt;
+  &lt;/button&gt;
+  &lt;ul class="dropdown-menu"&gt;
+    &lt;!-- dropdown menu links --&gt;
+  &lt;/ul&gt;
+&lt;/div&gt;
+</pre>
+
   <h3>Sizes</h3>
   <p>Utilize the extra button classes <code>.btn-mini</code>, <code>.btn-small</code>, or <code>.btn-large</code> for sizing.</p>
+  <div class="bs-docs-example">
     <div class="btn-toolbar">
       <div class="btn-group">
         <button class="btn btn-large">Large action</button>
@@ -458,21 +467,11 @@
         </ul>
       </div><!-- /btn-group -->
     </div><!-- /btn-toolbar -->
+  </div>
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
-  ...
-  &lt;ul class="dropdown-menu pull-right"&gt;
-    &lt;!-- dropdown menu links --&gt;
-  &lt;/ul&gt;
-&lt;/div&gt;
-</pre>
-
-  <h3>Example markup</h3>
-  <p>We expand on the normal button dropdowns to provide a second button action that operates as a separate dropdown trigger.</p>
-<pre class="prettyprint linenums">
-&lt;div class="btn-group"&gt;
-  &lt;button class="btn"&gt;Action&lt;/button&gt;
-  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
+  &lt;button class="btn btn-mini"&gt;Action&lt;/button&gt;
+  &lt;button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"&gt;
     &lt;span class="caret"&gt;&lt;/span&gt;
   &lt;/button&gt;
   &lt;ul class="dropdown-menu"&gt;
@@ -480,9 +479,11 @@
   &lt;/ul&gt;
 &lt;/div&gt;
 </pre>
+
   <h3>Dropup menus</h3>
   <p>Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of <code>.dropdown-menu</code>. It will flip the direction of the <code>.caret</code> and reposition the menu itself to move from the bottom up instead of top down.</p>
-  <div class="btn-toolbar" style="margin-top: 9px;">
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
       <div class="btn-group dropup">
         <button class="btn">Dropup</button>
         <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
@@ -506,6 +507,7 @@
         </ul>
       </div><!-- /btn-group -->
     </div>
+  </div>
 <pre class="prettyprint linenums">
 &lt;div class="btn-group dropup"&gt;
   &lt;button class="btn"&gt;Dropup&lt;/button&gt;

docs/templates/pages/components.mustache

@@ -119,11 +119,11 @@
     <h1>{{_i}}Button dropdown menus{{/i}} <small>{{_i}}Built on button groups to provide contextual menus{{/i}}</small></h1>
   </div>
 
-  <h2>{{_i}}Button dropdowns{{/i}}</h2>
 
-  <h3>{{_i}}Overview and examples{{/i}}</h3>
+  <h2>{{_i}}Overview and examples{{/i}}</h2>
   <p>{{_i}}Use any button to trigger a dropdown menu by placing it within a <code>.btn-group</code> and providing the proper menu markup.{{/i}}</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
       <div class="btn-group">
         <button class="btn dropdown-toggle" data-toggle="dropdown">{{_i}}Action{{/i}} <span class="caret"></span></button>
         <ul class="dropdown-menu">
@@ -154,8 +154,6 @@
           <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
         </ul>
       </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
       <div class="btn-group">
         <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown">{{_i}}Warning{{/i}} <span class="caret"></span></button>
         <ul class="dropdown-menu">
@@ -197,9 +195,7 @@
         </ul>
       </div><!-- /btn-group -->
     </div><!-- /btn-toolbar -->
-
-  <h3>{{_i}}Example markup{{/i}}</h3>
-  <p>{{_i}}Similar to a button group, our markup uses regular button markup, but with a handful of additions to refine the style and support Bootstrap's dropdown jQuery plugin.{{/i}}</p>
+  </div>{{! /example }}
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
   &lt;a class="btn dropdown-toggle" data-toggle="dropdown" href="#"&gt;
@@ -214,7 +210,8 @@
 
   <h3>{{_i}}Works with all button sizes{{/i}}</h3>
   <p>{{_i}}Button dropdowns work at any size. your button sizes to <code>.btn-large</code>, <code>.btn-small</code>, or <code>.btn-mini</code>.{{/i}}</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
       <div class="btn-group">
         <button class="btn btn-large dropdown-toggle" data-toggle="dropdown">{{_i}}Large button{{/i}} <span class="caret"></span></button>
         <ul class="dropdown-menu">
@@ -246,18 +243,20 @@
         </ul>
       </div><!-- /btn-group -->
     </div><!-- /btn-toolbar -->
+  </div>{{! /example }}
 
   <h3>{{_i}}Requires javascript{{/i}}</h3>
   <p>{{_i}}Button dropdowns require the <a href="./javascript.html#dropdowns">Bootstrap dropdown plugin</a> to function.{{/i}}</p>
   <p>{{_i}}In some cases&mdash;like mobile&mdash;dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.{{/i}}</p>
 
-  <br>
+
+  <hr class="bs-docs-separator">
+
 
   <h2>{{_i}}Split button dropdowns{{/i}}</h2>
-
-  <h3>{{_i}}Overview and examples{{/i}}</h3>
   <p>{{_i}}Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.{{/i}}</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
       <div class="btn-group">
         <button class="btn">{{_i}}Action{{/i}}</button>
         <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
@@ -291,8 +290,6 @@
           <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
         </ul>
       </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
       <div class="btn-group">
         <button class="btn btn-warning">{{_i}}Warning{{/i}}</button>
         <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
@@ -326,8 +323,6 @@
           <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
         </ul>
       </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
       <div class="btn-group">
         <button class="btn btn-inverse">{{_i}}Inverse{{/i}}</button>
         <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
@@ -340,8 +335,22 @@
         </ul>
       </div><!-- /btn-group -->
     </div><!-- /btn-toolbar -->
+  </div>{{! /example }}
+<pre class="prettyprint linenums">
+&lt;div class="btn-group"&gt;
+  &lt;button class="btn"&gt;{{_i}}Action{{/i}}&lt;/button&gt;
+  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
+    &lt;span class="caret"&gt;&lt;/span&gt;
+  &lt;/button&gt;
+  &lt;ul class="dropdown-menu"&gt;
+    &lt;!-- {{_i}}dropdown menu links{{/i}} --&gt;
+  &lt;/ul&gt;
+&lt;/div&gt;
+</pre>
+
   <h3>{{_i}}Sizes{{/i}}</h3>
   <p>{{_i}}Utilize the extra button classes <code>.btn-mini</code>, <code>.btn-small</code>, or <code>.btn-large</code> for sizing.{{/i}}</p>
+  <div class="bs-docs-example">
     <div class="btn-toolbar">
       <div class="btn-group">
         <button class="btn btn-large">{{_i}}Large action{{/i}}</button>
@@ -381,21 +390,11 @@
         </ul>
       </div><!-- /btn-group -->
     </div><!-- /btn-toolbar -->
+  </div>{{! /example }}
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
-  ...
-  &lt;ul class="dropdown-menu pull-right"&gt;
-    &lt;!-- {{_i}}dropdown menu links{{/i}} --&gt;
-  &lt;/ul&gt;
-&lt;/div&gt;
-</pre>
-
-  <h3>{{_i}}Example markup{{/i}}</h3>
-  <p>{{_i}}We expand on the normal button dropdowns to provide a second button action that operates as a separate dropdown trigger.{{/i}}</p>
-<pre class="prettyprint linenums">
-&lt;div class="btn-group"&gt;
-  &lt;button class="btn"&gt;{{_i}}Action{{/i}}&lt;/button&gt;
-  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
+  &lt;button class="btn btn-mini"&gt;{{_i}}Action{{/i}}&lt;/button&gt;
+  &lt;button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"&gt;
     &lt;span class="caret"&gt;&lt;/span&gt;
   &lt;/button&gt;
   &lt;ul class="dropdown-menu"&gt;
@@ -403,9 +402,11 @@
   &lt;/ul&gt;
 &lt;/div&gt;
 </pre>
+
   <h3>{{_i}}Dropup menus{{/i}}</h3>
   <p>{{_i}}Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of <code>.dropdown-menu</code>. It will flip the direction of the <code>.caret</code> and reposition the menu itself to move from the bottom up instead of top down.{{/i}}</p>
-  <div class="btn-toolbar" style="margin-top: 9px;">
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
       <div class="btn-group dropup">
         <button class="btn">{{_i}}Dropup{{/i}}</button>
         <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
@@ -429,6 +430,7 @@
         </ul>
       </div><!-- /btn-group -->
     </div>
+  </div>{{! /example }}
 <pre class="prettyprint linenums">
 &lt;div class="btn-group dropup"&gt;
   &lt;button class="btn"&gt;{{_i}}Dropup{{/i}}&lt;/button&gt;