From e4e0154e3a6f127e902be868fbec68e7b2cb8e61 Mon Sep 17 00:00:00 2001 From: Quy Date: Fri, 30 Dec 2016 21:31:25 -0800 Subject: Document $enable-print-styles (#21474) --- docs/getting-started/options.md | 1 + 1 file changed, 1 insertion(+) (limited to 'docs/getting-started') diff --git a/docs/getting-started/options.md b/docs/getting-started/options.md index b8dc3b583..a1491252e 100644 --- a/docs/getting-started/options.md +++ b/docs/getting-started/options.md @@ -38,3 +38,4 @@ You can find and customize these variables for key global options in our `_varia | `$enable-transitions` | `true` (default) or `false` | Enables predefined `transition`s on various components. | | `$enable-hover-media-query` | `true` or `false` (default) | ... | | `$enable-grid-classes` | `true` (default) or `false` | Enables the generation of CSS classes for the grid system (e.g., `.container`, `.row`, `.col-md-1`, etc.). | +| `$enable-print-styles` | `true` (default) or `false` | Enables styles for optimizing printing. | -- cgit v1.2.3 From a3f5def40cc1aafb612e669de71ed06c5a55ccef Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Wed, 28 Dec 2016 22:27:50 -0800 Subject: make note of slim build --- docs/getting-started/introduction.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/introduction.md b/docs/getting-started/introduction.md index bb9f0ea5f..8720b002d 100644 --- a/docs/getting-started/introduction.md +++ b/docs/getting-started/introduction.md @@ -25,7 +25,7 @@ Copy-paste the stylesheet `` into your `` before all other styleshee {% endhighlight %} -Add our JavaScript plugins, jQuery, and Tether near the end of your pages, right before the closing `` tag. Be sure to place jQuery and Tether first, as our code depends on them. +Add our JavaScript plugins, jQuery, and Tether near the end of your pages, right before the closing `` tag. Be sure to place jQuery and Tether first, as our code depends on them. While we use [jQuery's slim build](https://blog.jquery.com/2016/06/09/jquery-3-0-final-released/) in our docs, the full version is also supported. {% highlight html %} -- cgit v1.2.3 From e2b6badb86571d482c9653e05cedda10aae12127 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Sat, 31 Dec 2016 12:20:32 -0800 Subject: v4: Rip out IE compatibility mode meta tags (#21483) * Remove IE compatibility mode meta tag from docs, examples, and JS tests as we no longer support IE9 and IE8 * update and remove some IE bits from our supported browser page * update introduction.md to match * reword starter template intro --- docs/getting-started/browsers-devices.md | 61 ++------------------------------ docs/getting-started/introduction.md | 11 ++---- 2 files changed, 5 insertions(+), 67 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index 34d98a898..40628a2ec 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -105,70 +105,15 @@ Similarly, the latest versions of most desktop browsers are supported. For Firefox, in addition to the latest normal stable release, we also support the latest [Extended Support Release (ESR)](https://www.mozilla.org/en-US/firefox/organizations/faq/) version of Firefox. -Unofficially, Bootstrap should look and behave well enough in Chromium and Chrome for Linux, Firefox for Linux, and Internet Explorer 9 and below, though they are not officially supported. +Unofficially, Bootstrap should look and behave well enough in Chromium and Chrome for Linux, Firefox for Linux, and Internet Explorer 9, though they are not officially supported. For a list of some of the browser bugs that Bootstrap has to grapple with, see our [Wall of browser bugs]({{ site.baseurl }}/browser-bugs/). ## Internet Explorer -Internet Explorer 10+ is supported, however, IE9 down is not. Please be aware that some CSS3 properties and HTML5 elements are not fully supported. +Internet Explorer 10+ is supported; IE9 down is not. Please be aware that some CSS3 properties and HTML5 elements are not fully supported in IE10, or require prefixed properties for full functionality. Visit [Can I use...](http://caniuse.com/) for details on browser support of CSS3 and HTML5 features. -
- - - - - - - - - - - - - - - - - - - - - - - - - -
FeatureInternet Explorer 9Internet Explorer 10
transitionNot supportedSupported
placeholderNot supportedSupported
FlexboxNot supportedPartially supported, with -ms prefix
See Can I use for details
-
- -Visit [Can I use...](http://caniuse.com/) for details on browser support of CSS3 and HTML5 features. - -## Supporting Internet Explorer 8-9 - -As of v4, Bootstrap no longer supports IE8 or IE9. **If you require IE8-9 support, we recommend you use Bootstrap 3.** It's still supported by our team for bugfixes and documentation changes, but no new features will be added to it. - -Alternatively, you may add some third party JavaScript to backfill support for IE8-9 to Bootstrap 4. You'll need the following: - -* [The HTML5 shiv](https://en.wikipedia.org/wiki/HTML5_Shiv) -* [Respond.js](https://github.com/scottjehl/Respond) -* [Rem unit polyfill](https://github.com/chuckcarpenter/REM-unit-polyfill) - -No support will be provided for this, though you may find some help from the community in [our Slack channel]({{ site.slack }}). - -## 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 `` tag in your pages: - -{% highlight html %} - -{% endhighlight %} - -Confirm the document mode by opening the debugging tools: press F12 and check the "Document Mode". - -This tag is included in all of Bootstrap's documentation and examples to ensure the best rendering possible in each supported version of Internet Explorer. - -See [this StackOverflow question](https://stackoverflow.com/questions/6771258/what-does-meta-http-equiv-x-ua-compatible-content-ie-edge-do) for more information. +**If you require IE8-9 support, use Bootstrap 3.** It's the most stable version of our code and is still supported by our team for critical bugfixes and documentation changes. However, no new features will be added to it. ## Internet Explorer 10 in Windows Phone 8 diff --git a/docs/getting-started/introduction.md b/docs/getting-started/introduction.md index 8720b002d..9d6fa2ce4 100644 --- a/docs/getting-started/introduction.md +++ b/docs/getting-started/introduction.md @@ -37,22 +37,15 @@ And that's it—you're on your way to a fully Bootstrapped site. If you're at al ## Starter template -Be sure to have your pages set up with the latest design and development standards. That means: - -* Using an HTML5 doctype -* Forcing Internet Explorer to use its latest rendering mode ([read more](https://stackoverflow.com/questions/6771258/what-does-meta-http-equiv-x-ua-compatible-content-ie-edge-do)) -* And, utilizing the viewport meta tag. - -Put it all together and your pages should look like this: +Be sure to have your pages set up with the latest design and development standards. That means using an HTML5 doctype and including a viewport meta tag for proper responsive behaviors. Put it all together and your pages should look like this: {% highlight html %} - + - -- cgit v1.2.3 From ff8d28cf2501773ff6f7833865c8e2b2ebb76a3f Mon Sep 17 00:00:00 2001 From: Quy Date: Sat, 31 Dec 2016 16:12:28 -0800 Subject: Move .table-responsive from wrapper to .table --- docs/getting-started/browsers-devices.md | 146 +++++++++++++++---------------- 1 file changed, 71 insertions(+), 75 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index 40628a2ec..e9ad488b0 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -22,86 +22,82 @@ Alternative browsers which use the latest version of WebKit, Blink, or Gecko, wh Generally speaking, Bootstrap supports the latest versions of each major platform's default browsers. Note that proxy browsers (such as Opera Mini, Opera Mobile's Turbo mode, UC Browser Mini, Amazon Silk) are not supported. -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ChromeFirefoxSafariAndroid Browser & WebViewMicrosoft Edge
AndroidSupportedSupportedN/AAndroid v5.0+ supportedN/A
iOSSupportedSupportedSupportedN/AN/A
Windows 10 MobileN/AN/AN/AN/ASupported
-
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ChromeFirefoxSafariAndroid Browser & WebViewMicrosoft Edge
AndroidSupportedSupportedN/AAndroid v5.0+ supportedN/A
iOSSupportedSupportedSupportedN/AN/A
Windows 10 MobileN/AN/AN/AN/ASupported
### Desktop browsers Similarly, the latest versions of most desktop browsers are supported. -
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
ChromeFirefoxInternet ExplorerMicrosoft EdgeOperaSafari
MacSupportedSupportedN/AN/ASupportedSupported
WindowsSupportedSupportedSupported, IE10+SupportedSupportedNot supported
-
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
ChromeFirefoxInternet ExplorerMicrosoft EdgeOperaSafari
MacSupportedSupportedN/AN/ASupportedSupported
WindowsSupportedSupportedSupported, IE10+SupportedSupportedNot supported
For Firefox, in addition to the latest normal stable release, we also support the latest [Extended Support Release (ESR)](https://www.mozilla.org/en-US/firefox/organizations/faq/) version of Firefox. -- cgit v1.2.3 From bb07fff66cef31c52fc20f287297fb58463af967 Mon Sep 17 00:00:00 2001 From: Quan You Date: Mon, 2 Jan 2017 04:02:41 +0800 Subject: Update more copyright years to 2017 (#21491) * Update ie10-viewport-bug-workaround.js year * Update narrow-jumbotron copyright year to 2017 * Update carousel/index.html copyright year to 2017 * Update browsers-devices.md copyright year to 2017 * Update change-version.js copyright year to 2017 --- docs/getting-started/browsers-devices.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index e9ad488b0..b518c63f1 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -116,8 +116,8 @@ Internet Explorer 10+ is supported; IE9 down is not. Please be aware that some C Internet Explorer 10 in Windows Phone 8 versions older than [Update 3 (a.k.a. GDR3)](https://blogs.windows.com/buildingapps/2013/10/14/introducing-windows-phone-preview-for-developers/) doesn't differentiate **device width** from **viewport width** in `@-ms-viewport` at-rules, and thus doesn't properly apply the media queries in Bootstrap's CSS. To address this, you'll need to **include the following JavaScript to work around the bug**. {% highlight js %} -// Copyright 2014-2015 The Bootstrap Authors -// Copyright 2014-2015 Twitter, Inc. +// Copyright 2014-2017 The Bootstrap Authors +// Copyright 2014-2017 Twitter, Inc. // Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) if (navigator.userAgent.match(/IEMobile\/10\.0/)) { var msViewportStyle = document.createElement('style') -- cgit v1.2.3 From 38e53fc888a533f92ac1bfba2f6545aa8fdcf082 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 3 Jan 2017 12:26:32 -0800 Subject: update text --- docs/getting-started/browsers-devices.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index b518c63f1..5dee37dff 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -107,7 +107,7 @@ For a list of some of the browser bugs that Bootstrap has to grapple with, see o ## Internet Explorer -Internet Explorer 10+ is supported; IE9 down is not. Please be aware that some CSS3 properties and HTML5 elements are not fully supported in IE10, or require prefixed properties for full functionality. Visit [Can I use...](http://caniuse.com/) for details on browser support of CSS3 and HTML5 features. +Internet Explorer 10+ is supported; IE9 and down is not. Please be aware that some CSS3 properties and HTML5 elements are not fully supported in IE10, or require prefixed properties for full functionality. Visit [Can I use...](http://caniuse.com/) for details on browser support of CSS3 and HTML5 features. **If you require IE8-9 support, use Bootstrap 3.** It's the most stable version of our code and is still supported by our team for critical bugfixes and documentation changes. However, no new features will be added to it. -- cgit v1.2.3 From 450ef91b7db53dff5630a49331682abd578068f6 Mon Sep 17 00:00:00 2001 From: Bardi Harborow Date: Tue, 3 Jan 2017 11:46:57 +1100 Subject: Move node-sass to npm script and drop Ruby Sass. --- docs/getting-started/build-tools.md | 13 ------------- 1 file changed, 13 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/build-tools.md b/docs/getting-started/build-tools.md index a48304ebc..0d441d216 100644 --- a/docs/getting-started/build-tools.md +++ b/docs/getting-started/build-tools.md @@ -39,15 +39,6 @@ Our Gruntfile includes the following commands and tasks: | `grunt docs` | Builds and tests CSS, JavaScript, and other assets which are used when running the documentation locally via `jekyll serve`. | | `grunt watch` | This is a convenience method for watching just Sass files and automatically building them whenever you save. | -## Switching Sass compilers - -Bootstrap will be compiled with [libsass][libsass] by default, but you can opt into traditional Ruby Sass by setting the `TWBS_SASS` environment variable. Two options are supported: - -* `libsass` (default) to use [libsass][libsass] via [grunt-sass][grunt-sass]. -* `sass` to use [Ruby Sass][ruby-sass] via [grunt-contrib-sass][grunt-contrib-sass]. - -For example, run `TWBS_SASS=sass grunt` to test and build Bootstrap with Ruby Sass. - ## Autoprefixer Bootstrap uses [Autoprefixer][autoprefixer] (included in our Gruntfile and build process) to automatically add vendor prefixes to some CSS properties at build time. Doing so saves us time and code by allowing us to write key parts of our CSS a single time while eliminating the need for vendor mixins like those found in v3. @@ -68,8 +59,4 @@ Learn more about using Jekyll by reading its [documentation](https://jekyllrb.co Should you encounter problems with installing dependencies or running Grunt commands, uninstall all previous dependency versions (global and local). Then, rerun `npm install`. -[ruby-sass]: https://github.com/sass/sass -[grunt-contrib-sass]: https://github.com/gruntjs/grunt-contrib-sass -[libsass]: https://github.com/sass/libsass -[grunt-sass]: https://github.com/sindresorhus/grunt-sass [autoprefixer]: https://github.com/postcss/autoprefixer -- cgit v1.2.3 From 8b5c5408bb1a00993809a3f6c2b8e5a97433a55d Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 3 Jan 2017 19:23:30 -0800 Subject: remove some docs callouts --- docs/getting-started/accessibility.md | 4 ---- docs/getting-started/download.md | 4 ---- 2 files changed, 8 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/accessibility.md b/docs/getting-started/accessibility.md index a13ea286e..c1fe73dc0 100644 --- a/docs/getting-started/accessibility.md +++ b/docs/getting-started/accessibility.md @@ -16,10 +16,6 @@ Bootstrap follows common web standards and—with minimal extra effort—can be Some common HTML elements are always in need for basic accessibility enhancements through `role`s and Aria attributes. Below is a list of some of the most frequently used ones. -{% callout info %} -**Heads up!** As we go through the alphas, we'll be moving more accessibility notes here with links to specific sections from other areas of the docs. -{% endcallout %} - ### Button groups In order for assistive technologies–such as screen readers–to convey that a series of buttons is grouped, an appropriate `role` attribute needs to be provided. For button groups, this would be `role="group"`, while toolbars should have a `role="toolbar"`. diff --git a/docs/getting-started/download.md b/docs/getting-started/download.md index e23b26b7c..e953889f8 100644 --- a/docs/getting-started/download.md +++ b/docs/getting-started/download.md @@ -36,10 +36,6 @@ Skip the download and use the Bootstrap CDN to deliver Bootstrap's compiled CSS Pull in Bootstrap's **source files** into nearly any project with some of the most popular package managers. No matter the package manager, Bootstrap will **require a Sass compiler, [Autoprefixer](https://github.com/postcss/autoprefixer), and [postcss-flexbugs-fixes](https://github.com/luisrudge/postcss-flexbugs-fixes)** for a setup that matches our official compiled versions. -{% callout warning %} -**Heads up!** Not all package managers have the v4 alpha published yet, but we should have them up shortly! -{% endcallout %} - ### npm Install Bootstrap in your Node powered apps with [the npm package](https://www.npmjs.org/package/bootstrap): -- cgit v1.2.3