diff --git a/CHANGELOG.md b/CHANGELOG.md deleted file mode 100644 index c7609beab8..0000000000 --- a/CHANGELOG.md +++ /dev/null @@ -1,360 +0,0 @@ -## 2.3.1 (February 28, 2013) - -Patch release for @fat's n00bery - -- fix missing event type in dropdown -- fix delegated data-attrs for popover/tooltip -- make carousel actually pause when you click cycle -- fix jshint ref in makefile -- fix trying to remove backdrop when no backdrop - -## 2.3.0 (February 7, 2013) - -Minor release to add carousel indicators, improve tooltips, improve dev setup, and fix hella bugs. - -- **Repository changes:** - - **Local instead of global dependencies** for our makefile and install process. Now getting started is way easier—just run `npm install`. - - Upgraded to jQuery 1.9. No changes were needed, but we did upgrade the included jQuery file to the latest release. - - Moved changelog to be within the repo instead of as a wiki page. -- **New and improved features:** - - **Added carousel indicators!** Add the HTML and it automagically works. - - **Added `container` option to tooltips.** The default option is still `insertAfter`, but now you may specify where to insert tooltips (and by extension, popovers) with the optional container parameter. - - Improved popovers now utilize `max-width` instead of `width`, have been widened from 240px to 280px, and will automatically hide the title if one has not been set via CSS `:empty` selector. - - Improved tooltip alignment on edges with [#6713](https://github.com/twitter/bootstrap/pull/6713). - - **Improved accessibility for links in all components.** After merging [#6441](https://github.com/twitter/bootstrap/pull/6441), link hover states now apply to the `:focus` state as well. This goes for basic `` tags, as well as buttons, navs, dropdowns, and more. - - Added print utility classes to show and hide content between `screen` and `print` via CSS. - - Updated input groups to make them behave more like default form controls. Added `display: inline-block;`, increased `margin-bottom`, and added `vertical-align: middle;` to match `` styles. - - Added `.horizontal-three-colors()` gradient mixin (with example in the CSS tests file). - - Added `.text-left`, `.text-center`, and `.text-right` utility classes for easy typographic alignment. - - Added `@ms-viewport` so IE10 can use responsive CSS when in split-screen mode. -- **Docs changes:** - - Added [new justified navigation example](https://f.cloud.github.com/assets/98681/25869/5e2f812c-4afa-11e2-9293-501cd689232d.png). - - Added sticky footer with fixed navbar example. - -See more on the [2.3.0 pull request](https://github.com/twitter/bootstrap/pull/6346). - - -## 2.2.2 (December 8, 2012) - -Bugfix release addressing docs, CSS, and some JavaScript issues. Key changes include: - -- **Docs:** - - Assets (illustrations and examples) are now retina-ready. - - Replaced [Placehold.it](http://placehold.it) with [Holder.js](http://imsky.github.com/holder/), a client-side and retina-ready placeholder image tool. -- **Dropdowns:** Temporary fix added for dropdowns on mobile to prevent them from closing early. -- **Popovers:** - - No longer inherits `font-size: 0;` when placed in button groups. - - Arrows refactored to work in IE8, and use less code. - - Plugin no longer inserts popover content into a `

`, but rather directly into `.popover-content`. -- **Labels and badges:** Now [automatically collapse](https://github.com/twitter/bootstrap/commit/ead5dbeba5cd7acfa560bfb353f5e7c4f4a19256) if they have no content. -- **Tables:** Nesting support with `.table-bordered` and `.table-striped` greatly improved. -- **Typeahead:** - - Now [inserts dropdown menu after the input](https://github.com/twitter/bootstrap/commit/1747caf19d59cad7fdc90ae56a00e0e2849f95f4) instead of at the close of the document. - - Hitting escape will place focus back on the ``. -- Print styles, from HTML5 Boilerplate, have been added. - -See more on the [2.2.2 milestone](https://github.com/twitter/bootstrap/issues?milestone=17&state=closed). - - -## 2.2.1 (October 30, 2012) - -Hotfix release to address the carousel bug reports. - - -## 2.2.0 (October 29, 2012) - -### tl;dr - -2.1.2 is now 2.2.0: four new example templates, added media component, new typographic scale, fixed that box-shadow mixin bug, fixed z-index issues, and [more](https://github.com/twitter/bootstrap/issues?milestone=15&page=1&state=closed). - -### Highlights - -- **Added four new example templates** to the docs, including a narrow marketing page, sign in form, sticky footer, and a fancy carousel (created for an upcoming .net magazine article). -- **Added the media component**, to create larger common components like comments, Tweets, etc. -- **New variable-driven typographic scale** based on `@baseFontSize` and `@baseLineHeight`. -- Revamped mini, small, and large padding via new variables for inputs and buttons so everything is the same size. -- Reverted 2.1.1's `.box-shadow();` mixin change that caused compiler errors. -- Improved dropdown submenus to support dropups and left-aligned submenus. -- Fixed z-index issues with tooltips and popovers in modals. -- Hero unit now sets basic type styles for the entire component, rather than on `.hero-unit p { ... }`. -- Updated JavaScript plugins and docs to jQuery 1.8.1. -- Added Contributing.md file. -- Added support for installing Bootstrap via [Bower](http://twitter.github.com/bower). -- Miscellaneous variable improvements across the board. -- Miscellaneous documentation typos fixed. - -For the full list of issues included in this release, visit the [2.2.0 milestone on GitHub](https://github.com/twitter/bootstrap/issues?milestone=15&page=1&state=closed) - - - -## 2.1.1 (September 4, 2012) - -* New feature: alert text. We documented these new classes, like `.text-success`, at the bottom of the [Typography section](http://twitter.github.com/bootstrap/base-css.html#typography) along with the long undocumented `.muted`. -* Fixed a lot of typos in the docs. Spelling is hard. -* Made the `.box-shadow()` mixin more durable. It no longer requires escaping for multiple shadows, meaning you can easily use variables and functions in them once again. -* Widened `.dl-horizontal dt` and `.horizontal-form .control-group` to better handle the increased font-size. -* Dropdown submenus improved: now you only see the next level, not all levels, on hover of the submenu toggle. -* Clarified jQuery and Bootstrap template requirements in Getting Started section. -* `select` now utilizes `@inputBorder`. -* `.lead` now scales up from `@baseFontSize` instead of being a fixed font-size and line-height. -* Fixed the vertical three color gradient in latest Firefox. -* Reordered some variables that caused errors in certain Less compilers. - -View all closed issues on the [2.1.1 milestone](https://github.com/twitter/bootstrap/issues?milestone=14&state=closed). - - -## 2.1.0 (August 20, 2012) - -### Key changes - -* Submenu support on dropdowns -* Affix JavaScript plugin -* Block level buttons -* State classes on table rows -* Improved disabled states on navs and dropdowns -* The navbar component is now white by default, with an optional class to darken it -* Improved prepended and appended inputs -* New base font-size and line-height -* Added variable for navbar collapse trigger point -* Fluid grid offsets -* Fluid grid system variables are no longer fixed percentages -* Removed LESS docs page - -For full set of changes, see the completed milestone: https://github.com/twitter/bootstrap/issues?milestone=7&page=1&state=closed - -## 2.0.4 (June 1, 2012) - - -### Docs - -- Added `type="button"` to all dismiss buttons in alerts and modals to avoid a bug in which they prevent their parent's `form` from properly submitting. -- Added simple documentation to Base CSS for `.lead`. -- Added new CSS test to illustrate how the navbar, static and fixed, behaves. -- Clarified grid sizing copy to include mention of responsive variations. -- Reformatted the LESS docs page to prevent terrible table displays at smaller grid sizes. -- Miscellaneous typos and tweaks. - -### CSS - -- Refactored forms.less to make our selectors more specific for fewer overrides and less code. Instead of a generic `input` selector and various resets, we target each type of input like `input[type="text"]`, `input[type="password"]`, etc. -- Form field state (e.g., success or error) now applies to checkbox and radio labels. -- Removed redundant CSS on `

` for `font-family`, `font-size`, and `line-height`. -- Removed redundant `color` declaration from the `

Designed and built with all the love in the world by @mdo and @fat.

Code licensed under Apache License v2.0, documentation under CC BY 3.0.

-

Glyphicons Free licensed under CC BY 3.0.

Going beyond light customizations and into visual overhauls is just as straightforward as the above custom button. For a site like Karma, which uses Bootstrap as a CSS reset with heavy modifications, more extensive work is involved, but well worth it in the end.

-
+

Alternate customization methods

While not recommended for folks new to Bootstrap, you may use one of two alternate methods for customization. The first is modifying the source .less files (making upgrades super difficult), and the second is mapping source LESS code to your own classes via mixins. For the time being, neither options are documented here.

diff --git a/docs/index.html b/docs/index.html index fc8e85322a..49bdcb38e8 100644 --- a/docs/index.html +++ b/docs/index.html @@ -15,15 +15,15 @@ title: Bootstrap {% include social-buttons.html %}

Individual or compiled

-

Plugins can be included individually, or all at once. Do not attempt to include both. Both bootstrap.js and bootstrap.min.js contain all plugins in a single file.

-
+

Plugins can be included individually (using bootstrap-*.js original files, or all at once (using bootstrap.js or the minified bootstrap.min.js.

+ +
+

Do not attempt to include both.

+

Both bootstrap.js and bootstrap.min.js contain all plugins in a single file.

+
+ +

Plugin dependencies

Some plugins and CSS components depend on other plugins. If you include plugins individually, make sure to check for these dependencies in the docs.

@@ -64,6 +70,11 @@ $('#myModal').on('show.bs.modal', function (e) { if (!data) return e.preventDefault() // stops modal from being shown }) {% endhighlight %} + +
+

Third-party libraries

+

Bootstrap does not officially support third-party JavaScript libraries like Prototype or jQuery UI. Despite .noConflict and namespaced events, there may be compatibility problems that you need to fix on your own. Ask on the mailing list if you need help.

+
@@ -75,7 +86,7 @@ $('#myModal').on('show.bs.modal', function (e) {

Transitions transition.js

About transitions

-

For simple transition effects, include transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.

+

For simple transition effects, include transition.js once alongside the other JS files. If you're using the compiled (or minified) bootstrap.js, there is no need to include this—it's already there.

Use cases

A few examples of the transition plugin:

- - + + @@ -467,7 +483,7 @@ $('.dropdown-toggle').dropdown() ================================================== -->
-

ScrollSpy bootstrap-scrollspy.js

+

ScrollSpy scrollspy.js

@@ -494,7 +510,7 @@ $('.dropdown-toggle').dropdown() -
+

@fat

Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.

@mdo

@@ -527,7 +543,7 @@ $('.dropdown-toggle').dropdown() $('#navbar-example').scrollspy() {% endhighlight %} -
+

Resolvable ID targets required

Navbar links must have resolvable id targets. For example, a <a href="#home">home</a> must correspond to something in the DOM like <div id="home"></div>.

@@ -591,7 +607,7 @@ $('#myScrollspy').on('activate.bs.scrollspy', function () { ================================================== -->
-

Togglable tabs bootstrap-tab.js

+

Togglable tabs tab.js

@@ -718,7 +734,7 @@ $('a[data-toggle="tab"]').on('shown.bs.tab', function (e) { ================================================== -->
-

Tooltips bootstrap-tooltip.js

+

Tooltips tooltip.js

Examples

@@ -739,9 +755,10 @@ $('a[data-toggle="tab"]').on('shown.bs.tab', function (e) {
- -

Tooltips in input groups

-

When using tooltips and popovers with the Bootstrap input groups, you'll have to set the container (documented below) option to avoid unwanted side effects.

+
+

Tooltips in button groups and input groups require special setting

+

When using tooltips on elements within a .btn-group or an .input-group, you'll have to specify the option container: 'body' (documented below) to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the tooltip is triggered).

+
@@ -768,13 +785,13 @@ $('#example').tooltip(options) animation boolean true - apply a css fade transition to the tooltip + apply a CSS fade transition to the tooltip html boolean false - Insert html into the tooltip. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks. + Insert HTML into the tooltip. If false, jQuery's text method will be used to insert content into the DOM. Use text if you're worried about XSS attacks. placement @@ -798,7 +815,7 @@ $('#example').tooltip(options) trigger string 'hover focus' - how tooltip is triggered - click | hover | focus | manual. Note you case pass trigger multiple, space seperated, trigger types. + how tooltip is triggered - click | hover | focus | manual. Note you case pass trigger multiple, space separated, trigger types. delay @@ -815,12 +832,12 @@ $('#example').tooltip(options) string | false false -

Appends the tooltip to a specific element container: 'body'

+

Appends the tooltip to a specific element. Example: container: 'body'

-
+

Data attributes for individual tooltips

Options for individual tooltips can alternatively be specified through the use of data attributes, as explained above.

@@ -858,16 +875,20 @@ $('#example').tooltip(options) ================================================== -->
-

Popovers bootstrap-popover.js

+

Popovers popover.js

Examples

Add small overlays of content, like those on the iPad, to any element for housing secondary information. Hover over the button to trigger the popover.

-
+

Plugin dependency

Popovers require the tooltip plugin to be included in your version of Bootstrap.

+
+

Popovers in button groups and input groups require special setting

+

When using popovers on elements within a .btn-group or an .input-group, you'll have to specify the option container: 'body' (documented below) to avoid unwanted side effects (such as the element growing wider and/or losing its rounded corners when the popover is triggered).

+

Static popover

Four options are available: top, right, bottom, and left aligned.

@@ -915,10 +936,10 @@ $('#example').tooltip(options)

Four directions

@@ -946,13 +967,13 @@ $('#example').tooltip(options) animation boolean true - apply a css fade transition to the tooltip + apply a CSS fade transition to the tooltip html boolean false - Insert html into the popover. If false, jquery's text method will be used to insert content into the dom. Use text if you're worried about XSS attacks. + Insert HTML into the popover. If false, jQuery's text method will be used to insert content into the DOM. Use text if you're worried about XSS attacks. placement @@ -999,12 +1020,12 @@ $('#example').tooltip(options) string | false false -

Appends the popover to a specific element container: 'body'

+

Appends the popover to a specific element. Example: container: 'body'

-
+

Data attributes for individual popovers

Options for individual popovers can alternatively be specified through the use of data attributes, as explained above.

@@ -1039,7 +1060,7 @@ $('#example').tooltip(options) ================================================== -->
-

Alert messages bootstrap-alert.js

+

Alert messages alert.js

@@ -1101,7 +1122,7 @@ $('#example').tooltip(options) closed - This event is fired when the alert has been closed (will wait for css transitions to complete). + This event is fired when the alert has been closed (will wait for CSS transitions to complete). @@ -1118,7 +1139,7 @@ $('#my-alert').bind('closed.bs.alert', function () { ================================================== -->
-

Buttons bootstrap-button.js

+

Buttons button.js

Example uses

@@ -1224,7 +1245,7 @@ $('.nav-tabs').button()

$().button('toggle')

Toggles push state. Gives the button the appearance that it has been activated.

-
+

Auto toggling

You can enable auto toggling of a button by using the data-toggle attribute.

@@ -1239,7 +1260,7 @@ $('.nav-tabs').button() {% endhighlight %} -
+

Cross-browser compatibility

Firefox persists the disabled state across page loads. A workaround for this is to use autocomplete="off".

@@ -1263,13 +1284,13 @@ $('.nav-tabs').button() ================================================== -->
-

Collapse bootstrap-collapse.js

+

Collapse collapse.js

About

Get base styles and flexible support for collapsible components like accordions and navigation.

-
+

Plugin dependency

Collapse requires the transitions plugin to be included in your version of Bootstrap.

@@ -1374,7 +1395,7 @@ $('.nav-tabs').button()

Usage

Via data attributes

-

Just add data-toggle="collapse" and a data-target to element to automatically assign control of a collapsible element. The data-target attribute accepts a css selector to apply the collapse to. Be sure to add the class collapse to the collapsible element. If you'd like it to default open, add the additional class in.

+

Just add data-toggle="collapse" and a data-target to element to automatically assign control of a collapsible element. The data-target attribute accepts a CSS selector to apply the collapse to. Be sure to add the class collapse to the collapsible element. If you'd like it to default open, add the additional class in.

To add accordion-like group management to a collapsible control, add the data attribute data-parent="#selector". Refer to the demo to see this in action.

Via JavaScript

@@ -1446,7 +1467,7 @@ $('#myCollapsible').collapse({ shown - This event is fired when a collapse element has been made visible to the user (will wait for css transitions to complete). + This event is fired when a collapse element has been made visible to the user (will wait for CSS transitions to complete). hide @@ -1456,7 +1477,7 @@ $('#myCollapsible').collapse({ hidden - This event is fired when a collapse element has been hidden from the user (will wait for css transitions to complete). + This event is fired when a collapse element has been hidden from the user (will wait for CSS transitions to complete). @@ -1473,7 +1494,7 @@ $('#myCollapsible').on('hidden.bs.collapse', function () { ================================================== -->