Bootstrap 2.x	Bootstrap 3.0
`.accordion`	`.panel-group`
`.accordion-group`	`.panel .panel-default`
`.accordion-heading`	`.panel-heading`
`.accordion-body`	`.panel-collapse`
`.accordion-inner`	`.panel-body`
`.alert-error`	`.alert-danger`

- - - - - - - - -- cgit v1.2.3 From 29935e4e26df6768e8bd710dbd33a3c5fb757153 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Mon, 23 Sep 2013 12:06:33 -0700 Subject: fix #10767; current .img-thumbnail is equivalent to old .img-polaroid --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 80069c45c..96aea1066 100644 --- a/getting-started.html +++ b/getting-started.html @@ -414,7 +414,7 @@ bootstrap/ - + -- cgit v1.2.3 From 8aa5181126d9480eef502403aa98e469a3597826 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Mon, 23 Sep 2013 13:00:43 -0700 Subject: move /assets/ to /docs-assets/ ; fixes #10715 --- getting-started.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 80069c45c..8c1652e00 100644 --- a/getting-started.html +++ b/getting-started.html @@ -109,8 +109,8 @@ bootstrap/ -- cgit v1.2.3 From f503efc49086becc312665000fcbce4b9df3750d Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Mon, 23 Sep 2013 13:01:11 -0700 Subject: avoid using the term "assets" due to potential confusion --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 8c1652e00..4cc0aa4fe 100644 --- a/getting-started.html +++ b/getting-started.html @@ -61,7 +61,7 @@ base_url: "../" -

Within the download you'll find the following directories and files, logically grouping common assets and providing both compiled and minified variations.

Within the download you'll find the following directories and files, logically grouping common resources and providing both compiled and minified variations.

Once downloaded, unzip the compressed folder to see the structure of (the compiled) Bootstrap. You'll see something like this:

{% highlight bash %} -- cgit v1.2.3 From dcfd9f27ffe7931a7fa882fe2af38d0022a1a87e Mon Sep 17 00:00:00 2001 From: Aaron Spike Date: Tue, 24 Sep 2013 11:52:06 -0500 Subject: Alter wording of example Skip Nav link to improve pronunciation Screen reading applications, including Apple's VoiceOver, improperly pronounce the word "content" in "Skip to content" as an adjective rather than a noun because of insufficient context. "Skip to main content" is pronounced correctly. See #6 and Guideline #10 at the following site for more information: http://redish.net/content/papers/interactions.htmlAlter wording of example Skip Nav link to improve pronunciation --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 8c0d9d2a3..5c0b11627 100644 --- a/getting-started.html +++ b/getting-started.html @@ -867,7 +867,7 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) {

If your navigation contains many links and comes before the main content in the DOM, add a Skip to content link immediately after your opening <body> tag. (read why)

{% highlight html %} - +

The main page content.

-- cgit v1.2.3 From 735105ae7274f5c6175d0b2550fc35597e09bee4 Mon Sep 17 00:00:00 2001 From: Julian Thilo Date: Tue, 24 Sep 2013 22:49:47 +0200 Subject: Add note about IE mode tag being included in docs --- getting-started.html | 1 + 1 file changed, 1 insertion(+) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 8c0d9d2a3..4751de08e 100644 --- a/getting-started.html +++ b/getting-started.html @@ -749,6 +749,7 @@ bootstrap/ {% highlight html %} {% endhighlight %} +

This tag is included in all docs pages and examples to ensure the best rendering possible in each supported version of Internet Explorer.

See this StackOverflow question for more information.

Internet Explorer 10 in Windows 8 and Windows Phone 8

-- cgit v1.2.3 From af4d1027671b278bdc3b0069bb7ef871bf936109 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Tue, 24 Sep 2013 18:02:10 -0700 Subject: Use "Skip to main content" phrasing consistently; further #10786 fixes --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 3c5456666..c908cb183 100644 --- a/getting-started.html +++ b/getting-started.html @@ -865,7 +865,7 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) {

Bootstrap follows common web standards, and with minimal extra effort, can be used to create sites that are accessibile to those using AT.

Skip navigation

If your navigation contains many links and comes before the main content in the DOM, add a Skip to content link immediately after your opening <body> tag. (read why)

If your navigation contains many links and comes before the main content in the DOM, add a Skip to main content link immediately after your opening <body> tag. (read why)

{% highlight html %} -- cgit v1.2.3 From 1cf8fcda651f54e59f0c454579b457b666cb1880 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Wed, 25 Sep 2013 11:45:26 -0700 Subject: add iOS and versions to Safari percent rounding warning; fixes #10723 --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index c908cb183..8f749889c 100644 --- a/getting-started.html +++ b/getting-started.html @@ -781,7 +781,7 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) {

As a heads up, we include this in the Bootstrap docs as an example.

Safari percent rounding

In the latest Safari for Mac, its rendering engine has a little trouble with the long decimal places of our .col-*-1 grid classes, meaning if you have 12 individual columns you'll notice they come up short compared to other rows of columns. We can't do much here (see #9282) but you do have some options:

As of Safari v6.1 for OS X and Safari for iOS v7.0.1, Safari's rendering engine has some trouble with the number of decimal places used in our .col-*-1 grid classes. So if you have 12 individual grid columns, you'll notice that they come up short compared to other rows of columns. We can't do much here (see #9282) but you do have some options:

Add .pull-right to your last grid column to get the hard-right alignment
Tweak your percentages manually to get the perfect rounding for Safari (more difficult than the first option)

Date: Sat, 28 Sep 2013 16:21:23 -0500 Subject: Spelling mistakes in documentation. --- getting-started.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index c908cb183..709bf09dc 100644 --- a/getting-started.html +++ b/getting-started.html @@ -792,7 +792,7 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) {

Overflow and scrolling

Support for overflow: hidden on the <body> element is quite limited in iOS and Android. To that end, when you scroll past the top or bottom of a modal in either of those devices' browsers, the <body> content will begin to scroll.

Virtual keyboards

Also, note that if you're using inputs in your modal – iOS has a rendering bug that doesn't update the position of fixed elements when the virtual keyboard is triggered. A few work arounds for this include transforming your elements to position: absolute or invoking a timer on focus to try to correct the positioning manually. This is not handled by Bootstrap, so it is up to you to decide which solution is best for your application.

Also, note that if you're using inputs in your modal – iOS has a rendering bug that doesn't update the position of fixed elements when the virtual keyboard is triggered. A few workarounds for this include transforming your elements to position: absolute or invoking a timer on focus to try to correct the positioning manually. This is not handled by Bootstrap, so it is up to you to decide which solution is best for your application.

Browser zooming

Page zooming inevitably presents rendering artifacts in some components, both in Bootstrap and the rest of the web. Depending on the issue, we may be able to fix it (search first and then open an issue if need be). However, we tend to ignore these as they often have no direct solution other than hacky workarounds.

@@ -862,7 +862,7 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) { -

Bootstrap follows common web standards, and with minimal extra effort, can be used to create sites that are accessibile to those using AT.

Bootstrap follows common web standards, and with minimal extra effort, can be used to create sites that are accessible to those using AT.

Skip navigation

If your navigation contains many links and comes before the main content in the DOM, add a Skip to main content link immediately after your opening <body> tag. (read why)

-- cgit v1.2.3 From a97918297e0fe8253b4ad9f8a63a1186eae979c4 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Mon, 30 Sep 2013 17:54:24 -0700 Subject: add maintenance note regarding #10864's addition --- getting-started.html | 2 ++ 1 file changed, 2 insertions(+) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 709bf09dc..0cb91f61f 100644 --- a/getting-started.html +++ b/getting-started.html @@ -64,6 +64,8 @@ base_url: "../"

Within the download you'll find the following directories and files, logically grouping common resources and providing both compiled and minified variations.

Once downloaded, unzip the compressed folder to see the structure of (the compiled) Bootstrap. You'll see something like this:

+ {% highlight bash %} bootstrap/ ├── css/ -- cgit v1.2.3 From d72768a16abe811d987f2a38f980329260686114 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Wed, 9 Oct 2013 15:09:50 -0700 Subject: use CDN for html5shiv instead of vendoring it; fixes part of #10989 --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index e6d43349f..f5a9263b0 100644 --- a/getting-started.html +++ b/getting-started.html @@ -111,7 +111,7 @@ bootstrap/ -- cgit v1.2.3 From 4b175d908cdbe923cfb2509bd5549509c300a71e Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Thu, 10 Oct 2013 01:51:09 -0700 Subject: use https:// for CDN links - works when viewing page via file:// - sets a good example security-wise --- getting-started.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index f5a9263b0..1edb5a120 100644 --- a/getting-started.html +++ b/getting-started.html @@ -111,7 +111,7 @@ bootstrap/ @@ -119,7 +119,7 @@ bootstrap/

Hello, world!

- + -- cgit v1.2.3 From a96aff1e564227cc03f10aa757ff5c2b80c482b1 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Thu, 10 Oct 2013 02:27:26 -0700 Subject: fix typo in Getting Started docs prose --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index f5a9263b0..1ed2be5dc 100644 --- a/getting-started.html +++ b/getting-started.html @@ -995,7 +995,7 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) {

In summary, here's the basic workflow:

For each element you want to customize, find its code in the compiled Bootstrap CSS.
Copy the component's selector and styles and paste them in your custom stylesheet. For instance, to customize the navbar background, just copy the .navbar style specificaton.
Copy the component's selector and styles and paste them in your custom stylesheet. For instance, to customize the navbar background, just copy the .navbar style specification.
In your custom stylesheet, edit the CSS you just copied from the Bootstrap source. No need for prepending additional classes, or appending !important here. Keep it simple.
Rinse and repeat until you're happy with your customizations.

-- cgit v1.2.3 From f0f1b8319dcdc894f49c51e3678082dc15987516 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Sun, 13 Oct 2013 22:55:50 -0700 Subject: fix #11003 --- getting-started.html | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index b37ad1cfe..a18115fd0 100644 --- a/getting-started.html +++ b/getting-started.html @@ -701,7 +701,11 @@ bootstrap/

Unofficially, Bootstrap should look and behave well enough in Chromium and Chrome for Linux, Firefox for Linux, and Internet Explorer 7, though they are not officially supported.

Internet Explorer 8 and 9

Internet Explorer 8 and 9 are also supported, however, please be aware that some CSS3 properties and HTML5 elements are not fully supported by these browsers. In addition, Internet Explorer 8 requires the use of respond.js to enable media query support.

Respond.js and cross-domain CSS

Using Respond.js with CSS hosted on a different (sub)domain (for example, on a CDN) requires some additional setup. See the Respond.js docs for details.

Bootstrap 2.x	Bootstrap 3.0
`.accordion`	`.panel-group`	`.input-group-addon`
`.thumbnail`	`.img-polaroid`	`.img-thumbnail`

-- cgit v1.2.3 From 8450aa7dbfabfe59702943ef20d5e4417f29e1b2 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Sun, 13 Oct 2013 23:23:04 -0700 Subject: avoid referencing /docs-assets/ in Getting Started docs example; use CDN URL for respond.js --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index b37ad1cfe..bb81989a4 100644 --- a/getting-started.html +++ b/getting-started.html @@ -112,7 +112,7 @@ bootstrap/ -- cgit v1.2.3 From ceb7694ee325db6b85de374192ecda2407a731ea Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Sun, 13 Oct 2013 23:50:20 -0700 Subject: add note to docs about Respond.js & file:// ; fixes part of #11019 --- getting-started.html | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 67b367c52..bbb1c1b96 100644 --- a/getting-started.html +++ b/getting-started.html @@ -176,7 +176,8 @@ bootstrap/ - + + -

- -

You're looking at the official documentation for Bootstrap (v{{ site.version }}), a front-end framework for building on the Web. Before diving in, get the background story on Bootstrap, useful tidbits about the docs, helpful community links, and more.

- -

Brief history

Bootstrap was created at Twitter in mid-2010 by @mdo and @fat. Prior to being open-sourced framework, Bootstrap was known as Twitter Blueprint. A few months into development, Twitter held its first Hack Week and the project exploded. It served as the style guide for internal tools development at the company for over a year before its public release.

Originally released on Friday, August 19, 2011, we've had over twenty releases, including two major rewrites with v2 and v3. With Bootstrap 2, we added responsive functionality to the entire framework as an optional stylesheet. Building on that with Bootstrap 3, we rewrote the library once more to make it responsive by default with a mobile first approach.

- -

Core team

Bootstrap is maintained by the founding team and a small group of invaluable core contributors, with the massive support and involvement of our community.

- - -

- Mark Otto @mdo - - - -

- Jacob Thornton @fat - - - -

- Chris Rebert @cvrebert - - - -

- Julian Thilo @juthilo - -

Get involved with Bootstrap development by opening an issue or submitting a pull request. Read our contributing guidelines for more information.

- -

Callouts

We use callouts throughout the docs to direct attention to important contextual information. These callouts can be informative and optional (blue), warnings (yellow), or dangerously important (red).

Extra information

These are helpful notes that provide background information or additional context.

Heads up

This is a warning used to highlight pertinent, though not necessarily required, information.

Potential danger ahead

Pay attention to these for potentially dangerous or tricky requirements, bugs, and more.

See something worth calling out? Let us know with an issue on GitHub.

- -

Community

Stay up to date on the development of Bootstrap and reach out to the community with these helpful resources.

Read and subscribe to The Official Bootstrap Blog.
Have a question that's not a feature request or bug report? Ask on the mailing list.
Chat with fellow Bootstrappers using IRC in the irc.freenode.net server, in the ##twitter-bootstrap channel.
Find inspiring examples of people building with Bootstrap at the Bootstrap Expo.

You can also follow @twbootstrap on Twitter for the latest gossip and awesome music videos.

- -

-- cgit v1.2.3 From 4e1808930a7ad9cbfcf76a5b05ac90bced761eb8 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Mon, 14 Oct 2013 16:23:20 -0700 Subject: add IDs to frequently-referenced parts of the docs --- getting-started.html | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index c088a2b2c..1c358edb4 100644 --- a/getting-started.html +++ b/getting-started.html @@ -85,7 +85,7 @@ bootstrap/ {% endhighlight %}

This is the most basic form of Bootstrap: precompiled files for quick drop-in usage in nearly any web project. We provide compiled CSS and JS (bootstrap.*), as well as compiled and minified CSS and JS (bootstrap.min.*). Fonts from Glyphicons are included, as is the optional Bootstrap theme.

jQuery required

Please note that all JavaScript plugins require jQuery to be included, as shown in the starter template. Consult our bower.json to see which versions of jQuery are supported.

@@ -756,7 +756,7 @@ bootstrap/

Internet Explorer 8 and box-sizing

IE8 does not fully support box-sizing: border-box; when combined with min-width, max-width, min-height, or max-height. For that reason, as of v3.0.1, we no longer use max-width on .containers.

IE Compatibility modes

Bootstrap is not supported in the old Internet Explorer compatibility modes. To be sure you're using the latest rendering mode for IE, consider including the appropriate <meta> tag in your pages:

{% highlight html %} @@ -764,7 +764,7 @@ bootstrap/

This tag is included in all docs pages and examples to ensure the best rendering possible in each supported version of Internet Explorer.

See this StackOverflow question for more information.

Internet Explorer 10 in Windows 8 and Windows Phone 8

Internet Explorer 10 doesn't differentiate device width from viewport width, and thus doesn't properly apply the media queries in Bootstrap's CSS. Normally you'd just add a quick snippet of CSS to fix this:

{% highlight css %} @-ms-viewport { width: device-width; } @@ -792,7 +792,7 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) {

For more information and usage guidelines, read Windows Phone 8 and Device-Width.

As a heads up, we include this in the Bootstrap docs as an example.

Safari percent rounding

Add .pull-right to your last grid column to get the hard-right alignment

We'll keep an eye on this though and update our code if we have an easy solution.

Modals and mobile devices

Overflow and scrolling

Virtual keyboards

Also, note that if you're using inputs in your modal – iOS has a rendering bug that doesn't update the position of fixed elements when the virtual keyboard is triggered. A few workarounds for this include transforming your elements to position: absolute or invoking a timer on focus to try to correct the positioning manually. This is not handled by Bootstrap, so it is up to you to decide which solution is best for your application.

Browser zooming

-- cgit v1.2.3 From 9d54a42951939fc8a4765aa3d8427a4227d459f9 Mon Sep 17 00:00:00 2001 From: Case Talbot Date: Tue, 15 Oct 2013 17:02:21 -0700 Subject: Include a note about text-based form control styling fixes #8824. --- getting-started.html | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 1c358edb4..3eef6f795 100644 --- a/getting-started.html +++ b/getting-started.html @@ -668,7 +668,8 @@ bootstrap/

Additional notes

Other changes in v3.0 are not immediately apparent. Base classes, key styles, and behaviors have been adjusted for flexibility and our mobile first approach. Here's a partial list:

Text-based form controls are now 100% wide. Wrap inputs inside <div class="col-*"></div> to control input widths.
By default, text-based form controls now receive only minimal styling. For focus colors and rounded corners, apply the form-control class on the element to style.
Text-based form controls with the form-control class applied are now 100% wide by default. Wrap inputs inside <div class="col-*"></div> to control input widths.
.badge no longer has contextual (-success,-primary,etc..) classes.
.btn must also use .btn-default to get the "default" button.
.container and .row are now fluid (percentage-based).

Date: Tue, 15 Oct 2013 17:25:34 -0700 Subject: add dots to class name references for consistency --- getting-started.html | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 3eef6f795..480ab74ff 100644 --- a/getting-started.html +++ b/getting-started.html @@ -668,8 +668,8 @@ bootstrap/

Additional notes

Other changes in v3.0 are not immediately apparent. Base classes, key styles, and behaviors have been adjusted for flexibility and our mobile first approach. Here's a partial list:

By default, text-based form controls now receive only minimal styling. For focus colors and rounded corners, apply the form-control class on the element to style.
Text-based form controls with the form-control class applied are now 100% wide by default. Wrap inputs inside <div class="col-*"></div> to control input widths.
By default, text-based form controls now receive only minimal styling. For focus colors and rounded corners, apply the .form-control class on the element to style.
Text-based form controls with the .form-control class applied are now 100% wide by default. Wrap inputs inside <div class="col-*"></div> to control input widths.
.badge no longer has contextual (-success,-primary,etc..) classes.
.btn must also use .btn-default to get the "default" button.
.container and .row are now fluid (percentage-based).

Date: Wed, 16 Oct 2013 15:36:14 -0700 Subject: upgrade to html5shiv v 3.7.0 --- getting-started.html | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'getting-started.html') diff --git a/getting-started.html b/getting-started.html index 480ab74ff..ec3462f0e 100644 --- a/getting-started.html +++ b/getting-started.html @@ -113,7 +113,7 @@ bootstrap/ -- cgit v1.2.3

Welcome!

Brief history

Core team

Callouts

Extra information

Heads up

Potential danger ahead

Community

Welcome!

Brief history

Core team

Windows Phone 8 and Internet Explorer 10

Internet Explorer 10 in Windows 8 and Windows Phone 8

Safari percent rounding

jQuery required

Internet Explorer 8 and 9

Internet Explorer 8 and 9

Bootstrap CDN

Minor class changes

What's new

Minor class changes

What's included

Internet Explorer 10 in Windows 8 and Windows Phone 8

Skip navigation

Safari percent rounding

Overflow and scrolling

Virtual keyboards

Browser zooming

Accessibility

Skip navigation

Hello, world!

Internet Explorer 8 and 9

Respond.js and cross-domain CSS

Welcome!

Brief history

Core team

Callouts

Extra information

Heads up

Potential danger ahead

Community

jQuery required

Internet Explorer 8 and box-sizing

IE Compatibility modes

IE Compatibility modes

Internet Explorer 10 in Windows 8 and Windows Phone 8

Internet Explorer 10 in Windows 8 and Windows Phone 8

Safari percent rounding

Safari percent rounding

Modals and mobile devices

Modals and mobile devices

Overflow and scrolling

Virtual keyboards

Browser zooming

Browser zooming

Additional notes

Additional notes