mirror of
https://github.com/twbs/bootstrap.git
synced 2024-09-28 14:06:00 +00:00
682 lines
26 KiB
Plaintext
682 lines
26 KiB
Plaintext
<!-- 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="subnav">
|
|
<ul class="nav nav-pills">
|
|
<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>
|
|
</header>
|
|
|
|
|
|
|
|
<!-- BUILT WITH LESS
|
|
================================================== -->
|
|
<section id="builtWith">
|
|
<div class="page-header">
|
|
<h1>{{_i}}Built with LESS{{/i}}</h1>
|
|
</div>
|
|
<div class="row">
|
|
<div class="span4">
|
|
<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>
|
|
</div>
|
|
<div class="span4">
|
|
<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>
|
|
</div>
|
|
<div class="span4">
|
|
<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>
|
|
</div>
|
|
</div>
|
|
<div class="row">
|
|
<div class="span4">
|
|
<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>
|
|
</div>
|
|
<div class="span4">
|
|
<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>
|
|
</div>
|
|
<div class="span4">
|
|
<h3>{{_i}}Operations{{/i}}</h3>
|
|
<p>{{_i}}Make your grid, leading, and more super flexible by doing the math on the fly with operations. Multiple, divide, add, and subtract your way to CSS sanity.{{/i}}</p>
|
|
</div>
|
|
</div>
|
|
</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>
|
|
|
|
<div class="row">
|
|
<div class="span6">
|
|
<h3>{{_i}}Hyperlinks{{/i}}</h3>
|
|
<table class="table table-bordered table-striped">
|
|
<tbody>
|
|
<tr>
|
|
<td class="span2"><code>@linkColor</code></td>
|
|
<td>#08c</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="span2"><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="span2"><code>@baseFontSize</code></td>
|
|
<td>13px</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>@baseFontFamily</code></td>
|
|
<td><code>"Helvetica Neue", Helvetica, Arial, sans-serif</code></td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>@baseLineHeight</code></td>
|
|
<td>18px</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="span6">
|
|
<h3>{{_i}}Grayscale colors{{/i}}</h3>
|
|
<table class="table table-bordered table-striped">
|
|
<tbody>
|
|
<tr>
|
|
<td class="span2"><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="span2"><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>
|
|
</div>
|
|
</div> <!-- /row -->
|
|
|
|
<h3>{{_i}}Components{{/i}}</h3>
|
|
<div class="row">
|
|
<div class="span6">
|
|
<h4>{{_i}}Buttons{{/i}}</h4>
|
|
<table class="table table-bordered table-striped">
|
|
<tbody>
|
|
<tr>
|
|
<td class="span3"><code>@primaryButtonBackground</code></td>
|
|
<td><code>@linkColor</code></td>
|
|
<td class="swatch-col"><span class="swatch" style="background-color: #08c;"></span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h4>{{_i}}Forms{{/i}}</h4>
|
|
<table class="table table-bordered table-striped">
|
|
<tbody>
|
|
<tr>
|
|
<td class="span3"><code>@placeholderText</code></td>
|
|
<td><code>@grayLight</code></td>
|
|
<td class="swatch-col"><span class="swatch" style="background-color: #999;"></span></td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<h4>{{_i}}Navbar{{/i}}</h4>
|
|
<table class="table table-bordered table-striped">
|
|
<tbody>
|
|
<tr>
|
|
<td class="span3"><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>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
<div class="span6">
|
|
<h4>{{_i}}Form states and alerts{{/i}}</h4>
|
|
<table class="table table-bordered table-striped">
|
|
<tbody>
|
|
<tr>
|
|
<td class="span3"><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>
|
|
</div>
|
|
</div><!-- /row -->
|
|
|
|
</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: 5px, @width: 5px</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: 5px</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: 100</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}}Provide a fixed-width (set with <code>@siteWidth</code>) container for holding your content{{/i}}</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>.columns()</code></td>
|
|
<td><code>@columns: 1</code></td>
|
|
<td>{{_i}}Build a grid column that spans any number of columns (defaults to 1 column){{/i}}</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>.offset()</code></td>
|
|
<td><code>@columns: 1</code></td>
|
|
<td>{{_i}}Offset a grid column with left margin that spans any number of columns{{/i}}</td>
|
|
</tr>
|
|
<tr>
|
|
<td><code>.gridColumn()</code></td>
|
|
<td><em class="muted">none</em></td>
|
|
<td>{{_i}}Make an element float like a grid column{{/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: 5px</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: 0 1px 3px rgba(0,0,0,.25)</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: 0, @y: 0</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>.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: @gridColumnGutter</code></td>
|
|
<td>{{_i}}Make the content of any element use CSS3 columns{{/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>
|
|
<div class="row">
|
|
<div class="span4">
|
|
<h3>{{_i}}Node with makefile{{/i}}</h3>
|
|
<p>{{_i}}Install the LESS command line compiler with npm by running the following command:{{/i}}</p>
|
|
<pre>$ npm install less</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>
|
|
</div><!-- /span4 -->
|
|
<div class="span4">
|
|
<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 ./lib/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>
|
|
</div><!-- /span4 -->
|
|
<div class="span4">
|
|
<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>
|
|
</div><!-- /span4 -->
|
|
</div><!-- /row -->
|
|
<div class="row">
|
|
<div class="span4">
|
|
<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>
|
|
</div><!-- /span4 -->
|
|
<div class="span4">
|
|
<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>
|
|
</div><!-- /span4 -->
|
|
</div><!-- /row -->
|
|
</section>
|