From a683497dbc0f9cc3f883f195206e87589d09caaf Mon Sep 17 00:00:00 2001 From: Mark Otto <markotto@twitter.com> Date: Wed, 27 Jun 2012 23:56:00 -0700 Subject: [PATCH] renamed less.html to extend.html, removing all the vars and mixins --- docs/base-css.html | 6 +- docs/components.html | 6 +- docs/download.html | 6 +- docs/examples.html | 6 +- docs/extend.html | 205 +++++ docs/index.html | 6 +- docs/javascript.html | 6 +- docs/less.html | 1052 -------------------------- docs/scaffolding.html | 6 +- docs/templates/layout.mustache | 6 +- docs/templates/pages/extend.mustache | 90 +++ docs/templates/pages/less.mustache | 937 ----------------------- docs/upgrading.html | 6 +- 13 files changed, 322 insertions(+), 2016 deletions(-) create mode 100644 docs/extend.html delete mode 100644 docs/less.html create mode 100644 docs/templates/pages/extend.mustache delete mode 100644 docs/templates/pages/less.mustache diff --git a/docs/base-css.html b/docs/base-css.html index 9eed2bea23..2b679d994c 100644 --- a/docs/base-css.html +++ b/docs/base-css.html @@ -57,9 +57,6 @@ <li class=""> <a href="./javascript.html">Javascript</a> </li> - <li class=""> - <a href="./less.html">LESS</a> - </li> <li class="divider-vertical"></li> <li class=""> <a href="./download.html">Customize</a> @@ -67,6 +64,9 @@ <li class=""> <a href="./examples.html">Examples</a> </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> </ul> </div> </div> diff --git a/docs/components.html b/docs/components.html index 74dda4dc80..0c81aefa52 100644 --- a/docs/components.html +++ b/docs/components.html @@ -57,9 +57,6 @@ <li class=""> <a href="./javascript.html">Javascript</a> </li> - <li class=""> - <a href="./less.html">LESS</a> - </li> <li class="divider-vertical"></li> <li class=""> <a href="./download.html">Customize</a> @@ -67,6 +64,9 @@ <li class=""> <a href="./examples.html">Examples</a> </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> </ul> </div> </div> diff --git a/docs/download.html b/docs/download.html index 865e84143f..34fdc741ec 100644 --- a/docs/download.html +++ b/docs/download.html @@ -57,9 +57,6 @@ <li class=""> <a href="./javascript.html">Javascript</a> </li> - <li class=""> - <a href="./less.html">LESS</a> - </li> <li class="divider-vertical"></li> <li class="active"> <a href="./download.html">Customize</a> @@ -67,6 +64,9 @@ <li class=""> <a href="./examples.html">Examples</a> </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> </ul> </div> </div> diff --git a/docs/examples.html b/docs/examples.html index 06b70b9b57..3b541df3b5 100644 --- a/docs/examples.html +++ b/docs/examples.html @@ -57,9 +57,6 @@ <li class=""> <a href="./javascript.html">Javascript</a> </li> - <li class=""> - <a href="./less.html">LESS</a> - </li> <li class="divider-vertical"></li> <li class=""> <a href="./download.html">Customize</a> @@ -67,6 +64,9 @@ <li class="active"> <a href="./examples.html">Examples</a> </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> </ul> </div> </div> diff --git a/docs/extend.html b/docs/extend.html new file mode 100644 index 0000000000..7169908a6a --- /dev/null +++ b/docs/extend.html @@ -0,0 +1,205 @@ +<!DOCTYPE html> +<html lang="en"> + <head> + <meta charset="utf-8"> + <title>Extend · Twitter Bootstrap</title> + <meta name="viewport" content="width=device-width, initial-scale=1.0"> + <meta name="description" content=""> + <meta name="author" content=""> + + <!-- Le styles --> + <link href="assets/css/bootstrap.css" rel="stylesheet"> + <link href="assets/css/bootstrap-responsive.css" rel="stylesheet"> + <link href="assets/css/docs.css" rel="stylesheet"> + <link href="assets/js/google-code-prettify/prettify.css" rel="stylesheet"> + + <!-- Le HTML5 shim, for IE6-8 support of HTML5 elements --> + <!--[if lt IE 9]> + <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script> + <![endif]--> + + <!-- Le fav and touch icons --> + <link rel="shortcut icon" href="assets/ico/favicon.ico"> + <link rel="apple-touch-icon-precomposed" sizes="144x144" href="assets/ico/apple-touch-icon-144-precomposed.png"> + <link rel="apple-touch-icon-precomposed" sizes="114x114" href="assets/ico/apple-touch-icon-114-precomposed.png"> + <link rel="apple-touch-icon-precomposed" sizes="72x72" href="assets/ico/apple-touch-icon-72-precomposed.png"> + <link rel="apple-touch-icon-precomposed" href="assets/ico/apple-touch-icon-57-precomposed.png"> + + </head> + + <body data-spy="scroll" data-target=".subnav" data-offset="50"> + + <!-- Navbar + ================================================== --> + <div class="navbar navbar-fixed-top"> + <div class="navbar-inner"> + <div class="bs-docs-container"> + <button type="button" class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse"> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + <span class="icon-bar"></span> + </button> + <a class="brand" href="./index.html">Bootstrap</a> + <div class="nav-collapse collapse"> + <ul class="nav"> + <li class=""> + <a href="./index.html">Home</a> + </li> + <li class=""> + <a href="./scaffolding.html">Scaffolding</a> + </li> + <li class=""> + <a href="./base-css.html">Base CSS</a> + </li> + <li class=""> + <a href="./components.html">Components</a> + </li> + <li class=""> + <a href="./javascript.html">Javascript</a> + </li> + <li class="divider-vertical"></li> + <li class=""> + <a href="./download.html">Customize</a> + </li> + <li class=""> + <a href="./examples.html">Examples</a> + </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> + </ul> + </div> + </div> + </div> + </div> + + <div class="bs-docs-container"> + +<!-- Masthead +================================================== --> +<header class="jumbotron subhead" id="overview"> + <h1>Extending Bootstrap</h1> + <p class="lead">Extend Bootstrap with <a href="http://lesscss.org" target="_blank">LESS</a>, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.</p> + <div class="navbar navbar-subnav"> + <div class="navbar-inner"> + <ul class="nav"> + <li><a href="#builtWith">Built with Less</a></li> + <li><a href="#compiling">Compiling Bootstrap</a></li> + </ul> + </div> + </div> +</header> + + + +<!-- BUILT WITH LESS +================================================== --> +<section id="builtWith"> + <div class="page-header"> + <h1>Built with LESS</h1> + </div> + + <h3>Why LESS?</h3> + <p>Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, <a href="http://cloudhead.io">Alexis Sellier</a>. It makes developing systems-based CSS faster, easier, and more fun.</p> + + <h3>What's included?</h3> + <p>As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.</p> + + <h3>Learn more</h3> + <img style="float: right; height: 36px;" src="assets/img/less-logo-large.png" alt="LESS CSS"> + <p>Visit the official website at <a href="http://lesscss.org">http://lesscss.org</a> to learn more.</p> + + <h3><a href="#variables">Variables</a></h3> + <p>Managing colors and pixel values in CSS can be a bit of a pain, usually full of copy and paste. Not with LESS though—assign colors or pixel values as variables and change them once.</p> + + <h3><a href="#mixins">Mixins</a></h3> + <p>Those three border-radius declarations you need to make in regular ol' CSS? Now they're down to one line with the help of mixins, snippets of code you can reuse anywhere.</p> + + <h3>Operations</h3> + <p>Make your grid, leading, and more super flexible by doing the math on the fly with operations. Multiply, divide, add, and subtract your way to CSS sanity.</p> +</section> + + + +<!-- COMPILING LESS AND BOOTSTRAP +================================================== --> +<section id="compiling"> + <div class="page-header"> + <h1>Compiling Bootstrap with LESS</h1> + </div> + <div class="alert alert-info"> + <strong>Note:</strong> If you're submitting a pull request to GitHub with modified CSS, you <strong>must</strong> recompile the CSS via any of these methods. + </div> + + <h2>Tools for compiling</h2> + + <h3>Node with makefile</h3> + <p>Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:</p> + <pre>$ npm install -g less jshint recess uglify-js</pre> + <p>Once installed just run <code>make</code> from the root of your bootstrap directory and you're all set.</p> + <p>Additionally, if you have <a href="https://github.com/mynyml/watchr">watchr</a> installed, you may run <code>make watch</code> to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).</p> + + <h3>Command line</h3> + <p>Install the LESS command line tool via Node and run the following command:</p> + <pre>$ lessc ./less/bootstrap.less > bootstrap.css</pre> + <p>Be sure to include <code>--compress</code> in that command if you're trying to save some bytes!</p> + + <h3>Javascript</h3> + <p><a href="http://lesscss.org/">Download the latest Less.js</a> and include the path to it (and Bootstrap) in the <code><head></code>.</p> +<pre class="prettyprint"> +<link rel="stylesheet/less" href="/path/to/bootstrap.less"> +<script src="/path/to/less.js"></script> +</pre> + <p>To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.</p> + + <h3>Unofficial Mac app</h3> + <p><a href="http://incident57.com/less/">The unofficial Mac app</a> watches directories of .less files and compiles the code to local files after every save of a watched .less file.</p> + <p>If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.</p> + + <h3>More Mac apps</h3> + <h4><a href="http://crunchapp.net/" target="_blank">Crunch</a></h4> + <p>Crunch is a great looking LESS editor and compiler built on Adobe Air.</p> + <h4><a href="http://incident57.com/codekit/" target="_blank">CodeKit</a></h4> + <p>Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.</p> + <h4><a href="http://wearekiss.com/simpless" target="_blank">Simpless</a></h4> + <p>Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the <a href="https://github.com/Paratron/SimpLESS" target="_blank">source code is on GitHub</a>.</p> + +</section> + + + <!-- Footer + ================================================== --> + <footer class="footer"> + <p class="pull-right"><a href="#">Back to top</a></p> + <p>Designed and built with all the love in the world <a href="http://twitter.com/twitter" target="_blank">@twitter</a> by <a href="http://twitter.com/mdo" target="_blank">@mdo</a> and <a href="http://twitter.com/fat" target="_blank">@fat</a>.</p> + <p>Code licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">Apache License v2.0</a>. Documentation licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p> + <p>Icons from <a href="http://glyphicons.com">Glyphicons Free</a>, licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p> + </footer> + + </div> + + + + <!-- Le javascript + ================================================== --> + <!-- Placed at the end of the document so the pages load faster --> + <script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> + <script src="assets/js/jquery.js"></script> + <script src="assets/js/google-code-prettify/prettify.js"></script> + <script src="assets/js/bootstrap-transition.js"></script> + <script src="assets/js/bootstrap-alert.js"></script> + <script src="assets/js/bootstrap-modal.js"></script> + <script src="assets/js/bootstrap-dropdown.js"></script> + <script src="assets/js/bootstrap-scrollspy.js"></script> + <script src="assets/js/bootstrap-tab.js"></script> + <script src="assets/js/bootstrap-tooltip.js"></script> + <script src="assets/js/bootstrap-popover.js"></script> + <script src="assets/js/bootstrap-button.js"></script> + <script src="assets/js/bootstrap-collapse.js"></script> + <script src="assets/js/bootstrap-carousel.js"></script> + <script src="assets/js/bootstrap-typeahead.js"></script> + <script src="assets/js/application.js"></script> + + + </body> +</html> diff --git a/docs/index.html b/docs/index.html index 1dea842ffe..4e028a13f4 100644 --- a/docs/index.html +++ b/docs/index.html @@ -57,9 +57,6 @@ <li class=""> <a href="./javascript.html">Javascript</a> </li> - <li class=""> - <a href="./less.html">LESS</a> - </li> <li class="divider-vertical"></li> <li class=""> <a href="./download.html">Customize</a> @@ -67,6 +64,9 @@ <li class=""> <a href="./examples.html">Examples</a> </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> </ul> </div> </div> diff --git a/docs/javascript.html b/docs/javascript.html index 8f07b58d81..bc82711fb9 100644 --- a/docs/javascript.html +++ b/docs/javascript.html @@ -57,9 +57,6 @@ <li class="active"> <a href="./javascript.html">Javascript</a> </li> - <li class=""> - <a href="./less.html">LESS</a> - </li> <li class="divider-vertical"></li> <li class=""> <a href="./download.html">Customize</a> @@ -67,6 +64,9 @@ <li class=""> <a href="./examples.html">Examples</a> </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> </ul> </div> </div> diff --git a/docs/less.html b/docs/less.html deleted file mode 100644 index 559b4bbe16..0000000000 --- a/docs/less.html +++ /dev/null @@ -1,1052 +0,0 @@ -<!DOCTYPE html> -<html lang="en"> - <head> - <meta charset="utf-8"> - <title>Less · Twitter Bootstrap</title> - <meta name="viewport" content="width=device-width, initial-scale=1.0"> - <meta name="description" content=""> - <meta name="author" content=""> - - <!-- Le styles --> - <link href="assets/css/bootstrap.css" rel="stylesheet"> - <link href="assets/css/bootstrap-responsive.css" rel="stylesheet"> - <link href="assets/css/docs.css" rel="stylesheet"> - <link href="assets/js/google-code-prettify/prettify.css" rel="stylesheet"> - - <!-- Le HTML5 shim, for IE6-8 support of HTML5 elements --> - <!--[if lt IE 9]> - <script src="http://html5shim.googlecode.com/svn/trunk/html5.js"></script> - <![endif]--> - - <!-- Le fav and touch icons --> - <link rel="shortcut icon" href="assets/ico/favicon.ico"> - <link rel="apple-touch-icon-precomposed" sizes="144x144" href="assets/ico/apple-touch-icon-144-precomposed.png"> - <link rel="apple-touch-icon-precomposed" sizes="114x114" href="assets/ico/apple-touch-icon-114-precomposed.png"> - <link rel="apple-touch-icon-precomposed" sizes="72x72" href="assets/ico/apple-touch-icon-72-precomposed.png"> - <link rel="apple-touch-icon-precomposed" href="assets/ico/apple-touch-icon-57-precomposed.png"> - - </head> - - <body data-spy="scroll" data-target=".subnav" data-offset="50"> - - <!-- Navbar - ================================================== --> - <div class="navbar navbar-fixed-top"> - <div class="navbar-inner"> - <div class="bs-docs-container"> - <button type="button" class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse"> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - <span class="icon-bar"></span> - </button> - <a class="brand" href="./index.html">Bootstrap</a> - <div class="nav-collapse collapse"> - <ul class="nav"> - <li class=""> - <a href="./index.html">Home</a> - </li> - <li class=""> - <a href="./scaffolding.html">Scaffolding</a> - </li> - <li class=""> - <a href="./base-css.html">Base CSS</a> - </li> - <li class=""> - <a href="./components.html">Components</a> - </li> - <li class=""> - <a href="./javascript.html">Javascript</a> - </li> - <li class="active"> - <a href="./less.html">LESS</a> - </li> - <li class="divider-vertical"></li> - <li class=""> - <a href="./download.html">Customize</a> - </li> - <li class=""> - <a href="./examples.html">Examples</a> - </li> - </ul> - </div> - </div> - </div> - </div> - - <div class="bs-docs-container"> - -<!-- Masthead -================================================== --> -<header class="jumbotron subhead" id="overview"> - <h1>Using LESS with Bootstrap</h1> - <p class="lead">Customize and extend Bootstrap with <a href="http://lesscss.org" target="_blank">LESS</a>, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.</p> - <div class="navbar navbar-subnav"> - <div class="navbar-inner"> - <ul class="nav"> - <li><a href="#builtWith">Built with Less</a></li> - <li><a href="#variables">Variables</a></li> - <li><a href="#mixins">Mixins</a></li> - <li><a href="#compiling">Compiling Bootstrap</a></li> - </ul> - </div> - </div> -</header> - - - -<!-- BUILT WITH LESS -================================================== --> -<section id="builtWith"> - <div class="page-header"> - <h1>Built with LESS</h1> - </div> - - <h3>Why LESS?</h3> - <p>Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, <a href="http://cloudhead.io">Alexis Sellier</a>. It makes developing systems-based CSS faster, easier, and more fun.</p> - - <h3>What's included?</h3> - <p>As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.</p> - - <h3>Learn more</h3> - <img style="float: right; height: 36px;" src="assets/img/less-logo-large.png" alt="LESS CSS"> - <p>Visit the official website at <a href="http://lesscss.org">http://lesscss.org</a> to learn more.</p> - - <h3><a href="#variables">Variables</a></h3> - <p>Managing colors and pixel values in CSS can be a bit of a pain, usually full of copy and paste. Not with LESS though—assign colors or pixel values as variables and change them once.</p> - - <h3><a href="#mixins">Mixins</a></h3> - <p>Those three border-radius declarations you need to make in regular ol' CSS? Now they're down to one line with the help of mixins, snippets of code you can reuse anywhere.</p> - - <h3>Operations</h3> - <p>Make your grid, leading, and more super flexible by doing the math on the fly with operations. Multiply, divide, add, and subtract your way to CSS sanity.</p> -</section> - - - -<!-- VARIABLES -================================================== --> -<section id="variables"> - <div class="page-header"> - <h1>Bootstrap variables <small>LESS variables, their values, and usage guidelines</small></h1> - </div> - - <h3>Scaffolding and links</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@bodyBackground</code></td> - <td><code>@white</code></td> - <td>Page background color</td> - <td class="swatch-col"><span class="swatch" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@textColor</code></td> - <td><code>@grayDark</code></td> - <td>Default text color for entire body, headings, and more</td> - <td class="swatch-col"><span class="swatch" style="background-color: #333;"></span></td> - </tr> - <tr> - <td><code>@linkColor</code></td> - <td><code>#08c</code></td> - <td>Default link text color</td> - <td class="swatch-col"><span class="swatch" style="background-color: #08c;"></span></td> - </tr> - <tr> - <td><code>@linkColorHover</code></td> - <td><code>darken(@linkColor, 15%)</code></td> - <td>Default link text hover color</td> - <td><span class="swatch" style="background-color: #005580;"></span></td> - </tr> - </tbody> - </table> - <h3>Grid system</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@gridColumns</code></td> - <td>12</td> - </tr> - <tr> - <td><code>@gridColumnWidth</code></td> - <td>60px</td> - </tr> - <tr> - <td><code>@gridGutterWidth</code></td> - <td>20px</td> - </tr> - <tr> - <td><code>@fluidGridColumnWidth</code></td> - <td>6.382978723%</td> - </tr> - <tr> - <td><code>@fluidGridGutterWidth</code></td> - <td>2.127659574%</td> - </tr> - </tbody> - </table> - <h3>Typography</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@sansFontFamily</code></td> - <td colspan="2">"Helvetica Neue", Helvetica, Arial, sans-serif</td> - </tr> - <tr> - <td><code>@serifFontFamily</code></td> - <td colspan="2"><code>Georgia, "Times New Roman", Times, serif</code></td> - </tr> - <tr> - <td><code>@monoFontFamily</code></td> - <td colspan="2">Menlo, Monaco, "Courier New", monospace</td> - </tr> - - <tr> - <td><code>@baseFontSize</code></td> - <td>13px</td> - <td><em class="muted">Must be pixels</em></td> - </tr> - <tr> - <td><code>@baseFontFamily</code></td> - <td colspan="2"><code>@sansFontFamily</code></td> - </tr> - <tr> - <td><code>@baseLineHeight</code></td> - <td>18px</td> - <td><em class="muted">Must be pixels</em></td> - </tr> - <tr> - <td><code>@altFontFamily</code></td> - <td colspan="2"><code>@serifFontFamily</code></td> - </tr> - - <tr> - <td><code>@headingsFontFamily</code></td> - <td colspan="2"><code>inherit</code></td> - </tr> - <tr> - <td><code>@headingsFontWeight</code></td> - <td colspan="2"><code>bold</code></td> - </tr> - <tr> - <td><code>@headingsColor</code></td> - <td colspan="2"><code>inherit</code></td> - </tr> - </tbody> - </table> - <h3>Tables</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@tableBackground</code></td> - <td><code>transparent</code></td> - </tr> - <tr> - <td><code>@tableBackgroundAccent</code></td> - <td><code>#f9f9f9</code></td> - </tr> - <tr> - <td><code>@tableBackgroundHover</code></td> - <td><code>#f5f5f5</code></td> - </tr> - <tr> - <td><code>@tableBorder</code></td> - <td><code>#ddd</code></td> - </tr> - </tbody> - </table> - - <h3>Grayscale colors</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@black</code></td> - <td>#000</td> - <td class="swatch-col"><span class="swatch" style="background-color: #000;"></span></td> - </tr> - <tr> - <td><code>@grayDarker</code></td> - <td>#222</td> - <td><span class="swatch" style="background-color: #222;"></span></td> - </tr> - <tr> - <td><code>@grayDark</code></td> - <td>#333</td> - <td><span class="swatch" style="background-color: #333;"></span></td> - </tr> - <tr> - <td><code>@gray</code></td> - <td>#555</td> - <td><span class="swatch" style="background-color: #555;"></span></td> - </tr> - <tr> - <td><code>@grayLight</code></td> - <td>#999</td> - <td><span class="swatch" style="background-color: #999;"></span></td> - </tr> - <tr> - <td><code>@grayLighter</code></td> - <td>#eee</td> - <td><span class="swatch" style="background-color: #eee;"></span></td> - </tr> - <tr> - <td><code>@white</code></td> - <td>#fff</td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - </tbody> - </table> - <h3>Accent colors</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@blue</code></td> - <td>#049cdb</td> - <td class="swatch-col"><span class="swatch" style="background-color: #049cdb;"></span></td> - </tr> - <tr> - <td><code>@green</code></td> - <td>#46a546</td> - <td><span class="swatch" style="background-color: #46a546;"></span></td> - </tr> - <tr> - <td><code>@red</code></td> - <td>#9d261d</td> - <td><span class="swatch" style="background-color: #9d261d;"></span></td> - </tr> - <tr> - <td><code>@yellow</code></td> - <td>#ffc40d</td> - <td><span class="swatch" style="background-color: #ffc40d;"></span></td> - </tr> - <tr> - <td><code>@orange</code></td> - <td>#f89406</td> - <td><span class="swatch" style="background-color: #f89406;"></span></td> - </tr> - <tr> - <td><code>@pink</code></td> - <td>#c3325f</td> - <td><span class="swatch" style="background-color: #c3325f;"></span></td> - </tr> - <tr> - <td><code>@purple</code></td> - <td>#7a43b6</td> - <td><span class="swatch" style="background-color: #7a43b6;"></span></td> - </tr> - </tbody> - </table> - - - <h3>Components</h3> - - <h4>Buttons</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@btnBackground</code></td> - <td><code>@white</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@btnBackgroundHighlight</code></td> - <td><code>darken(@white, 10%)</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #e6e6e6;"></span></td> - </tr> - <tr> - <td><code>@btnBorder</code></td> - <td><code>darken(@white, 20%)</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #ccc;"></span></td> - </tr> - - <tr> - <td><code>@btnPrimaryBackground</code></td> - <td><code>@linkColor</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #08c;"></span></td> - </tr> - <tr> - <td><code>@btnPrimaryBackgroundHighlight</code></td> - <td><code>spin(@btnPrimaryBackground, 15%)</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #05c;"></span></td> - </tr> - - <tr> - <td><code>@btnInfoBackground</code></td> - <td><code>#5bc0de</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #5bc0de;"></span></td> - </tr> - <tr> - <td><code>@btnInfoBackgroundHighlight</code></td> - <td><code>#2f96b4</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #2f96b4;"></span></td> - </tr> - - <tr> - <td><code>@btnSuccessBackground</code></td> - <td><code>#62c462</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #62c462;"></span></td> - </tr> - <tr> - <td><code>@btnSuccessBackgroundHighlight</code></td> - <td><code>#51a351</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #51a351;"></span></td> - </tr> - - <tr> - <td><code>@btnWarningBackground</code></td> - <td><code>lighten(@orange, 15%)</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #fbb450;"></span></td> - </tr> - <tr> - <td><code>@btnWarningBackgroundHighlight</code></td> - <td><code>@orange</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #f89406;"></span></td> - </tr> - - <tr> - <td><code>@btnDangerBackground</code></td> - <td><code>#ee5f5b</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #ee5f5b;"></span></td> - </tr> - <tr> - <td><code>@btnDangerBackgroundHighlight</code></td> - <td><code>#bd362f</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #bd362f;"></span></td> - </tr> - - <tr> - <td><code>@btnInverseBackground</code></td> - <td><code>@gray</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #555;"></span></td> - </tr> - <tr> - <td><code>@btnInverseBackgroundHighlight</code></td> - <td><code>@grayDarker</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #222;"></span></td> - </tr> - </tbody> - </table> - <h4>Forms</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@placeholderText</code></td> - <td><code>@grayLight</code></td> - </tr> - <tr> - <td><code>@inputBackground</code></td> - <td><code>@white</code></td> - </tr> - <tr> - <td><code>@inputBorder</code></td> - <td><code>#ccc</code></td> - </tr> - <tr> - <td><code>@inputBorderRadius</code></td> - <td><code>3px</code></td> - </tr> - <tr> - <td><code>@inputDisabledBackground</code></td> - <td><code>@grayLighter</code></td> - </tr> - <tr> - <td><code>@formActionsBackground</code></td> - <td><code>#f5f5f5</code></td> - </tr> - </tbody> - </table> - <h4>Form states and alerts</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@warningText</code></td> - <td>#c09853</td> - <td><span class="swatch" style="background-color: #c09853;"></span></td> - </tr> - <tr> - <td><code>@warningBackground</code></td> - <td>#f3edd2</td> - <td class="swatch-col"><span class="swatch" style="background-color: #f3edd2;"></span></td> - </tr> - <tr> - <td><code>@errorText</code></td> - <td>#b94a48</td> - <td><span class="swatch" style="background-color: #b94a48;"></span></td> - </tr> - <tr> - <td><code>@errorBackground</code></td> - <td>#f2dede</td> - <td><span class="swatch" style="background-color: #f2dede;"></span></td> - </tr> - <tr> - <td><code>@successText</code></td> - <td>#468847</td> - <td><span class="swatch" style="background-color: #468847;"></span></td> - </tr> - <tr> - <td><code>@successBackground</code></td> - <td>#dff0d8</td> - <td><span class="swatch" style="background-color: #dff0d8;"></span></td> - </tr> - <tr> - <td><code>@infoText</code></td> - <td>#3a87ad</td> - <td><span class="swatch" style="background-color: #3a87ad;"></span></td> - </tr> - <tr> - <td><code>@infoBackground</code></td> - <td>#d9edf7</td> - <td><span class="swatch" style="background-color: #d9edf7;"></span></td> - </tr> - </tbody> - </table> - - <h4>Navbar</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@navbarHeight</code></td> - <td>40px</td> - <td class="swatch-col"></td> - </tr> - <tr> - <td><code>@navbarBackground</code></td> - <td><code>@grayDarker</code></td> - <td><span class="swatch" style="background-color: #222;"></span></td> - </tr> - <tr> - <td><code>@navbarBackgroundHighlight</code></td> - <td><code>@grayDark</code></td> - <td><span class="swatch" style="background-color: #333;"></span></td> - </tr> - - <tr> - <td><code>@navbarText</code></td> - <td><code>@grayLight</code></td> - <td><span class="swatch" style="background-color: #999;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkColor</code></td> - <td><code>@grayLight</code></td> - <td><span class="swatch" style="background-color: #999;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkColorHover</code></td> - <td><code>@white</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkColorActive</code></td> - <td><code>@navbarLinkColorHover</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkBackgroundHover</code></td> - <td><code>transparent</code></td> - <td><span class="swatch swatch-bordered" style="background-color: transparent;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkBackgroundActive</code></td> - <td><code>@navbarBackground</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - - <tr> - <td><code>@navbarSearchBackground</code></td> - <td><code>lighten(@navbarBackground, 25%)</code></td> - <td><span class="swatch" style="background-color: #666;"></span></td> - </tr> - <tr> - <td><code>@navbarSearchBackgroundFocus</code></td> - <td><code>@white</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@navbarSearchBorder</code></td> - <td><code>darken(@navbarSearchBackground, 30%)</code></td> - <td><span class="swatch" style="background-color: #111;"></span></td> - </tr> - <tr> - <td><code>@navbarSearchPlaceholderColor</code></td> - <td><code>#ccc</code></td> - <td><span class="swatch" style="background-color: #ccc;"></span></td> - </tr> - <tr> - <td><code>@navbarBrandColor</code></td> - <td><code>@navbarLinkColor</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - </tbody> - </table> - <h4>Dropdowns</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@dropdownBackground</code></td> - <td><code>@white</code></td> - </tr> - <tr> - <td><code>@dropdownBorder</code></td> - <td><code>rgba(0,0,0,.2)</code></td> - </tr> - <tr> - <td><code>@dropdownLinkColor</code></td> - <td><code>@grayDark</code></td> - </tr> - <tr> - <td><code>@dropdownLinkColorHover</code></td> - <td><code>@white</code></td> - </tr> - <tr> - <td><code>@dropdownLinkColorActive</code></td> - <td><code>@linkColor</code></td> - </tr> - <tr> - <td><code>@dropdownLinkBackgroundHover</code></td> - <td><code>@grayLighter</code></td> - </tr> - <tr> - <td><code>@dropdownLinkBackgroundActive</code></td> - <td><code>@linkColor</code></td> - </tr> - <tr> - <td><code>@dropdownDividerTop</code></td> - <td><code>#e5e5e5</code></td> - </tr> - <tr> - <td><code>@dropdownDividerBottom</code></td> - <td><code>@white</code></td> - </tr> - </tbody> - </table> - <h4>Hero unit</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@heroUnitBackground</code></td> - <td><code>@grayLighter</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #eee;"></span></td> - </tr> - <tr> - <td class="span2"><code>@heroUnitHeadingColor</code></td> - <td><code>inherit</code></td> - <td></td> - </tr> - <tr> - <td><code>@heroUnitLeadColor</code></td> - <td><code>inherit</code></td> - <td></td> - </tr> - </tbody> - </table> - - -</section> - - - -<!-- MIXINS -================================================== --> -<section id="mixins"> - <div class="page-header"> - <h1>Bootstrap mixins <small></small></h1> - </div> - <h2>About mixins</h2> - <div class="row"> - <div class="span4"> - <h3>Basic mixins</h3> - <p>A basic mixin is essentially an include or a partial for a snippet of CSS. They're written just like a CSS class and can be called anywhere.</p> -<pre class="prettyprint linenums"> -.element { - .clearfix(); -} -</pre> - </div><!-- /span4 --> - <div class="span4"> - <h3>Parametric mixins</h3> - <p>A parametric mixin is just like a basic mixin, but it also accepts parameters (hence the name) with optional default values.</p> -<pre class="prettyprint linenums"> -.element { - .border-radius(4px); -} -</pre> - </div><!-- /span4 --> - <div class="span4"> - <h3>Easily add your own</h3> - <p>Nearly all of Bootstrap's mixins are stored in mixins.less, a wonderful utility .less file that enables you to use a mixin in any of the .less files in the toolkit.</p> - <p>So, go ahead and use the existing ones or feel free to add your own as you need.</p> - </div><!-- /span4 --> - </div><!-- /row --> - <h2>Included mixins</h2> - <h3>Utilities</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">Mixin</th> - <th>Parameters</th> - <th>Usage</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>.clearfix()</code></td> - <td><em class="muted">none</em></td> - <td>Add to any parent to clear floats within</td> - </tr> - <tr> - <td><code>.tab-focus()</code></td> - <td><em class="muted">none</em></td> - <td>Apply the Webkit focus style and round Firefox outline</td> - </tr> - <tr> - <td><code>.center-block()</code></td> - <td><em class="muted">none</em></td> - <td>Auto center a block-level element using <code>margin: auto</code></td> - </tr> - <tr> - <td><code>.ie7-inline-block()</code></td> - <td><em class="muted">none</em></td> - <td>Use in addition to regular <code>display: inline-block</code> to get IE7 support</td> - </tr> - <tr> - <td><code>.size()</code></td> - <td><code>@height @width</code></td> - <td>Quickly set the height and width on one line</td> - </tr> - <tr> - <td><code>.square()</code></td> - <td><code>@size</code></td> - <td>Builds on <code>.size()</code> to set the width and height as same value</td> - </tr> - <tr> - <td><code>.opacity()</code></td> - <td><code>@opacity</code></td> - <td>Set, in whole numbers, the opacity percentage (e.g., "50" or "75")</td> - </tr> - </tbody> - </table> - <h3>Forms</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">Mixin</th> - <th>Parameters</th> - <th>Usage</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>.placeholder()</code></td> - <td><code>@color: @placeholderText</code></td> - <td>Set the <code>placeholder</code> text color for inputs</td> - </tr> - </tbody> - </table> - <h3>Typography</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">Mixin</th> - <th>Parameters</th> - <th>Usage</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>#font > #family > .serif()</code></td> - <td><em class="muted">none</em></td> - <td>Make an element use a serif font stack</td> - </tr> - <tr> - <td><code>#font > #family > .sans-serif()</code></td> - <td><em class="muted">none</em></td> - <td>Make an element use a sans-serif font stack</td> - </tr> - <tr> - <td><code>#font > #family > .monospace()</code></td> - <td><em class="muted">none</em></td> - <td>Make an element use a monospace font stack</td> - </tr> - <tr> - <td><code>#font > .shorthand()</code></td> - <td><code>@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight</code></td> - <td>Easily set font size, weight, and leading</td> - </tr> - <tr> - <td><code>#font > .serif()</code></td> - <td><code>@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight</code></td> - <td>Set font family to serif, and control size, weight, and leading</td> - </tr> - <tr> - <td><code>#font > .sans-serif()</code></td> - <td><code>@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight</code></td> - <td>Set font family to sans-serif, and control size, weight, and leading</td> - </tr> - <tr> - <td><code>#font > .monospace()</code></td> - <td><code>@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight</code></td> - <td>Set font family to monospace, and control size, weight, and leading</td> - </tr> - </tbody> - </table> - <h3>Grid system</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">Mixin</th> - <th>Parameters</th> - <th>Usage</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>.container-fixed()</code></td> - <td><em class="muted">none</em></td> - <td>Create a horizontally centered container for holding your content</td> - </tr> - <tr> - <td><code>#grid > .core()</code></td> - <td><code>@gridColumnWidth, @gridGutterWidth</code></td> - <td>Generate a pixel grid system (container, row, and columns) with <em>n</em> columns and <em>x</em> pixel wide gutter</td> - </tr> - <tr> - <td><code>#grid > .fluid()</code></td> - <td><code>@fluidGridColumnWidth, @fluidGridGutterWidth</code></td> - <td>Generate a percent grid system with <em>n</em> columns and <em>x</em> % wide gutter</td> - </tr> - <tr> - <td><code>#grid > .input()</code></td> - <td><code>@gridColumnWidth, @gridGutterWidth</code></td> - <td>Generate the pixel grid system for <code>input</code> elements, accounting for padding and borders</td> - </tr> - <tr> - <td><code>.makeColumn</code></td> - <td><code>@columns: 1, @offset: 0</code></td> - <td>Turn any <code>div</code> into a grid column without the <code>.span*</code> classes</td> - </tr> - </tbody> - </table> - <h3>CSS3 properties</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span3">Mixin</th> - <th>Parameters</th> - <th>Usage</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>.border-radius()</code></td> - <td><code>@radius</code></td> - <td>Round the corners of an element. Can be a single value or four space-separated values</td> - </tr> - <tr> - <td><code>.box-shadow()</code></td> - <td><code>@shadow</code></td> - <td>Add a drop shadow to an element</td> - </tr> - <tr> - <td><code>.transition()</code></td> - <td><code>@transition</code></td> - <td>Add CSS3 transition effect (e.g., <code>all .2s linear</code>)</td> - </tr> - <tr> - <td><code>.rotate()</code></td> - <td><code>@degrees</code></td> - <td>Rotate an element <em>n</em> degrees</td> - </tr> - <tr> - <td><code>.scale()</code></td> - <td><code>@ratio</code></td> - <td>Scale an element to <em>n</em> times its original size</td> - </tr> - <tr> - <td><code>.translate()</code></td> - <td><code>@x, @y</code></td> - <td>Move an element on the x and y planes</td> - </tr> - <tr> - <td><code>.background-clip()</code></td> - <td><code>@clip</code></td> - <td>Crop the background of an element (useful for <code>border-radius</code>)</td> - </tr> - <tr> - <td><code>.background-size()</code></td> - <td><code>@size</code></td> - <td>Control the size of background images via CSS3</td> - </tr> - <tr> - <td><code>.box-sizing()</code></td> - <td><code>@boxmodel</code></td> - <td>Change the box model for an element (e.g., <code>border-box</code> for a full-width <code>input</code>)</td> - </tr> - <tr> - <td><code>.user-select()</code></td> - <td><code>@select</code></td> - <td>Control cursor selection of text on a page</td> - </tr> - <tr> - <td><code>.backface-visibility()</code></td> - <td><code>@visibility: visible</code></td> - <td>Prevent flickering of content when using CSS 3D transforms</td> - </tr> - <tr> - <td><code>.resizable()</code></td> - <td><code>@direction: both</code></td> - <td>Make any element resizable on the right and bottom</td> - </tr> - <tr> - <td><code>.content-columns()</code></td> - <td><code>@columnCount, @columnGap: @gridGutterWidth</code></td> - <td>Make the content of any element use CSS3 columns</td> - </tr> - <tr> - <td><code>.hyphens()</code></td> - <td><code>@mode: auto</code></td> - <td>CSS3 hyphenation when you want it (includes <code>word-wrap: break-word</code>)</td> - </tr> - </tbody> - </table> - <h3>Backgrounds and gradients</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">Mixin</th> - <th>Parameters</th> - <th>Usage</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>#translucent > .background()</code></td> - <td><code>@color: @white, @alpha: 1</code></td> - <td>Give an element a translucent background color</td> - </tr> - <tr> - <td><code>#translucent > .border()</code></td> - <td><code>@color: @white, @alpha: 1</code></td> - <td>Give an element a translucent border color</td> - </tr> - <tr> - <td><code>#gradient > .vertical()</code></td> - <td><code>@startColor, @endColor</code></td> - <td>Create a cross-browser vertical background gradient</td> - </tr> - <tr> - <td><code>#gradient > .horizontal()</code></td> - <td><code>@startColor, @endColor</code></td> - <td>Create a cross-browser horizontal background gradient</td> - </tr> - <tr> - <td><code>#gradient > .directional()</code></td> - <td><code>@startColor, @endColor, @deg</code></td> - <td>Create a cross-browser directional background gradient</td> - </tr> - <tr> - <td><code>#gradient > .vertical-three-colors()</code></td> - <td><code>@startColor, @midColor, @colorStop, @endColor</code></td> - <td>Create a cross-browser three-color background gradient</td> - </tr> - <tr> - <td><code>#gradient > .radial()</code></td> - <td><code>@innerColor, @outerColor</code></td> - <td>Create a cross-browser radial background gradient</td> - </tr> - <tr> - <td><code>#gradient > .striped()</code></td> - <td><code>@color, @angle</code></td> - <td>Create a cross-browser striped background gradient</td> - </tr> - <tr> - <td><code>.gradientBar()</code></td> - <td><code>@primaryColor, @secondaryColor</code></td> - <td>Used for buttons to assign a gradient and slightly darker border</td> - </tr> - </tbody> - </table> -</section> - - - -<!-- COMPILING LESS AND BOOTSTRAP -================================================== --> -<section id="compiling"> - <div class="page-header"> - <h1>Compiling Bootstrap with LESS</h1> - </div> - <div class="alert alert-info"> - <strong>Note:</strong> If you're submitting a pull request to GitHub with modified CSS, you <strong>must</strong> recompile the CSS via any of these methods. - </div> - - <h2>Tools for compiling</h2> - - <h3>Node with makefile</h3> - <p>Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:</p> - <pre>$ npm install -g less jshint recess uglify-js</pre> - <p>Once installed just run <code>make</code> from the root of your bootstrap directory and you're all set.</p> - <p>Additionally, if you have <a href="https://github.com/mynyml/watchr">watchr</a> installed, you may run <code>make watch</code> to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).</p> - - <h3>Command line</h3> - <p>Install the LESS command line tool via Node and run the following command:</p> - <pre>$ lessc ./less/bootstrap.less > bootstrap.css</pre> - <p>Be sure to include <code>--compress</code> in that command if you're trying to save some bytes!</p> - - <h3>Javascript</h3> - <p><a href="http://lesscss.org/">Download the latest Less.js</a> and include the path to it (and Bootstrap) in the <code><head></code>.</p> -<pre class="prettyprint"> -<link rel="stylesheet/less" href="/path/to/bootstrap.less"> -<script src="/path/to/less.js"></script> -</pre> - <p>To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.</p> - - <h3>Unofficial Mac app</h3> - <p><a href="http://incident57.com/less/">The unofficial Mac app</a> watches directories of .less files and compiles the code to local files after every save of a watched .less file.</p> - <p>If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.</p> - - <h3>More Mac apps</h3> - <h4><a href="http://crunchapp.net/" target="_blank">Crunch</a></h4> - <p>Crunch is a great looking LESS editor and compiler built on Adobe Air.</p> - <h4><a href="http://incident57.com/codekit/" target="_blank">CodeKit</a></h4> - <p>Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.</p> - <h4><a href="http://wearekiss.com/simpless" target="_blank">Simpless</a></h4> - <p>Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the <a href="https://github.com/Paratron/SimpLESS" target="_blank">source code is on GitHub</a>.</p> - -</section> - - - <!-- Footer - ================================================== --> - <footer class="footer"> - <p class="pull-right"><a href="#">Back to top</a></p> - <p>Designed and built with all the love in the world <a href="http://twitter.com/twitter" target="_blank">@twitter</a> by <a href="http://twitter.com/mdo" target="_blank">@mdo</a> and <a href="http://twitter.com/fat" target="_blank">@fat</a>.</p> - <p>Code licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" target="_blank">Apache License v2.0</a>. Documentation licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p> - <p>Icons from <a href="http://glyphicons.com">Glyphicons Free</a>, licensed under <a href="http://creativecommons.org/licenses/by/3.0/">CC BY 3.0</a>.</p> - </footer> - - </div> - - - - <!-- Le javascript - ================================================== --> - <!-- Placed at the end of the document so the pages load faster --> - <script type="text/javascript" src="http://platform.twitter.com/widgets.js"></script> - <script src="assets/js/jquery.js"></script> - <script src="assets/js/google-code-prettify/prettify.js"></script> - <script src="assets/js/bootstrap-transition.js"></script> - <script src="assets/js/bootstrap-alert.js"></script> - <script src="assets/js/bootstrap-modal.js"></script> - <script src="assets/js/bootstrap-dropdown.js"></script> - <script src="assets/js/bootstrap-scrollspy.js"></script> - <script src="assets/js/bootstrap-tab.js"></script> - <script src="assets/js/bootstrap-tooltip.js"></script> - <script src="assets/js/bootstrap-popover.js"></script> - <script src="assets/js/bootstrap-button.js"></script> - <script src="assets/js/bootstrap-collapse.js"></script> - <script src="assets/js/bootstrap-carousel.js"></script> - <script src="assets/js/bootstrap-typeahead.js"></script> - <script src="assets/js/application.js"></script> - - - </body> -</html> diff --git a/docs/scaffolding.html b/docs/scaffolding.html index 2cf9d5da13..3fe6affab9 100644 --- a/docs/scaffolding.html +++ b/docs/scaffolding.html @@ -57,9 +57,6 @@ <li class=""> <a href="./javascript.html">Javascript</a> </li> - <li class=""> - <a href="./less.html">LESS</a> - </li> <li class="divider-vertical"></li> <li class=""> <a href="./download.html">Customize</a> @@ -67,6 +64,9 @@ <li class=""> <a href="./examples.html">Examples</a> </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> </ul> </div> </div> diff --git a/docs/templates/layout.mustache b/docs/templates/layout.mustache index eeda3c2c43..1cda879541 100644 --- a/docs/templates/layout.mustache +++ b/docs/templates/layout.mustache @@ -69,9 +69,6 @@ <li class="{{javascript}}"> <a href="./javascript.html">{{_i}}Javascript{{/i}}</a> </li> - <li class="{{less}}"> - <a href="./less.html">{{_i}}LESS{{/i}}</a> - </li> <li class="divider-vertical"></li> <li class="{{download}}"> <a href="./download.html">{{_i}}Customize{{/i}}</a> @@ -79,6 +76,9 @@ <li class="{{examples}}"> <a href="./examples.html">{{_i}}Examples{{/i}}</a> </li> + <li class="{{less}}"> + <a href="./extend.html">{{_i}}Extend{{/i}}</a> + </li> </ul> </div> </div> diff --git a/docs/templates/pages/extend.mustache b/docs/templates/pages/extend.mustache new file mode 100644 index 0000000000..aae99f765d --- /dev/null +++ b/docs/templates/pages/extend.mustache @@ -0,0 +1,90 @@ +<!-- Masthead +================================================== --> +<header class="jumbotron subhead" id="overview"> + <h1>{{_i}}Extending Bootstrap{{/i}}</h1> + <p class="lead">{{_i}}Extend Bootstrap with <a href="http://lesscss.org" target="_blank">LESS</a>, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.{{/i}}</p> + <div class="navbar navbar-subnav"> + <div class="navbar-inner"> + <ul class="nav"> + <li><a href="#builtWith">{{_i}}Built with Less{{/i}}</a></li> + <li><a href="#compiling">{{_i}}Compiling Bootstrap{{/i}}</a></li> + </ul> + </div> + </div> +</header> + + + +<!-- BUILT WITH LESS +================================================== --> +<section id="builtWith"> + <div class="page-header"> + <h1>{{_i}}Built with LESS{{/i}}</h1> + </div> + + <h3>{{_i}}Why LESS?{{/i}}</h3> + <p>{{_i}}Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, <a href="http://cloudhead.io">Alexis Sellier</a>. It makes developing systems-based CSS faster, easier, and more fun.{{/i}}</p> + + <h3>{{_i}}What's included?{{/i}}</h3> + <p>{{_i}}As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.{{/i}}</p> + + <h3>{{_i}}Learn more{{/i}}</h3> + <img style="float: right; height: 36px;" src="assets/img/less-logo-large.png" alt="LESS CSS"> + <p>{{_i}}Visit the official website at <a href="http://lesscss.org">http://lesscss.org</a> to learn more.{{/i}}</p> + + <h3><a href="#variables">{{_i}}Variables{{/i}}</a></h3> + <p>{{_i}}Managing colors and pixel values in CSS can be a bit of a pain, usually full of copy and paste. Not with LESS though—assign colors or pixel values as variables and change them once.{{/i}}</p> + + <h3><a href="#mixins">{{_i}}Mixins{{/i}}</a></h3> + <p>{{_i}}Those three border-radius declarations you need to make in regular ol' CSS? Now they're down to one line with the help of mixins, snippets of code you can reuse anywhere.{{/i}}</p> + + <h3>{{_i}}Operations{{/i}}</h3> + <p>{{_i}}Make your grid, leading, and more super flexible by doing the math on the fly with operations. Multiply, divide, add, and subtract your way to CSS sanity.{{/i}}</p> +</section> + + + +<!-- COMPILING LESS AND BOOTSTRAP +================================================== --> +<section id="compiling"> + <div class="page-header"> + <h1>{{_i}}Compiling Bootstrap with LESS{{/i}}</h1> + </div> + <div class="alert alert-info"> + {{_i}}<strong>Note:</strong> If you're submitting a pull request to GitHub with modified CSS, you <strong>must</strong> recompile the CSS via any of these methods.{{/i}} + </div> + + <h2>{{_i}}Tools for compiling{{/i}}</h2> + + <h3>{{_i}}Node with makefile{{/i}}</h3> + <p>{{_i}}Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:{{/i}}</p> + <pre>$ npm install -g less jshint recess uglify-js</pre> + <p>{{_i}}Once installed just run <code>make</code> from the root of your bootstrap directory and you're all set.{{/i}}</p> + <p>{{_i}}Additionally, if you have <a href="https://github.com/mynyml/watchr">watchr</a> installed, you may run <code>make watch</code> to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).{{/i}}</p> + + <h3>{{_i}}Command line{{/i}}</h3> + <p>{{_i}}Install the LESS command line tool via Node and run the following command:{{/i}}</p> + <pre>$ lessc ./less/bootstrap.less > bootstrap.css</pre> + <p>{{_i}}Be sure to include <code>--compress</code> in that command if you're trying to save some bytes!{{/i}}</p> + + <h3>{{_i}}Javascript{{/i}}</h3> + <p>{{_i}}<a href="http://lesscss.org/">Download the latest Less.js</a> and include the path to it (and Bootstrap) in the <code><head></code>.{{/i}}</p> +<pre class="prettyprint"> +<link rel="stylesheet/less" href="/path/to/bootstrap.less"> +<script src="/path/to/less.js"></script> +</pre> + <p>{{_i}}To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.{{/i}}</p> + + <h3>{{_i}}Unofficial Mac app{{/i}}</h3> + <p>{{_i}}<a href="http://incident57.com/less/">The unofficial Mac app</a> watches directories of .less files and compiles the code to local files after every save of a watched .less file.{{/i}}</p> + <p>{{_i}}If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.{{/i}}</p> + + <h3>{{_i}}More Mac apps{{/i}}</h3> + <h4><a href="http://crunchapp.net/" target="_blank">Crunch</a></h4> + <p>{{_i}}Crunch is a great looking LESS editor and compiler built on Adobe Air.{{/i}}</p> + <h4><a href="http://incident57.com/codekit/" target="_blank">CodeKit</a></h4> + <p>{{_i}}Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.{{/i}}</p> + <h4><a href="http://wearekiss.com/simpless" target="_blank">Simpless</a></h4> + <p>{{_i}}Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the <a href="https://github.com/Paratron/SimpLESS" target="_blank">source code is on GitHub</a>.{{/i}}</p> + +</section> diff --git a/docs/templates/pages/less.mustache b/docs/templates/pages/less.mustache deleted file mode 100644 index b08efd86c0..0000000000 --- a/docs/templates/pages/less.mustache +++ /dev/null @@ -1,937 +0,0 @@ -<!-- Masthead -================================================== --> -<header class="jumbotron subhead" id="overview"> - <h1>{{_i}}Using LESS with Bootstrap{{/i}}</h1> - <p class="lead">{{_i}}Customize and extend Bootstrap with <a href="http://lesscss.org" target="_blank">LESS</a>, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.{{/i}}</p> - <div class="navbar navbar-subnav"> - <div class="navbar-inner"> - <ul class="nav"> - <li><a href="#builtWith">{{_i}}Built with Less{{/i}}</a></li> - <li><a href="#variables">{{_i}}Variables{{/i}}</a></li> - <li><a href="#mixins">{{_i}}Mixins{{/i}}</a></li> - <li><a href="#compiling">{{_i}}Compiling Bootstrap{{/i}}</a></li> - </ul> - </div> - </div> -</header> - - - -<!-- BUILT WITH LESS -================================================== --> -<section id="builtWith"> - <div class="page-header"> - <h1>{{_i}}Built with LESS{{/i}}</h1> - </div> - - <h3>{{_i}}Why LESS?{{/i}}</h3> - <p>{{_i}}Bootstrap is made with LESS at its core, a dynamic stylesheet language created by our good friend, <a href="http://cloudhead.io">Alexis Sellier</a>. It makes developing systems-based CSS faster, easier, and more fun.{{/i}}</p> - - <h3>{{_i}}What's included?{{/i}}</h3> - <p>{{_i}}As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.{{/i}}</p> - - <h3>{{_i}}Learn more{{/i}}</h3> - <img style="float: right; height: 36px;" src="assets/img/less-logo-large.png" alt="LESS CSS"> - <p>{{_i}}Visit the official website at <a href="http://lesscss.org">http://lesscss.org</a> to learn more.{{/i}}</p> - - <h3><a href="#variables">{{_i}}Variables{{/i}}</a></h3> - <p>{{_i}}Managing colors and pixel values in CSS can be a bit of a pain, usually full of copy and paste. Not with LESS though—assign colors or pixel values as variables and change them once.{{/i}}</p> - - <h3><a href="#mixins">{{_i}}Mixins{{/i}}</a></h3> - <p>{{_i}}Those three border-radius declarations you need to make in regular ol' CSS? Now they're down to one line with the help of mixins, snippets of code you can reuse anywhere.{{/i}}</p> - - <h3>{{_i}}Operations{{/i}}</h3> - <p>{{_i}}Make your grid, leading, and more super flexible by doing the math on the fly with operations. Multiply, divide, add, and subtract your way to CSS sanity.{{/i}}</p> -</section> - - - -<!-- VARIABLES -================================================== --> -<section id="variables"> - <div class="page-header"> - <h1>{{_i}}Bootstrap variables <small>LESS variables, their values, and usage guidelines</small>{{/i}}</h1> - </div> - - <h3>{{_i}}Scaffolding and links{{/i}}</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@bodyBackground</code></td> - <td><code>@white</code></td> - <td>{{_i}}Page background color{{/i}}</td> - <td class="swatch-col"><span class="swatch" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@textColor</code></td> - <td><code>@grayDark</code></td> - <td>{{_i}}Default text color for entire body, headings, and more{{/i}}</td> - <td class="swatch-col"><span class="swatch" style="background-color: #333;"></span></td> - </tr> - <tr> - <td><code>@linkColor</code></td> - <td><code>#08c</code></td> - <td>{{_i}}Default link text color{{/i}}</td> - <td class="swatch-col"><span class="swatch" style="background-color: #08c;"></span></td> - </tr> - <tr> - <td><code>@linkColorHover</code></td> - <td><code>darken(@linkColor, 15%)</code></td> - <td>{{_i}}Default link text hover color{{/i}}</td> - <td><span class="swatch" style="background-color: #005580;"></span></td> - </tr> - </tbody> - </table> - <h3>{{_i}}Grid system{{/i}}</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@gridColumns</code></td> - <td>12</td> - </tr> - <tr> - <td><code>@gridColumnWidth</code></td> - <td>60px</td> - </tr> - <tr> - <td><code>@gridGutterWidth</code></td> - <td>20px</td> - </tr> - <tr> - <td><code>@fluidGridColumnWidth</code></td> - <td>6.382978723%</td> - </tr> - <tr> - <td><code>@fluidGridGutterWidth</code></td> - <td>2.127659574%</td> - </tr> - </tbody> - </table> - <h3>{{_i}}Typography{{/i}}</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@sansFontFamily</code></td> - <td colspan="2">"Helvetica Neue", Helvetica, Arial, sans-serif</td> - </tr> - <tr> - <td><code>@serifFontFamily</code></td> - <td colspan="2"><code>Georgia, "Times New Roman", Times, serif</code></td> - </tr> - <tr> - <td><code>@monoFontFamily</code></td> - <td colspan="2">Menlo, Monaco, "Courier New", monospace</td> - </tr> - - <tr> - <td><code>@baseFontSize</code></td> - <td>13px</td> - <td><em class="muted">Must be pixels</em></td> - </tr> - <tr> - <td><code>@baseFontFamily</code></td> - <td colspan="2"><code>@sansFontFamily</code></td> - </tr> - <tr> - <td><code>@baseLineHeight</code></td> - <td>18px</td> - <td><em class="muted">Must be pixels</em></td> - </tr> - <tr> - <td><code>@altFontFamily</code></td> - <td colspan="2"><code>@serifFontFamily</code></td> - </tr> - - <tr> - <td><code>@headingsFontFamily</code></td> - <td colspan="2"><code>inherit</code></td> - </tr> - <tr> - <td><code>@headingsFontWeight</code></td> - <td colspan="2"><code>bold</code></td> - </tr> - <tr> - <td><code>@headingsColor</code></td> - <td colspan="2"><code>inherit</code></td> - </tr> - </tbody> - </table> - <h3>{{_i}}Tables{{/i}}</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@tableBackground</code></td> - <td><code>transparent</code></td> - </tr> - <tr> - <td><code>@tableBackgroundAccent</code></td> - <td><code>#f9f9f9</code></td> - </tr> - <tr> - <td><code>@tableBackgroundHover</code></td> - <td><code>#f5f5f5</code></td> - </tr> - <tr> - <td><code>@tableBorder</code></td> - <td><code>#ddd</code></td> - </tr> - </tbody> - </table> - - <h3>{{_i}}Grayscale colors{{/i}}</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@black</code></td> - <td>#000</td> - <td class="swatch-col"><span class="swatch" style="background-color: #000;"></span></td> - </tr> - <tr> - <td><code>@grayDarker</code></td> - <td>#222</td> - <td><span class="swatch" style="background-color: #222;"></span></td> - </tr> - <tr> - <td><code>@grayDark</code></td> - <td>#333</td> - <td><span class="swatch" style="background-color: #333;"></span></td> - </tr> - <tr> - <td><code>@gray</code></td> - <td>#555</td> - <td><span class="swatch" style="background-color: #555;"></span></td> - </tr> - <tr> - <td><code>@grayLight</code></td> - <td>#999</td> - <td><span class="swatch" style="background-color: #999;"></span></td> - </tr> - <tr> - <td><code>@grayLighter</code></td> - <td>#eee</td> - <td><span class="swatch" style="background-color: #eee;"></span></td> - </tr> - <tr> - <td><code>@white</code></td> - <td>#fff</td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - </tbody> - </table> - <h3>{{_i}}Accent colors{{/i}}</h3> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@blue</code></td> - <td>#049cdb</td> - <td class="swatch-col"><span class="swatch" style="background-color: #049cdb;"></span></td> - </tr> - <tr> - <td><code>@green</code></td> - <td>#46a546</td> - <td><span class="swatch" style="background-color: #46a546;"></span></td> - </tr> - <tr> - <td><code>@red</code></td> - <td>#9d261d</td> - <td><span class="swatch" style="background-color: #9d261d;"></span></td> - </tr> - <tr> - <td><code>@yellow</code></td> - <td>#ffc40d</td> - <td><span class="swatch" style="background-color: #ffc40d;"></span></td> - </tr> - <tr> - <td><code>@orange</code></td> - <td>#f89406</td> - <td><span class="swatch" style="background-color: #f89406;"></span></td> - </tr> - <tr> - <td><code>@pink</code></td> - <td>#c3325f</td> - <td><span class="swatch" style="background-color: #c3325f;"></span></td> - </tr> - <tr> - <td><code>@purple</code></td> - <td>#7a43b6</td> - <td><span class="swatch" style="background-color: #7a43b6;"></span></td> - </tr> - </tbody> - </table> - - - <h3>{{_i}}Components{{/i}}</h3> - - <h4>{{_i}}Buttons{{/i}}</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@btnBackground</code></td> - <td><code>@white</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@btnBackgroundHighlight</code></td> - <td><code>darken(@white, 10%)</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #e6e6e6;"></span></td> - </tr> - <tr> - <td><code>@btnBorder</code></td> - <td><code>darken(@white, 20%)</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #ccc;"></span></td> - </tr> - - <tr> - <td><code>@btnPrimaryBackground</code></td> - <td><code>@linkColor</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #08c;"></span></td> - </tr> - <tr> - <td><code>@btnPrimaryBackgroundHighlight</code></td> - <td><code>spin(@btnPrimaryBackground, 15%)</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #05c;"></span></td> - </tr> - - <tr> - <td><code>@btnInfoBackground</code></td> - <td><code>#5bc0de</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #5bc0de;"></span></td> - </tr> - <tr> - <td><code>@btnInfoBackgroundHighlight</code></td> - <td><code>#2f96b4</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #2f96b4;"></span></td> - </tr> - - <tr> - <td><code>@btnSuccessBackground</code></td> - <td><code>#62c462</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #62c462;"></span></td> - </tr> - <tr> - <td><code>@btnSuccessBackgroundHighlight</code></td> - <td><code>#51a351</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #51a351;"></span></td> - </tr> - - <tr> - <td><code>@btnWarningBackground</code></td> - <td><code>lighten(@orange, 15%)</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #fbb450;"></span></td> - </tr> - <tr> - <td><code>@btnWarningBackgroundHighlight</code></td> - <td><code>@orange</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #f89406;"></span></td> - </tr> - - <tr> - <td><code>@btnDangerBackground</code></td> - <td><code>#ee5f5b</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #ee5f5b;"></span></td> - </tr> - <tr> - <td><code>@btnDangerBackgroundHighlight</code></td> - <td><code>#bd362f</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #bd362f;"></span></td> - </tr> - - <tr> - <td><code>@btnInverseBackground</code></td> - <td><code>@gray</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #555;"></span></td> - </tr> - <tr> - <td><code>@btnInverseBackgroundHighlight</code></td> - <td><code>@grayDarker</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #222;"></span></td> - </tr> - </tbody> - </table> - <h4>{{_i}}Forms{{/i}}</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@placeholderText</code></td> - <td><code>@grayLight</code></td> - </tr> - <tr> - <td><code>@inputBackground</code></td> - <td><code>@white</code></td> - </tr> - <tr> - <td><code>@inputBorder</code></td> - <td><code>#ccc</code></td> - </tr> - <tr> - <td><code>@inputBorderRadius</code></td> - <td><code>3px</code></td> - </tr> - <tr> - <td><code>@inputDisabledBackground</code></td> - <td><code>@grayLighter</code></td> - </tr> - <tr> - <td><code>@formActionsBackground</code></td> - <td><code>#f5f5f5</code></td> - </tr> - </tbody> - </table> - <h4>{{_i}}Form states and alerts{{/i}}</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@warningText</code></td> - <td>#c09853</td> - <td><span class="swatch" style="background-color: #c09853;"></span></td> - </tr> - <tr> - <td><code>@warningBackground</code></td> - <td>#f3edd2</td> - <td class="swatch-col"><span class="swatch" style="background-color: #f3edd2;"></span></td> - </tr> - <tr> - <td><code>@errorText</code></td> - <td>#b94a48</td> - <td><span class="swatch" style="background-color: #b94a48;"></span></td> - </tr> - <tr> - <td><code>@errorBackground</code></td> - <td>#f2dede</td> - <td><span class="swatch" style="background-color: #f2dede;"></span></td> - </tr> - <tr> - <td><code>@successText</code></td> - <td>#468847</td> - <td><span class="swatch" style="background-color: #468847;"></span></td> - </tr> - <tr> - <td><code>@successBackground</code></td> - <td>#dff0d8</td> - <td><span class="swatch" style="background-color: #dff0d8;"></span></td> - </tr> - <tr> - <td><code>@infoText</code></td> - <td>#3a87ad</td> - <td><span class="swatch" style="background-color: #3a87ad;"></span></td> - </tr> - <tr> - <td><code>@infoBackground</code></td> - <td>#d9edf7</td> - <td><span class="swatch" style="background-color: #d9edf7;"></span></td> - </tr> - </tbody> - </table> - - <h4>{{_i}}Navbar{{/i}}</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@navbarHeight</code></td> - <td>40px</td> - <td class="swatch-col"></td> - </tr> - <tr> - <td><code>@navbarBackground</code></td> - <td><code>@grayDarker</code></td> - <td><span class="swatch" style="background-color: #222;"></span></td> - </tr> - <tr> - <td><code>@navbarBackgroundHighlight</code></td> - <td><code>@grayDark</code></td> - <td><span class="swatch" style="background-color: #333;"></span></td> - </tr> - - <tr> - <td><code>@navbarText</code></td> - <td><code>@grayLight</code></td> - <td><span class="swatch" style="background-color: #999;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkColor</code></td> - <td><code>@grayLight</code></td> - <td><span class="swatch" style="background-color: #999;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkColorHover</code></td> - <td><code>@white</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkColorActive</code></td> - <td><code>@navbarLinkColorHover</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkBackgroundHover</code></td> - <td><code>transparent</code></td> - <td><span class="swatch swatch-bordered" style="background-color: transparent;"></span></td> - </tr> - <tr> - <td><code>@navbarLinkBackgroundActive</code></td> - <td><code>@navbarBackground</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - - <tr> - <td><code>@navbarSearchBackground</code></td> - <td><code>lighten(@navbarBackground, 25%)</code></td> - <td><span class="swatch" style="background-color: #666;"></span></td> - </tr> - <tr> - <td><code>@navbarSearchBackgroundFocus</code></td> - <td><code>@white</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - <tr> - <td><code>@navbarSearchBorder</code></td> - <td><code>darken(@navbarSearchBackground, 30%)</code></td> - <td><span class="swatch" style="background-color: #111;"></span></td> - </tr> - <tr> - <td><code>@navbarSearchPlaceholderColor</code></td> - <td><code>#ccc</code></td> - <td><span class="swatch" style="background-color: #ccc;"></span></td> - </tr> - <tr> - <td><code>@navbarBrandColor</code></td> - <td><code>@navbarLinkColor</code></td> - <td><span class="swatch swatch-bordered" style="background-color: #fff;"></span></td> - </tr> - </tbody> - </table> - <h4>{{_i}}Dropdowns{{/i}}</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@dropdownBackground</code></td> - <td><code>@white</code></td> - </tr> - <tr> - <td><code>@dropdownBorder</code></td> - <td><code>rgba(0,0,0,.2)</code></td> - </tr> - <tr> - <td><code>@dropdownLinkColor</code></td> - <td><code>@grayDark</code></td> - </tr> - <tr> - <td><code>@dropdownLinkColorHover</code></td> - <td><code>@white</code></td> - </tr> - <tr> - <td><code>@dropdownLinkColorActive</code></td> - <td><code>@linkColor</code></td> - </tr> - <tr> - <td><code>@dropdownLinkBackgroundHover</code></td> - <td><code>@grayLighter</code></td> - </tr> - <tr> - <td><code>@dropdownLinkBackgroundActive</code></td> - <td><code>@linkColor</code></td> - </tr> - <tr> - <td><code>@dropdownDividerTop</code></td> - <td><code>#e5e5e5</code></td> - </tr> - <tr> - <td><code>@dropdownDividerBottom</code></td> - <td><code>@white</code></td> - </tr> - </tbody> - </table> - <h4>{{_i}}Hero unit{{/i}}</h4> - <table class="table table-bordered table-striped"> - <tbody> - <tr> - <td class="span4"><code>@heroUnitBackground</code></td> - <td><code>@grayLighter</code></td> - <td class="swatch-col"><span class="swatch" style="background-color: #eee;"></span></td> - </tr> - <tr> - <td class="span2"><code>@heroUnitHeadingColor</code></td> - <td><code>inherit</code></td> - <td></td> - </tr> - <tr> - <td><code>@heroUnitLeadColor</code></td> - <td><code>inherit</code></td> - <td></td> - </tr> - </tbody> - </table> - - -</section> - - - -<!-- MIXINS -================================================== --> -<section id="mixins"> - <div class="page-header"> - <h1>{{_i}}Bootstrap mixins <small></small>{{/i}}</h1> - </div> - <h2>{{_i}}About mixins{{/i}}</h2> - <div class="row"> - <div class="span4"> - <h3>{{_i}}Basic mixins{{/i}}</h3> - <p>{{_i}}A basic mixin is essentially an include or a partial for a snippet of CSS. They're written just like a CSS class and can be called anywhere.{{/i}}</p> -<pre class="prettyprint linenums"> -.element { - .clearfix(); -} -</pre> - </div><!-- /span4 --> - <div class="span4"> - <h3>{{_i}}Parametric mixins{{/i}}</h3> - <p>{{_i}}A parametric mixin is just like a basic mixin, but it also accepts parameters (hence the name) with optional default values.{{/i}}</p> -<pre class="prettyprint linenums"> -.element { - .border-radius(4px); -} -</pre> - </div><!-- /span4 --> - <div class="span4"> - <h3>{{_i}}Easily add your own{{/i}}</h3> - <p>{{_i}}Nearly all of Bootstrap's mixins are stored in mixins.less, a wonderful utility .less file that enables you to use a mixin in any of the .less files in the toolkit.{{/i}}</p> - <p>{{_i}}So, go ahead and use the existing ones or feel free to add your own as you need.{{/i}}</p> - </div><!-- /span4 --> - </div><!-- /row --> - <h2>{{_i}}Included mixins{{/i}}</h2> - <h3>{{_i}}Utilities{{/i}}</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">{{_i}}Mixin{{/i}}</th> - <th>{{_i}}Parameters{{/i}}</th> - <th>{{_i}}Usage{{/i}}</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>.clearfix()</code></td> - <td><em class="muted">none</em></td> - <td>{{_i}}Add to any parent to clear floats within{{/i}}</td> - </tr> - <tr> - <td><code>.tab-focus()</code></td> - <td><em class="muted">none</em></td> - <td>{{_i}}Apply the Webkit focus style and round Firefox outline{{/i}}</td> - </tr> - <tr> - <td><code>.center-block()</code></td> - <td><em class="muted">none</em></td> - <td>{{_i}}Auto center a block-level element using <code>margin: auto</code>{{/i}}</td> - </tr> - <tr> - <td><code>.ie7-inline-block()</code></td> - <td><em class="muted">none</em></td> - <td>{{_i}}Use in addition to regular <code>display: inline-block</code> to get IE7 support{{/i}}</td> - </tr> - <tr> - <td><code>.size()</code></td> - <td><code>@height @width</code></td> - <td>{{_i}}Quickly set the height and width on one line{{/i}}</td> - </tr> - <tr> - <td><code>.square()</code></td> - <td><code>@size</code></td> - <td>{{_i}}Builds on <code>.size()</code> to set the width and height as same value{{/i}}</td> - </tr> - <tr> - <td><code>.opacity()</code></td> - <td><code>@opacity</code></td> - <td>{{_i}}Set, in whole numbers, the opacity percentage (e.g., "50" or "75"){{/i}}</td> - </tr> - </tbody> - </table> - <h3>Forms</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">{{_i}}Mixin{{/i}}</th> - <th>{{_i}}Parameters{{/i}}</th> - <th>{{_i}}Usage{{/i}}</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>.placeholder()</code></td> - <td><code>@color: @placeholderText</code></td> - <td>{{_i}}Set the <code>placeholder</code> text color for inputs{{/i}}</td> - </tr> - </tbody> - </table> - <h3>Typography</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">{{_i}}Mixin{{/i}}</th> - <th>{{_i}}Parameters{{/i}}</th> - <th>{{_i}}Usage{{/i}}</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>#font > #family > .serif()</code></td> - <td><em class="muted">none</em></td> - <td>{{_i}}Make an element use a serif font stack{{/i}}</td> - </tr> - <tr> - <td><code>#font > #family > .sans-serif()</code></td> - <td><em class="muted">none</em></td> - <td>{{_i}}Make an element use a sans-serif font stack{{/i}}</td> - </tr> - <tr> - <td><code>#font > #family > .monospace()</code></td> - <td><em class="muted">none</em></td> - <td>{{_i}}Make an element use a monospace font stack{{/i}}</td> - </tr> - <tr> - <td><code>#font > .shorthand()</code></td> - <td><code>@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight</code></td> - <td>{{_i}}Easily set font size, weight, and leading{{/i}}</td> - </tr> - <tr> - <td><code>#font > .serif()</code></td> - <td><code>@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight</code></td> - <td>{{_i}}Set font family to serif, and control size, weight, and leading{{/i}}</td> - </tr> - <tr> - <td><code>#font > .sans-serif()</code></td> - <td><code>@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight</code></td> - <td>{{_i}}Set font family to sans-serif, and control size, weight, and leading{{/i}}</td> - </tr> - <tr> - <td><code>#font > .monospace()</code></td> - <td><code>@size: @baseFontSize, @weight: normal, @lineHeight: @baseLineHeight</code></td> - <td>{{_i}}Set font family to monospace, and control size, weight, and leading{{/i}}</td> - </tr> - </tbody> - </table> - <h3>Grid system</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">{{_i}}Mixin{{/i}}</th> - <th>{{_i}}Parameters{{/i}}</th> - <th>{{_i}}Usage{{/i}}</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>.container-fixed()</code></td> - <td><em class="muted">none</em></td> - <td>{{_i}}Create a horizontally centered container for holding your content{{/i}}</td> - </tr> - <tr> - <td><code>#grid > .core()</code></td> - <td><code>@gridColumnWidth, @gridGutterWidth</code></td> - <td>{{_i}}Generate a pixel grid system (container, row, and columns) with <em>n</em> columns and <em>x</em> pixel wide gutter{{/i}}</td> - </tr> - <tr> - <td><code>#grid > .fluid()</code></td> - <td><code>@fluidGridColumnWidth, @fluidGridGutterWidth</code></td> - <td>{{_i}}Generate a percent grid system with <em>n</em> columns and <em>x</em> % wide gutter{{/i}}</td> - </tr> - <tr> - <td><code>#grid > .input()</code></td> - <td><code>@gridColumnWidth, @gridGutterWidth</code></td> - <td>{{_i}}Generate the pixel grid system for <code>input</code> elements, accounting for padding and borders{{/i}}</td> - </tr> - <tr> - <td><code>.makeColumn</code></td> - <td><code>@columns: 1, @offset: 0</code></td> - <td>{{_i}}Turn any <code>div</code> into a grid column without the <code>.span*</code> classes{{/i}}</td> - </tr> - </tbody> - </table> - <h3>{{_i}}CSS3 properties{{/i}}</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span3">{{_i}}Mixin{{/i}}</th> - <th>{{_i}}Parameters{{/i}}</th> - <th>{{_i}}Usage{{/i}}</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>.border-radius()</code></td> - <td><code>@radius</code></td> - <td>{{_i}}Round the corners of an element. Can be a single value or four space-separated values{{/i}}</td> - </tr> - <tr> - <td><code>.box-shadow()</code></td> - <td><code>@shadow</code></td> - <td>{{_i}}Add a drop shadow to an element{{/i}}</td> - </tr> - <tr> - <td><code>.transition()</code></td> - <td><code>@transition</code></td> - <td>{{_i}}Add CSS3 transition effect (e.g., <code>all .2s linear</code>){{/i}}</td> - </tr> - <tr> - <td><code>.rotate()</code></td> - <td><code>@degrees</code></td> - <td>{{_i}}Rotate an element <em>n</em> degrees{{/i}}</td> - </tr> - <tr> - <td><code>.scale()</code></td> - <td><code>@ratio</code></td> - <td>{{_i}}Scale an element to <em>n</em> times its original size{{/i}}</td> - </tr> - <tr> - <td><code>.translate()</code></td> - <td><code>@x, @y</code></td> - <td>{{_i}}Move an element on the x and y planes{{/i}}</td> - </tr> - <tr> - <td><code>.background-clip()</code></td> - <td><code>@clip</code></td> - <td>{{_i}}Crop the background of an element (useful for <code>border-radius</code>){{/i}}</td> - </tr> - <tr> - <td><code>.background-size()</code></td> - <td><code>@size</code></td> - <td>{{_i}}Control the size of background images via CSS3{{/i}}</td> - </tr> - <tr> - <td><code>.box-sizing()</code></td> - <td><code>@boxmodel</code></td> - <td>{{_i}}Change the box model for an element (e.g., <code>border-box</code> for a full-width <code>input</code>){{/i}}</td> - </tr> - <tr> - <td><code>.user-select()</code></td> - <td><code>@select</code></td> - <td>{{_i}}Control cursor selection of text on a page{{/i}}</td> - </tr> - <tr> - <td><code>.backface-visibility()</code></td> - <td><code>@visibility: visible</code></td> - <td>{{_i}}Prevent flickering of content when using CSS 3D transforms{{/i}}</td> - </tr> - <tr> - <td><code>.resizable()</code></td> - <td><code>@direction: both</code></td> - <td>{{_i}}Make any element resizable on the right and bottom{{/i}}</td> - </tr> - <tr> - <td><code>.content-columns()</code></td> - <td><code>@columnCount, @columnGap: @gridGutterWidth</code></td> - <td>{{_i}}Make the content of any element use CSS3 columns{{/i}}</td> - </tr> - <tr> - <td><code>.hyphens()</code></td> - <td><code>@mode: auto</code></td> - <td>{{_i}}CSS3 hyphenation when you want it (includes <code>word-wrap: break-word</code>){{/i}}</td> - </tr> - </tbody> - </table> - <h3>{{_i}}Backgrounds and gradients{{/i}}</h3> - <table class="table table-bordered table-striped"> - <thead> - <tr> - <th class="span4">{{_i}}Mixin{{/i}}</th> - <th>{{_i}}Parameters{{/i}}</th> - <th>{{_i}}Usage{{/i}}</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>#translucent > .background()</code></td> - <td><code>@color: @white, @alpha: 1</code></td> - <td>{{_i}}Give an element a translucent background color{{/i}}</td> - </tr> - <tr> - <td><code>#translucent > .border()</code></td> - <td><code>@color: @white, @alpha: 1</code></td> - <td>{{_i}}Give an element a translucent border color{{/i}}</td> - </tr> - <tr> - <td><code>#gradient > .vertical()</code></td> - <td><code>@startColor, @endColor</code></td> - <td>{{_i}}Create a cross-browser vertical background gradient{{/i}}</td> - </tr> - <tr> - <td><code>#gradient > .horizontal()</code></td> - <td><code>@startColor, @endColor</code></td> - <td>{{_i}}Create a cross-browser horizontal background gradient{{/i}}</td> - </tr> - <tr> - <td><code>#gradient > .directional()</code></td> - <td><code>@startColor, @endColor, @deg</code></td> - <td>{{_i}}Create a cross-browser directional background gradient{{/i}}</td> - </tr> - <tr> - <td><code>#gradient > .vertical-three-colors()</code></td> - <td><code>@startColor, @midColor, @colorStop, @endColor</code></td> - <td>{{_i}}Create a cross-browser three-color background gradient{{/i}}</td> - </tr> - <tr> - <td><code>#gradient > .radial()</code></td> - <td><code>@innerColor, @outerColor</code></td> - <td>{{_i}}Create a cross-browser radial background gradient{{/i}}</td> - </tr> - <tr> - <td><code>#gradient > .striped()</code></td> - <td><code>@color, @angle</code></td> - <td>{{_i}}Create a cross-browser striped background gradient{{/i}}</td> - </tr> - <tr> - <td><code>.gradientBar()</code></td> - <td><code>@primaryColor, @secondaryColor</code></td> - <td>{{_i}}Used for buttons to assign a gradient and slightly darker border{{/i}}</td> - </tr> - </tbody> - </table> -</section> - - - -<!-- COMPILING LESS AND BOOTSTRAP -================================================== --> -<section id="compiling"> - <div class="page-header"> - <h1>{{_i}}Compiling Bootstrap with LESS{{/i}}</h1> - </div> - <div class="alert alert-info"> - {{_i}}<strong>Note:</strong> If you're submitting a pull request to GitHub with modified CSS, you <strong>must</strong> recompile the CSS via any of these methods.{{/i}} - </div> - - <h2>{{_i}}Tools for compiling{{/i}}</h2> - - <h3>{{_i}}Node with makefile{{/i}}</h3> - <p>{{_i}}Install the LESS command line compiler, JSHint, Recess, and uglify-js globally with npm by running the following command:{{/i}}</p> - <pre>$ npm install -g less jshint recess uglify-js</pre> - <p>{{_i}}Once installed just run <code>make</code> from the root of your bootstrap directory and you're all set.{{/i}}</p> - <p>{{_i}}Additionally, if you have <a href="https://github.com/mynyml/watchr">watchr</a> installed, you may run <code>make watch</code> to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).{{/i}}</p> - - <h3>{{_i}}Command line{{/i}}</h3> - <p>{{_i}}Install the LESS command line tool via Node and run the following command:{{/i}}</p> - <pre>$ lessc ./less/bootstrap.less > bootstrap.css</pre> - <p>{{_i}}Be sure to include <code>--compress</code> in that command if you're trying to save some bytes!{{/i}}</p> - - <h3>{{_i}}Javascript{{/i}}</h3> - <p>{{_i}}<a href="http://lesscss.org/">Download the latest Less.js</a> and include the path to it (and Bootstrap) in the <code><head></code>.{{/i}}</p> -<pre class="prettyprint"> -<link rel="stylesheet/less" href="/path/to/bootstrap.less"> -<script src="/path/to/less.js"></script> -</pre> - <p>{{_i}}To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.{{/i}}</p> - - <h3>{{_i}}Unofficial Mac app{{/i}}</h3> - <p>{{_i}}<a href="http://incident57.com/less/">The unofficial Mac app</a> watches directories of .less files and compiles the code to local files after every save of a watched .less file.{{/i}}</p> - <p>{{_i}}If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.{{/i}}</p> - - <h3>{{_i}}More Mac apps{{/i}}</h3> - <h4><a href="http://crunchapp.net/" target="_blank">Crunch</a></h4> - <p>{{_i}}Crunch is a great looking LESS editor and compiler built on Adobe Air.{{/i}}</p> - <h4><a href="http://incident57.com/codekit/" target="_blank">CodeKit</a></h4> - <p>{{_i}}Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.{{/i}}</p> - <h4><a href="http://wearekiss.com/simpless" target="_blank">Simpless</a></h4> - <p>{{_i}}Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the <a href="https://github.com/Paratron/SimpLESS" target="_blank">source code is on GitHub</a>.{{/i}}</p> - -</section> diff --git a/docs/upgrading.html b/docs/upgrading.html index 0ffe9a59f2..f001f17721 100644 --- a/docs/upgrading.html +++ b/docs/upgrading.html @@ -57,9 +57,6 @@ <li class=""> <a href="./javascript.html">Javascript</a> </li> - <li class=""> - <a href="./less.html">LESS</a> - </li> <li class="divider-vertical"></li> <li class=""> <a href="./download.html">Customize</a> @@ -67,6 +64,9 @@ <li class=""> <a href="./examples.html">Examples</a> </li> + <li class=""> + <a href="./extend.html">Extend</a> + </li> </ul> </div> </div> -- GitLab