From 648c4689273647c321dd6e3979d910282e9a9339 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 26 Oct 2011 23:11:56 -0700 Subject: breaking down the main page into subpages for easier, more comprehensive documentation --- docs/less.html | 242 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 242 insertions(+) create mode 100644 docs/less.html (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html new file mode 100644 index 000000000..806c2eede --- /dev/null +++ b/docs/less.html @@ -0,0 +1,242 @@ + + + + + Bootstrap, from Twitter + + + + + + + + + + + + + + + + + + + + + + + +
+ + +
+

Using LESS

+

Be a boss and use Bootstrap's built-in variables, mixins, and more via LESS

+
+ + + +
+ +
+
+

Bootstrap was built with Preboot, an open-source pack of mixins and variables to be used in conjunction with Less, a CSS preprocessor for faster and easier web development.

+

Check out how we used Preboot in Bootstrap and how you can make use of it should you choose to run Less on your next project.

+
+
+

How to use it

+

Use this option to make full use of Bootstrap’s Less variables, mixins, and nesting in CSS via javascript in your browser.

+
+<link rel="stylesheet/less" href="less/bootstrap.less" media="all" />
+<script src="js/less-1.1.3.min.js"></script>
+

Not feeling the .js solution? Try the Less Mac app or use Node.js to compile when you deploy your code.

+ +

What’s included

+

Here are some of the highlights of what’s included in Twitter Bootstrap as part of Bootstrap. Head over to the Bootstrap website or Github project page to download and learn more.

+

Variables

+

Variables in Less are perfect for maintaining and updating your CSS headache free. When you want to change a color value or a frequently used value, update it in one spot and you’re set.

+
+// Links
+@linkColor:         #8b59c2;
+@linkColorHover:    darken(@linkColor, 10);
+
+// Grays
+@black:             #000;
+@grayDark:          lighten(@black, 25%);
+@gray:              lighten(@black, 50%);
+@grayLight:         lighten(@black, 70%);
+@grayLighter:       lighten(@black, 90%);
+@white:             #fff;
+
+// Accent Colors
+@blue:              #08b5fb;
+@green:             #46a546;
+@red:               #9d261d;
+@yellow:            #ffc40d;
+@orange:            #f89406;
+@pink:              #c3325f;
+@purple:            #7a43b6;
+
+// Baseline grid
+@basefont:          13px;
+@baseline:          18px;
+
+ +

Commenting

+

Less also provides another style of commenting in addition to CSS’s normal /* ... */ syntax.

+
+// This is a comment
+/* This is also a comment */
+
+ +

Mixins up the wazoo

+

Mixins are basically includes or partials for CSS, allowing you to combine a block of code into one. They’re great for vendor prefixed properties like box-shadow, cross-browser gradients, font stacks, and more. Below is a sample of the mixins that are included with Bootstrap.

+

Font stacks

+
+#font {
+  .shorthand(@weight: normal, @size: 14px, @lineHeight: 20px) {
+    font-size: @size;
+    font-weight: @weight;
+    line-height: @lineHeight;
+  }
+  .sans-serif(@weight: normal, @size: 14px, @lineHeight: 20px) {
+    font-family: "Helvetica Neue", Helvetica, Arial, sans-serif;
+    font-size: @size;
+    font-weight: @weight;
+    line-height: @lineHeight;
+  }
+  ...
+}
+
+

Gradients

+
+#gradient {
+  ...
+  .vertical (@startColor: #555, @endColor: #333) {
+    background-color: @endColor;
+    background-repeat: repeat-x;
+    background-image: -khtml-gradient(linear, left top, left bottom, from(@startColor), to(@endColor)); // Konqueror
+    background-image: -moz-linear-gradient(@startColor, @endColor); // FF 3.6+
+    background-image: -ms-linear-gradient(@startColor, @endColor); // IE10
+    background-image: -webkit-gradient(linear, left top, left bottom, color-stop(0%, @startColor), color-stop(100%, @endColor)); // Safari 4+, Chrome 2+
+    background-image: -webkit-linear-gradient(@startColor, @endColor); // Safari 5.1+, Chrome 10+
+    background-image: -o-linear-gradient(@startColor, @endColor); // Opera 11.10
+    background-image: linear-gradient(@startColor, @endColor); // The standard
+  }
+  ...
+}
+
+ +

Operations

+

Get fancy and perform some math to generate flexible and powerful mixins like the one below.

+
+// Griditude
+@gridColumns:       16;
+@gridColumnWidth:   40px;
+@gridGutterWidth:   20px;
+@siteWidth:         (@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1));
+
+// Make some columns
+.columns(@columnSpan: 1) {
+  width: (@gridColumnWidth * @columnSpan) + (@gridGutterWidth * (@columnSpan - 1));
+}
+
+ +

Compiling Less

+

After modifying the .less files in /lib/, you'll need to recompile them in order to regenerate the bootstrap-*.*.*.css and bootstrap-*.*.*.min.css files. If you're submitting a pull request to GitHub, you must always recompile.

+

Ways to compile

+ + + + + + + + + + + + + + + + + + + + + + + + +
MethodSteps
Node with makefile +

Install the less command line compiler with npm by running the following command:

+
$ npm install lessc
+

Once installed just run make from the root of your bootstrap directory and you're all set.

+

Additionally, if you have watchr installed, you may run make watch to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).

+
Javascript +

Download the latest Less.js and include the path to it (and Bootstrap) in the head.

+
+<link rel="stylesheet/less" href="/path/to/bootstrap.less">
+<script src="/path/to/less.js"></script>
+
+

To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.

+
Command line +

If you already have the less command line tool installed, simply run the following command:

+
$ lessc ./lib/bootstrap.less > bootstrap.css
+

Be sure to include --compress in that command if you're trying to save some bytes!

+
Mac app +

The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.

+

If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.

+
+
+
+ +
+ + + + +
+ + + + + + + + + + + + + + -- cgit v1.2.3 From b4c894961c0b75361ead496f1686eb3cf41c5c97 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 26 Oct 2011 23:24:22 -0700 Subject: address issue #414 and fix up a number of docs loose ends --- docs/less.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 806c2eede..d5a467bfa 100644 --- a/docs/less.html +++ b/docs/less.html @@ -185,7 +185,7 @@ Javascript -

Download the latest Less.js and include the path to it (and Bootstrap) in the head.

+

Download the latest Less.js and include the path to it (and Bootstrap) in the <head>.

 <link rel="stylesheet/less" href="/path/to/bootstrap.less">
 <script src="/path/to/less.js"></script>
-- 
cgit v1.2.3


From 02bf27592c8eec51795ac806390bc57db501926d Mon Sep 17 00:00:00 2001
From: Mark Otto 
Date: Mon, 31 Oct 2011 19:37:10 -0700
Subject: overhaul the table styles and update those everywhere in the docs,
 update the button docs, spec out the forms docs

---
 docs/less.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

(limited to 'docs/less.html')

diff --git a/docs/less.html b/docs/less.html
index d5a467bfa..4fa0f0bdd 100644
--- a/docs/less.html
+++ b/docs/less.html
@@ -166,7 +166,7 @@
     

Compiling Less

After modifying the .less files in /lib/, you'll need to recompile them in order to regenerate the bootstrap-*.*.*.css and bootstrap-*.*.*.min.css files. If you're submitting a pull request to GitHub, you must always recompile.

Ways to compile

- +
-- cgit v1.2.3 From 74dc83f211245dfaf06da9a1b2ad94f51f790be2 Mon Sep 17 00:00:00 2001 From: Raul Riera Date: Mon, 7 Nov 2011 10:22:28 +0100 Subject: Added the view port meta tag for proper responsiveness --- docs/less.html | 1 + 1 file changed, 1 insertion(+) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 4fa0f0bdd..6d3802c3b 100644 --- a/docs/less.html +++ b/docs/less.html @@ -3,6 +3,7 @@ Bootstrap, from Twitter + -- cgit v1.2.3 From 0e6cd670ca0619c663c016c08059530b598e15d3 Mon Sep 17 00:00:00 2001 From: Raul Riera Date: Tue, 8 Nov 2011 20:32:28 +0100 Subject: Removed trailing backslash :) --- docs/less.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 6d3802c3b..c76be9a5d 100644 --- a/docs/less.html +++ b/docs/less.html @@ -3,7 +3,7 @@ Bootstrap, from Twitter - + -- cgit v1.2.3 From 1fb98bed91977b710ae321443d0819939a1a8cc7 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 12 Nov 2011 00:46:02 -0800 Subject: updated docs pages (still wip), adding misc css classes, added form styles from 1.4, added github buttons to homepage --- docs/less.html | 73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 72 insertions(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 4fa0f0bdd..108ec35df 100644 --- a/docs/less.html +++ b/docs/less.html @@ -48,11 +48,82 @@
-

Using LESS

+

Using LESS with Bootstrap

Be a boss and use Bootstrap's built-in variables, mixins, and more via LESS

+ + + +
+
+

Why LESS?

+

Bootstrap is made with LESS at it's core, a dynamic stylesheet language created by Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

+
+
+

What's included?

+

As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.

+
+
+

Learn more

+ LESS CSS +

Visit the official website at http://lesscss.org to learn more.

+
+
+
+
+

Variables

+

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.

+
+
+

Mixins

+

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.

+
+
+

Operations

+

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.

+
+
+ + + + + + + + + + + + + + + + + + + + + + + +
-- cgit v1.2.3 From a0179322854a9d1e2b9363447c9884e40733d04f Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 16 Nov 2011 23:58:36 -0800 Subject: start breaking down patterns.less into more distinct files, update docs for forms to use correct classes --- docs/less.html | 197 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 195 insertions(+), 2 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index fccd5b9a4..2d35eea26 100644 --- a/docs/less.html +++ b/docs/less.html @@ -95,15 +95,208 @@ +
+
+

Hyperlinks

+
+
+
Method
+ + + + + + + + + + + + + + + + + + + +
VariableValueUsage
@linkColor#0069d6Default link text color
@linkColorHoverdarken(@linkColor, 15)Default link text hover color
+ + + +
+
+

Grayscale colors

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
@black#000Black
@grayDarklighten(@black, 25%)Dark gray
@graylighten(@black, 50%)Medium gray
@grayLightlighten(@black, 75%)Light gray
@grayLighterlighten(@black, 90%)Lighter gray
@white#fffWhite
+
+
+ +
+
+

Accent colors

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
@blue#049CDB
@green#46a546
@red#9d261d
@yellow#ffc40d
@orange#f89406
@pink#c3325f
@purple#7a43b6
+
+
+ +
+
+

Grid system

+
+
+ + + + + + + + + + + + + + + + + + + + + + + +
@gridColumns12
@gridColumnWidth60px
@gridGutterWidth20px
@siteWidth(@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1))
+
+
+ +
+
+

Typography

+
+
+ + + + + + + + + + + + + + + + + + +
@baseFontSize13px
@baseFontFamily"Helvetica Neue", Helvetica, Arial, sans-serif
@baseLineHeight18px
+
+
+ +
+
+

Visuals

+
+
+ + + + + + + + +
@primaryButtonColor@blue
+
+
-- cgit v1.2.3 From 447c9322e96ebd1102115aea01d925536016351a Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 29 Nov 2011 23:56:01 -0800 Subject: update all leads on docs pages --- docs/less.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 2d35eea26..97d95a3ab 100644 --- a/docs/less.html +++ b/docs/less.html @@ -50,7 +50,7 @@ ================================================== -->

Using LESS with Bootstrap

-

Be a boss and use Bootstrap's built-in variables, mixins, and more via LESS

+

Customize and extend Bootstrap with LESS, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.

-- cgit v1.2.3 From b12b71bf7ca76437a532122d8efff59506b61530 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Fri, 9 Dec 2011 11:32:07 -0800 Subject: updated to include sub nav and pip nav, new docs updates, topbar nav refinements for media queried settings --- docs/less.html | 51 ++++++--------------------------------------------- 1 file changed, 6 insertions(+), 45 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 97d95a3ab..e9334a552 100644 --- a/docs/less.html +++ b/docs/less.html @@ -63,7 +63,7 @@

Why LESS?

-

Bootstrap is made with LESS at it's core, a dynamic stylesheet language created by Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

+

Bootstrap is made with LESS at it's core, a dynamic stylesheet language created by Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

What's included?

@@ -72,7 +72,7 @@

Learn more

LESS CSS -

Visit the official website at http://lesscss.org to learn more.

+

Visit the official website at http://lesscss.org to learn more.

@@ -98,11 +98,7 @@

Variables from variables.less

-
-

Hyperlinks

-
-
@@ -124,92 +120,70 @@
-
-
-
+

Grayscale colors

-
-
- - - - - -
@black #000Black
@grayDark lighten(@black, 25%)Dark gray
@gray lighten(@black, 50%)Medium gray
@grayLight lighten(@black, 75%)Light gray
@grayLighter lighten(@black, 90%)Lighter gray
@white #fffWhite
-
- -
-
+

Accent colors

-
-
- - - - - - -
@blue #049CDB
@green #46a546
@red #9d261d
@yellow #ffc40d
@orange #f89406
@pink #c3325f
@purple #7a43b6
@@ -217,48 +191,36 @@
-
+

Grid system

-
-
- - - -
@gridColumns 12
@gridColumnWidth 60px
@gridGutterWidth 20px
@siteWidth (@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1))
-
- -
-
+

Typography

-
-
- @@ -268,7 +230,6 @@ -
@baseFontSize 13px
@baseFontFamily
@baseLineHeight 18px
-- cgit v1.2.3 From 1d1805ee5cb188f0c70b6a27e227ea6caca62c8e Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Fri, 9 Dec 2011 11:41:00 -0800 Subject: add jank js for prototyping new topbar to all docs pages --- docs/less.html | 11 +++++++++++ 1 file changed, 11 insertions(+) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index e9334a552..cbc410302 100644 --- a/docs/less.html +++ b/docs/less.html @@ -456,6 +456,17 @@ + + + -- cgit v1.2.3 From 7b810bf9a617e1f02e073aafcc70857dc915ee59 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Fri, 9 Dec 2011 12:10:01 -0800 Subject: update js in footer, add max-width to img --- docs/less.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index cbc410302..cd2c992df 100644 --- a/docs/less.html +++ b/docs/less.html @@ -460,9 +460,9 @@ -- cgit v1.2.3 From ecbc9ec4a2cbd3f68067b869c328d55e8afc8aa6 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sun, 11 Dec 2011 02:03:16 -0800 Subject: updated footers everywhere --- docs/less.html | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index cd2c992df..ab276eece 100644 --- a/docs/less.html +++ b/docs/less.html @@ -446,10 +446,9 @@ ================================================== -->
-- cgit v1.2.3 From d681ae9f51b85d8e1efae2a819ce289266d7efd0 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Mon, 12 Dec 2011 09:51:41 -0800 Subject: updated docs to include other less apps --- docs/less.html | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index ab276eece..52de8b6aa 100644 --- a/docs/less.html +++ b/docs/less.html @@ -392,7 +392,7 @@

Compiling Less

After modifying the .less files in /lib/, you'll need to recompile them in order to regenerate the bootstrap-*.*.*.css and bootstrap-*.*.*.min.css files. If you're submitting a pull request to GitHub, you must always recompile.

Ways to compile

- +
@@ -428,12 +428,24 @@ - + + + + + + + + + + + + +
Method
Mac appUnofficial Mac app

The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.

If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.

CrunchCrunch is a great looking LESS editor and compiler built on Adobe Air.
CodeKitCreated by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.
SimplessMac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.
-- cgit v1.2.3 From 20aecb983838422c7b43e20960b10d4d79fefaa3 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 21 Dec 2011 16:22:20 -0600 Subject: updated all docs to jQuery 1.7, move all docs JS to application.js, and move dropdowns css to dedicated file --- docs/less.html | 13 +------------ 1 file changed, 1 insertion(+), 12 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 52de8b6aa..e004bc24c 100644 --- a/docs/less.html +++ b/docs/less.html @@ -466,18 +466,7 @@ - - - - + -- cgit v1.2.3 From efacac0d6c812abffa8a84a48fa760f5f56c92f0 Mon Sep 17 00:00:00 2001 From: Jacob Thornton Date: Wed, 21 Dec 2011 18:42:43 -0800 Subject: clean up all the js across all the doc pages --- docs/less.html | 20 ++------------------ 1 file changed, 2 insertions(+), 18 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 52de8b6aa..13dfee282 100644 --- a/docs/less.html +++ b/docs/less.html @@ -466,25 +466,9 @@ - - - - - + + - - - - - -- cgit v1.2.3 From cfc2353059df628c67d19a3c5c3ead2cc6051f53 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Fri, 6 Jan 2012 23:59:22 -0800 Subject: front page docs updated to include old getting started section, update code styles to look like github gists, and lots more docs updates --- docs/less.html | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 7d3efd296..05398e966 100644 --- a/docs/less.html +++ b/docs/less.html @@ -403,8 +403,8 @@ Node with makefile -

Install the less command line compiler with npm by running the following command:

-
$ npm install lessc
+

Install the LESS command line compiler with npm by running the following command:

+
$ npm install less

Once installed just run make from the root of your bootstrap directory and you're all set.

Additionally, if you have watchr installed, you may run make watch to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).

@@ -422,7 +422,7 @@ Command line -

If you already have the less command line tool installed, simply run the following command:

+

Install the LESS command line tool via Node and run the following command:

$ lessc ./lib/bootstrap.less > bootstrap.css

Be sure to include --compress in that command if you're trying to save some bytes!

-- cgit v1.2.3 From 391248c0e3ba9b00b0b4a02e4d94475e9ae9877a Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Thu, 12 Jan 2012 15:29:16 -0800 Subject: nuke uber footer, bring back topbar dropdowns --- docs/less.html | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 65 insertions(+), 5 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 05398e966..cecf22da4 100644 --- a/docs/less.html +++ b/docs/less.html @@ -34,11 +34,71 @@ Bootstrap
-- cgit v1.2.3 From 11be9cd16370ecd15d227917d98ff63eccae68ae Mon Sep 17 00:00:00 2001 From: Purwandi Date: Fri, 13 Jan 2012 14:57:21 +0700 Subject: Fix id anchor javascript --- docs/less.html | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index cecf22da4..ccde9c87e 100644 --- a/docs/less.html +++ b/docs/less.html @@ -80,13 +80,13 @@

Hyperlinks

- +
@@ -185,7 +185,7 @@

Grayscale colors

-
Variable
+
@@ -216,7 +216,7 @@

Accent colors

-
@black
+
@@ -254,7 +254,7 @@

Grid system

-
@blue
+
@@ -277,7 +277,7 @@

Typography

-
@gridColumns
+
@@ -302,7 +302,7 @@

Visuals

-
@baseFontSize
+
@@ -453,7 +453,7 @@

Compiling Less

After modifying the .less files in /lib/, you'll need to recompile them in order to regenerate the bootstrap-*.*.*.css and bootstrap-*.*.*.min.css files. If you're submitting a pull request to GitHub, you must always recompile.

Ways to compile

-
@primaryButtonColor
+
-- cgit v1.2.3 From f1a88eede391cbb4beaadce60768a351724d7633 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Mon, 16 Jan 2012 17:27:30 -0800 Subject: fix js link in docs nav, restyle accordion with new css --- docs/less.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 357f242b1..6e43d95bd 100644 --- a/docs/less.html +++ b/docs/less.html @@ -81,7 +81,7 @@
Method
+
@@ -185,7 +185,7 @@

Grayscale colors

-
Variable
+
@@ -216,7 +216,7 @@

Accent colors

-
@black
+
@@ -254,7 +254,7 @@

Grid system

-
@blue
+
@@ -277,7 +277,7 @@

Typography

-
@gridColumns
+
@@ -302,7 +302,7 @@

Visuals

-
@baseFontSize
+
@@ -453,7 +453,7 @@

Compiling Less

After modifying the .less files in /lib/, you'll need to recompile them in order to regenerate the bootstrap-*.*.*.css and bootstrap-*.*.*.min.css files. If you're submitting a pull request to GitHub, you must always recompile.

Ways to compile

-
@primaryButtonColor
+
-- cgit v1.2.3 From a7bf0295fbf3ce9abc1ca44680f4a6eaf17339b5 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Mon, 23 Jan 2012 11:55:04 -0800 Subject: remove dropdowns, add in sub nav instead --- docs/less.html | 69 ++++++++-------------------------------------------------- 1 file changed, 9 insertions(+), 60 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 09ff3e8e1..0348c0caf 100644 --- a/docs/less.html +++ b/docs/less.html @@ -34,71 +34,20 @@ Bootstrap -- cgit v1.2.3 From f764aee4b919c28974dba7b91edac9a04172ba25 Mon Sep 17 00:00:00 2001 From: Jacob Thornton Date: Mon, 23 Jan 2012 14:14:16 -0800 Subject: add templates for doc generation --- docs/less.html | 41 +++++++++++++++++++++++++++-------------- 1 file changed, 27 insertions(+), 14 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 09ff3e8e1..84f58f00d 100644 --- a/docs/less.html +++ b/docs/less.html @@ -7,7 +7,7 @@ - + @@ -18,10 +18,11 @@ - - - - + + + + + @@ -33,8 +34,8 @@ - - + + - + + - + + + + + + + + + + + + -- cgit v1.2.3 From b4b1ef68398b68dcdfa29465d06cd76d6bf2c49d Mon Sep 17 00:00:00 2001 From: Jacob Thornton Date: Mon, 23 Jan 2012 15:17:32 -0800 Subject: rebuild with new templates --- docs/less.html | 78 ++++++---------------------------------------------------- 1 file changed, 8 insertions(+), 70 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 5c8eb735d..76a47f269 100644 --- a/docs/less.html +++ b/docs/less.html @@ -27,89 +27,27 @@ -
Method
- - - - - - - - - - - - - - - - - - - -
VariableValueUsage
@linkColor#0069d6Default link text color
@linkColorHoverdarken(@linkColor, 15)Default link text hover color
- -
-
-

Grayscale colors

- - - - - - - - - - - - - - - - - - - - - - - - - - - -
@black#000
@grayDarklighten(@black, 25%)
@graylighten(@black, 50%)
@grayLightlighten(@black, 75%)
@grayLighterlighten(@black, 90%)
@white#fff
+
+ -
-

Accent colors

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@blue#049CDB
@green#46a546
@red#9d261d
@yellow#ffc40d
@orange#f89406
@pink#c3325f
@purple#7a43b6
-
-
-
-
-

Grid system

- - - - - - - - - - - - - - - - - - - -
@gridColumns12
@gridColumnWidth60px
@gridGutterWidth20px
@siteWidth(@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1))
-
-
-

Typography

- - - - - - - - - - - - - - - - -
@baseFontSize13px
@baseFontFamily"Helvetica Neue", Helvetica, Arial, sans-serif
@baseLineHeight18px
-
-
+

Hyperlinks

+ + + + + + + + + + + + + + + + + + + + +
VariableValueUsage
@linkColor#08cDefault link text color
@linkColorHoverdarken(@linkColor, 15%)Default link text hover color
+ +
+
+

Grayscale colors

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VariableValue
@black#000
@grayDarker#222
@grayDark#333
@gray#555
@grayLight#999
@grayLighter#eee
@white#fff
+
+
+

Accent colors

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VariableValue
@blue#049cdb
@green#46a546
@red#9d261d
@yellow#ffc40d
@orange#f89406
@pink#c3325f
@purple#7a43b6
+
+
+
+
+

Grid system

+ + + + + + + + + + + + + + + + + + + + + + + + + +
VariableValue
@gridColumns12
@gridColumnWidth60px
@gridGutterWidth20px
@siteWidth(@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1))
+
+
+

Typography

+ + + + + + + + + + + + + + + + + + + + + + +
VariableValue
@baseFontSize13px
@baseFontFamily"Helvetica Neue", Helvetica, Arial, sans-serif
@baseLineHeight18px
+
+
+
+
+

Visuals

+
+
+ + + + + + + + +
@primaryButtonColor@blue
+
+
+ -
-
-

Visuals

-
-
- - - - - - - - -
@primaryButtonColor@blue
-
-
-
-
-

Visuals

-
-
- - - - - - - - -
@primaryButtonColor@blue
-
-
+ +

Components

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Buttons
@primaryButtonColor@blue
Buttons
@placeholderText@grayLight
Navbars
@navbarHeight40px
@navbarBackground@grayDarker
@navbarBackgroundHighlight@grayDark
+ -- cgit v1.2.3 From 805a965f2e7373db42d99376d4dc3c1ca9ea509d Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 24 Jan 2012 17:14:19 -0800 Subject: finish updating form state and alert variables in less docs page --- docs/less.html | 143 +++++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 98 insertions(+), 45 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index dfa0739a7..c9e447382 100644 --- a/docs/less.html +++ b/docs/less.html @@ -58,6 +58,10 @@
+
+ Heads up! This page is still under construction and is missing plenty of documentation. Hang tight! +
+
@@ -285,51 +289,100 @@

Components

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Buttons
@primaryButtonColor@blue
Buttons
@placeholderText@grayLight
Navbars
@navbarHeight40px
@navbarBackground@grayDarker
@navbarBackgroundHighlight@grayDark
+
+
+

Buttons

+ + + + + + + +
@primaryButtonColor@blue
+

Forms

+ + + + + + + +
@placeholderText@grayLight
+

Navbar

+ + + + + + + + + + + + + + + +
@navbarHeight40px
@navbarBackground@grayDarker
@navbarBackgroundHighlight@grayDark
+
+
+

Form states and alerts

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
@warningText#f3edd2
@warningBackground#c09853
@warningBorder#f3edd2
@errorText#b94a48
@errorBackground#f2dede
@errorBorder#e9c7c7
@successText#468847
@successBackground#dff0d8
@successBorder#cfe8c4
@infoText#3a87ad
@infoBackground#d9edf7
@infoBorder#bfe1f2
+
+
-- cgit v1.2.3 From 9ef4171d03e048ee9458fb7a1db83ea61bf845c2 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 24 Jan 2012 18:26:45 -0800 Subject: lighten alert on less page --- docs/less.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index c9e447382..c8c1540b5 100644 --- a/docs/less.html +++ b/docs/less.html @@ -58,7 +58,7 @@
-
+
Heads up! This page is still under construction and is missing plenty of documentation. Hang tight!
-- cgit v1.2.3 From 672ba4c2fd9a42d4f178e795ebc162cce81bbc2f Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 24 Jan 2012 19:19:50 -0800 Subject: update the subnav on all pages --- docs/less.html | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index c8c1540b5..86a65a6c7 100644 --- a/docs/less.html +++ b/docs/less.html @@ -67,12 +67,14 @@

Using LESS with Bootstrap

Customize and extend Bootstrap with LESS, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.

- +
-- cgit v1.2.3 From 5a54a98925f4f7375bdf63f86d21908b05af187e Mon Sep 17 00:00:00 2001 From: Jacob Thornton Date: Tue, 24 Jan 2012 22:37:35 -0800 Subject: subnav spy scrolls blaawerh --- docs/less.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 86a65a6c7..c5fb46ca6 100644 --- a/docs/less.html +++ b/docs/less.html @@ -24,7 +24,7 @@ - + -- cgit v1.2.3 From 6be91368c07ad2b3201d1c669b27fbafb46d0d0e Mon Sep 17 00:00:00 2001 From: Jason Wieland Date: Tue, 24 Jan 2012 23:24:46 -0800 Subject: minor doc updates to inform user they need the current less.js 1.2.1 or they will be hit by this bug #952 --- docs/less.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index c5fb46ca6..e1de9fcc4 100644 --- a/docs/less.html +++ b/docs/less.html @@ -431,7 +431,7 @@

Use this option to make full use of Bootstrap’s Less variables, mixins, and nesting in CSS via javascript in your browser.

 <link rel="stylesheet/less" href="less/bootstrap.less" media="all" />
-<script src="js/less-1.1.3.min.js"></script>
+<script src="js/less-1.2.1.min.js"></script>

Not feeling the .js solution? Try the Less Mac app or use Node.js to compile when you deploy your code.

What’s included

-- cgit v1.2.3 From 6ab56051fdf916f03efb8aa6675e50bdd1cc3155 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 24 Jan 2012 23:35:34 -0800 Subject: fix up docs css for responsive and subnav, fix forms error states --- docs/less.html | 829 ++++++++++++++++++++++++++++++++++----------------------- 1 file changed, 495 insertions(+), 334 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 86a65a6c7..e5e3baa66 100644 --- a/docs/less.html +++ b/docs/less.html @@ -58,359 +58,520 @@
-
- Heads up! This page is still under construction and is missing plenty of documentation. Hang tight! -
+
+ Heads up! This page is still under construction and is missing plenty of documentation. Hang tight! +
- -
-

Using LESS with Bootstrap

-

Customize and extend Bootstrap with LESS, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.

- -
+ +
+

Using LESS with Bootstrap

+

Customize and extend Bootstrap with LESS, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.

+ +
- -
- -
-
-

Why LESS?

-

Bootstrap is made with LESS at it's core, a dynamic stylesheet language created by Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

-
-
-

What's included?

-

As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.

-
-
-

Learn more

- LESS CSS -

Visit the official website at http://lesscss.org to learn more.

-
-
-
-
-

Variables

-

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.

-
-
-

Mixins

-

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.

-
-
-

Operations

-

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.

+ +
+ + +
+
+ +
+
+
+
+

Scaffolding

+ + + +

Base CSS

+ + + + + + + +
+
+

Components

+ + + + + + + + + + +
+
+

JS Components

+ + + + + + + +
+
+

Responsive

+ + + +

Miscellaneous

+ + + + +
-
-
+ +
+
+
+
+

Links

+ + + + +

Grid system

+ + + + + + + + + + +
+
+

Typography

+ + + + + + +

Forms

+ + + + +

Navbar

+ + + + + + +
+
+

Form states & alerts

+ + + + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+
+

And you're set!

+

We've compiled your selected CSS and customized variables and have them ready to download as a tidy ZIP file. Choose from compiled or compiled and minified CSS files.

+ Download CSS Download minified CSS +
+

Looking to customize your javascript? Head over to the Javascript plugins page to build your own Bootstrap JS bundle.

+
+
+
+ + - -
- -

Hyperlinks

- - - - - - - - - - - - - - - - - - - - -
VariableValueUsage
@linkColor#08cDefault link text color
@linkColorHoverdarken(@linkColor, 15%)Default link text hover color
- -
-
-

Grayscale colors

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
VariableValue
@black#000
@grayDarker#222
@grayDark#333
@gray#555
@grayLight#999
@grayLighter#eee
@white#fff
-
-
-

Accent colors

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
VariableValue
@blue#049cdb
@green#46a546
@red#9d261d
@yellow#ffc40d
@orange#f89406
@pink#c3325f
@purple#7a43b6
-
-
-
-
-

Grid system

- - - - - - - - - - - - - - - - - - - - - - - - - -
VariableValue
@gridColumns12
@gridColumnWidth60px
@gridGutterWidth20px
@siteWidth(@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1))
-
-
-

Typography

- - - - - - - - - - - - - - - - - - - - - - -
VariableValue
@baseFontSize13px
@baseFontFamily"Helvetica Neue", Helvetica, Arial, sans-serif
@baseLineHeight18px
-
-
- -

Components

-
-
-

Buttons

- - - - - - - -
@primaryButtonColor@blue
-

Forms

- - - - - - - -
@placeholderText@grayLight
-

Navbar

- - - - - - - - - - - - - - - -
@navbarHeight40px
@navbarBackground@grayDarker
@navbarBackgroundHighlight@grayDark
-
-
-

Form states and alerts

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
@warningText#f3edd2
@warningBackground#c09853
@warningBorder#f3edd2
@errorText#b94a48
@errorBackground#f2dede
@errorBorder#e9c7c7
@successText#468847
@successBackground#dff0d8
@successBorder#cfe8c4
@infoText#3a87ad
@infoBackground#d9edf7
@infoBorder#bfe1f2
-
-
+ +
+ +
+
+

Why LESS?

+

Bootstrap is made with LESS at it's core, a dynamic stylesheet language created by Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

+
+
+

What's included?

+

As an extension of CSS, LESS includes variables, mixins for reusable snippets of code, operations for simple math, nesting, and even color functions.

+
+
+

Learn more

+ LESS CSS +

Visit the official website at http://lesscss.org to learn more.

+
+
+
+
+

Variables

+

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.

+
+
+

Mixins

+

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.

+
+
+

Operations

+

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.

+
+
+
-
+ +
+ - - +

Hyperlinks

+ + + + + + + + + + + + + + + + + + + + +
VariableValueUsage
@linkColor#08cDefault link text color
@linkColorHoverdarken(@linkColor, 15%)Default link text hover color
+ +
+
+

Grayscale colors

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VariableValue
@black#000
@grayDarker#222
@grayDark#333
@gray#555
@grayLight#999
@grayLighter#eee
@white#fff
+
+
+

Accent colors

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
VariableValue
@blue#049cdb
@green#46a546
@red#9d261d
@yellow#ffc40d
@orange#f89406
@pink#c3325f
@purple#7a43b6
+
+
+
+
+

Grid system

+ + + + + + + + + + + + + + + + + + + + + + + + + +
VariableValue
@gridColumns12
@gridColumnWidth60px
@gridGutterWidth20px
@siteWidth(@gridColumns * @gridColumnWidth) + (@gridGutterWidth * (@gridColumns - 1))
+
+
+

Typography

+ + + + + + + + + + + + + + + + + + + + + + +
VariableValue
@baseFontSize13px
@baseFontFamily"Helvetica Neue", Helvetica, Arial, sans-serif
@baseLineHeight18px
+
+
+ +

Components

+
+
+

Buttons

+ + + + + + + +
@primaryButtonColor@blue
+

Forms

+ + + + + + + +
@placeholderText@grayLight
+

Navbar

+ + + + + + + + + + + + + + + +
@navbarHeight40px
@navbarBackground@grayDarker
@navbarBackgroundHighlight@grayDark
+
+
+

Form states and alerts

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
@warningText#f3edd2
@warningBackground#c09853
@warningBorder#f3edd2
@errorText#b94a48
@errorBackground#f2dede
@errorBorder#e9c7c7
@successText#468847
@successBackground#dff0d8
@successBorder#cfe8c4
@infoText#3a87ad
@infoBackground#d9edf7
@infoBorder#bfe1f2
+
+
+
- - + + - - + + + + + + + + -- cgit v1.2.3 From b0fb31be5eff9cc4d7a1b2aab70643ff4fc82618 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 24 Jan 2012 23:45:48 -0800 Subject: fix js link on chop shop --- docs/less.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index e5e3baa66..55138c71a 100644 --- a/docs/less.html +++ b/docs/less.html @@ -230,7 +230,7 @@

We've compiled your selected CSS and customized variables and have them ready to download as a tidy ZIP file. Choose from compiled or compiled and minified CSS files.

Download CSS Download minified CSS
-

Looking to customize your javascript? Head over to the Javascript plugins page to build your own Bootstrap JS bundle.

+

Looking to customize your javascript? Head over to the Javascript plugins page to build your own Bootstrap JS bundle.

-- cgit v1.2.3 From b8fa6cfacf61a02ab769b9031253c7b06111fa7c Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 25 Jan 2012 01:22:29 -0800 Subject: move css builder and downloader to dedicated page, start to update remaining sections on LESS docs page --- docs/less.html | 361 +++++++++------------------------------------------------ 1 file changed, 58 insertions(+), 303 deletions(-) (limited to 'docs/less.html') diff --git a/docs/less.html b/docs/less.html index 55138c71a..6bb04e8d8 100644 --- a/docs/less.html +++ b/docs/less.html @@ -51,6 +51,9 @@
  • Using LESS
  • +
  • + Download +
  • @@ -69,177 +72,16 @@

    Customize and extend Bootstrap with LESS, a CSS preprocessor, to take advantage of the variables, mixins, and more used to build Bootstrap's CSS.

    - -
    - - -
    -
    - -
    -
    -
    -
    -

    Scaffolding

    - - - -

    Base CSS

    - - - - - - - -
    -
    -

    Components

    - - - - - - - - - - -
    -
    -

    JS Components

    - - - - - - - -
    -
    -

    Responsive

    - - - -

    Miscellaneous

    - - - - -
    -
    - -
    -
    -
    -
    -

    Links

    - - - - -

    Grid system

    - - - - - - - - - - -
    -
    -

    Typography

    - - - - - - -

    Forms

    - - - - -

    Navbar

    - - - - - - -
    -
    -

    Form states & alerts

    - - - - - - - - - - - - - - - - - - - - - - - - -
    -
    - -
    -
    -

    And you're set!

    -

    We've compiled your selected CSS and customized variables and have them ready to download as a tidy ZIP file. Choose from compiled or compiled and minified CSS files.

    - Download CSS Download minified CSS -
    -

    Looking to customize your javascript? Head over to the Javascript plugins page to build your own Bootstrap JS bundle.

    -
    -
    -
    -
    - -
    - - -
    @@ -249,7 +91,7 @@

    Why LESS?

    -

    Bootstrap is made with LESS at it's core, a dynamic stylesheet language created by Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

    +

    Bootstrap is made with LESS at it's core, a dynamic stylesheet language created by our good friend, Alexis Sellier. It makes developing systems-based CSS faster, easier, and more fun.

    What's included?

    @@ -283,7 +125,7 @@ ================================================== -->

    Hyperlinks

    @@ -554,85 +396,8 @@ - - - - - - - - - - - - - - - -
    - -
    -
    -

    Bootstrap was built with Preboot, an open-source pack of mixins and variables to be used in conjunction with Less, a CSS preprocessor for faster and easier web development.

    -

    Check out how we used Preboot in Bootstrap and how you can make use of it should you choose to run Less on your next project.

    -
    -
    -

    How to use it

    -

    Use this option to make full use of Bootstrap’s Less variables, mixins, and nesting in CSS via javascript in your browser.

    -
    -<link rel="stylesheet/less" href="less/bootstrap.less" media="all" />
    -<script src="js/less-1.1.3.min.js"></script>
    -

    Not feeling the .js solution? Try the Less Mac app or use Node.js to compile when you deploy your code.

    - -

    What’s included

    -

    Here are some of the highlights of what’s included in Twitter Bootstrap as part of Bootstrap. Head over to the Bootstrap website or Github project page to download and learn more.

    -

    Variables

    -

    Variables in Less are perfect for maintaining and updating your CSS headache free. When you want to change a color value or a frequently used value, update it in one spot and you’re set.

    -
    -// Links
    -@linkColor:         #8b59c2;
    -@linkColorHover:    darken(@linkColor, 10);
    -
    -// Grays
    -@black:             #000;
    -@grayDark:          lighten(@black, 25%);
    -@gray:              lighten(@black, 50%);
    -@grayLight:         lighten(@black, 70%);
    -@grayLighter:       lighten(@black, 90%);
    -@white:             #fff;
    -
    -// Accent Colors
    -@blue:              #08b5fb;
    -@green:             #46a546;
    -@red:               #9d261d;
    -@yellow:            #ffc40d;
    -@orange:            #f89406;
    -@pink:              #c3325f;
    -@purple:            #7a43b6;
    -
    -// Baseline grid
    -@basefont:          13px;
    -@baseline:          18px;
    -
    - -

    Commenting

    -

    Less also provides another style of commenting in addition to CSS’s normal /* ... */ syntax.

    -
    -// This is a comment
    -/* This is also a comment */
    -
    -

    Mixins up the wazoo

    Mixins are basically includes or partials for CSS, allowing you to combine a block of code into one. They’re great for vendor prefixed properties like box-shadow, cross-browser gradients, font stacks, and more. Below is a sample of the mixins that are included with Bootstrap.

    Font stacks

    @@ -686,69 +451,59 @@ } -

    Compiling Less

    -

    After modifying the .less files in /lib/, you'll need to recompile them in order to regenerate the bootstrap-*.*.*.css and bootstrap-*.*.*.min.css files. If you're submitting a pull request to GitHub, you must always recompile.

    -

    Ways to compile

    - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    MethodSteps
    Node with makefile -

    Install the LESS command line compiler with npm by running the following command:

    -
    $ npm install less
    -

    Once installed just run make from the root of your bootstrap directory and you're all set.

    -

    Additionally, if you have watchr installed, you may run make watch to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).

    -
    Javascript -

    Download the latest Less.js and include the path to it (and Bootstrap) in the <head>.

    + + +
    + +
    + Note: If you're submitting a pull request to GitHub with modified CSS, you must recompile the CSS via any of these methods. +
    +

    Tools for compiling

    +
    +
    +

    Node with makefile

    +

    Install the LESS command line compiler with npm by running the following command:

    +
    $ npm install less
    +

    Once installed just run make from the root of your bootstrap directory and you're all set.

    +

    Additionally, if you have watchr installed, you may run make watch to have bootstrap automatically rebuilt every time you edit a file in the bootstrap lib (this isn't required, just a convenience method).

    +
    +
    +

    Command line

    +

    Install the LESS command line tool via Node and run the following command:

    +
    $ lessc ./lib/bootstrap.less > bootstrap.css
    +

    Be sure to include --compress in that command if you're trying to save some bytes!

    +
    +
    +

    Javascript

    +

    Download the latest Less.js and include the path to it (and Bootstrap) in the <head>.

     <link rel="stylesheet/less" href="/path/to/bootstrap.less">
     <script src="/path/to/less.js"></script>
     
    -

    To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.

    -
    Command line -

    Install the LESS command line tool via Node and run the following command:

    -
    $ lessc ./lib/bootstrap.less > bootstrap.css
    -

    Be sure to include --compress in that command if you're trying to save some bytes!

    -
    Unofficial Mac app -

    The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.

    -

    If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.

    -
    CrunchCrunch is a great looking LESS editor and compiler built on Adobe Air.
    CodeKitCreated by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.
    SimplessMac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.
    -
    -
    - +

    To recompile the .less files, just save them and reload your page. Less.js compiles them and stores them in local storage.

    +
    +
    +
    +
    +

    Unofficial Mac app

    +

    The unofficial Mac app watches directories of .less files and compiles the code to local files after every save of a watched .less file.

    +

    If you like, you can toggle preferences in the app for automatic minifying and which directory the compiled files end up in.

    +
    +
    +

    More Mac apps

    +

    Crunch

    +

    Crunch is a great looking LESS editor and compiler built on Adobe Air.

    +

    CodeKit

    +

    Created by the same guy as the unofficial Mac app, CodeKit is a Mac app that compiles LESS, SASS, Stylus, and CoffeeScript.

    +

    Simpless

    +

    Mac, Linux, and PC app for drag and drop compiling of LESS files. Plus, the source code is on GitHub.

    +
    +
    +