From 8139bf44c51a451ff2d7f6197bd2073ea656e4e1 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Sun, 7 Feb 2016 01:09:01 -0800 Subject: Add docs regarding postcss-flexbugs-fixes dependency --- docs/getting-started/download.md | 4 ++-- docs/getting-started/flexbox.md | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/download.md b/docs/getting-started/download.md index 1fa524eb5..7ee6fecee 100644 --- a/docs/getting-started/download.md +++ b/docs/getting-started/download.md @@ -21,7 +21,7 @@ Download just the compiled and minified CSS and JavaScript. Doesn't include any
{% markdown %} ### Source files -Download everything: source Sass, JavaScript, and documentation files. **Requires a Sass compiler, [Autoprefixer](https://github.com/postcss/autoprefixer), and [some setup]({{ site.baseurl }}/getting-started/build-tools/#tooling-setup).** +Download everything: source Sass, JavaScript, and documentation files. **Requires a Sass compiler, [Autoprefixer](https://github.com/postcss/autoprefixer), [postcss-flexbugs-fixes](https://github.com/luisrudge/postcss-flexbugs-fixes), and [some setup]({{ site.baseurl }}/getting-started/build-tools/#tooling-setup).** Download source {% endmarkdown %} @@ -30,7 +30,7 @@ Download everything: source Sass, JavaScript, and documentation files. **Require ## Package managers -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 and [Autoprefixer](https://github.com/postcss/autoprefixer)** for a setup that matches our official compiled versions. +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! diff --git a/docs/getting-started/flexbox.md b/docs/getting-started/flexbox.md index f8ab4e8ae..9c0f1a876 100644 --- a/docs/getting-started/flexbox.md +++ b/docs/getting-started/flexbox.md @@ -19,7 +19,7 @@ Flexbox support is available for a number of Bootstrap's components: - Input groups, which move from `display: table;` to `display: flex;`. - The media component moves from `display: table;` and a number of hacky styles to a simple `display: flex;`. -Vendor prefixes are provided in our compiled CSS with Autoprefixer via Grunt. +Vendor prefixes are provided in our compiled CSS with [Autoprefixer](https://github.com/postcss/autoprefixer) via Grunt. Some bugs in IE10-11's Flexbox implementation are worked around via [postcss-flexbugs-fixes](https://github.com/luisrudge/postcss-flexbugs-fixes). ## Why flexbox? -- cgit v1.2.3 From bfc16c4a829ba596db28f5f42d7a3e429e6ea2e1 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Mon, 20 Jun 2016 00:48:02 -0700 Subject: Remove refs to fixed printing-related Chrome bug from browser support docs (#20144) Refs https://bugs.chromium.org/p/chromium/issues/detail?id=273306#c34 [skip sauce] --- docs/getting-started/browsers-devices.md | 8 +------- 1 file changed, 1 insertion(+), 7 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/browsers-devices.md b/docs/getting-started/browsers-devices.md index 7bb95ebf3..a73ec8982 100644 --- a/docs/getting-started/browsers-devices.md +++ b/docs/getting-started/browsers-devices.md @@ -219,13 +219,7 @@ Bootstrap includes a workaround for this, although it is disabled by default. By Even in some modern browsers, printing can be quirky. -In particular, as of Chrome v32 and regardless of margin settings, Chrome uses a viewport width significantly narrower than the physical paper size when resolving media queries while printing a webpage. This can result in Bootstrap's extra-small grid being unexpectedly activated when printing. See [issue #12078](https://github.com/twbs/bootstrap/issues/12078) and [Chrome bug #273306](https://bugs.chromium.org/p/chromium/issues/detail?id=273306) for some details. Suggested workarounds: - -* Embrace the extra-small grid and make sure your page looks acceptable under it. -* Customize the value of the `$grid-breakpoints` Sass variable so that your printer paper is considered larger than extra-small. -* Add custom media queries to change the grid size breakpoints for print media only. - -Also, as of Safari v8.0, use of the fixed-width `.container` class can cause Safari to use an unusually small font size when printing. See [issue #14868](https://github.com/twbs/bootstrap/issues/14868) and [WebKit bug #138192](https://bugs.webkit.org/show_bug.cgi?id=138192) for more details. One potential workaround is the following CSS: +As of Safari v8.0, use of the fixed-width `.container` class can cause Safari to use an unusually small font size when printing. See [issue #14868](https://github.com/twbs/bootstrap/issues/14868) and [WebKit bug #138192](https://bugs.webkit.org/show_bug.cgi?id=138192) for more details. One potential workaround is the following CSS: {% highlight css %} @media print { -- cgit v1.2.3 From a358fc9dc1b71c4177735c4ca27c9da350d655af Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Mon, 20 Jun 2016 16:18:21 -0700 Subject: Replace grunt-postcss with postcss-cli (#20140) Refs #19990 Continues the degruntification process. Also removes mq4-hover-shim for now, since it doesn't yet implement the standard PostCSS plugin interface. --- docs/getting-started/build-tools.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/build-tools.md b/docs/getting-started/build-tools.md index c086c036b..2fe10088b 100644 --- a/docs/getting-started/build-tools.md +++ b/docs/getting-started/build-tools.md @@ -46,7 +46,7 @@ For example, run `TWBS_SASS=sass grunt` to test and build Bootstrap with Ruby Sa 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. -We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See [`/grunt/autoprefixer-settings.json`](https://github.com/twbs/bootstrap/blob/master/grunt/autoprefixer-settings.js) for details. +We maintain the list of browsers supported through Autoprefixer in a separate file within our GitHub repository. See [`/grunt/postcss.js`](https://github.com/twbs/bootstrap/blob/master/grunt/postcss.js) for details. ## Local documentation -- cgit v1.2.3 From 76e9a7328efd364e747c2e71b9cad5c44a3b5ecd Mon Sep 17 00:00:00 2001 From: Curt Grimes Date: Thu, 23 Jun 2016 22:39:03 -0500 Subject: Fix links to A11Y Project posts Closes #20165 [skip sauce] --- docs/getting-started/accessibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/accessibility.md b/docs/getting-started/accessibility.md index 147d9305e..9faaaffb1 100644 --- a/docs/getting-started/accessibility.md +++ b/docs/getting-started/accessibility.md @@ -22,7 +22,7 @@ In addition, groups and toolbars should be given an explicit label, as most assi ## Skip navigation -If your navigation contains many links and comes before the main content in the DOM, add a `Skip to main content` link before the navigation (for a simple explanation, see this [A11Y Project article on skip navigation links](http://a11yproject.com/posts/skip-nav-links/)). Using the `.sr-only` class will visually hide the skip link, and the .sr-only-focusable class will ensure that the link becomes visible once focused (for sighted keyboard users). +If your navigation contains many links and comes before the main content in the DOM, add a `Skip to main content` link before the navigation (for a simple explanation, see this [A11Y Project article on skip navigation links](http://a11yproject.com/posts/skip-nav-links)). Using the `.sr-only` class will visually hide the skip link, and the .sr-only-focusable class will ensure that the link becomes visible once focused (for sighted keyboard users). {% callout danger %} Due to long-standing shortcomings/bugs in Chrome (see [issue 454172 in the Chromium bug tracker](https://code.google.com/p/chromium/issues/detail?id=454172 "Chromium bug tracker - Issue 454172: Focus Link Target (sequential focus navigation starting point)")) and Internet Explorer (see this article on [in-page links and focus order](http://accessibleculture.org/articles/2010/05/in-page-links/)), you will need to make sure that the target of your skip link is at least programmatically focusable by adding `tabindex="-1"`. -- cgit v1.2.3 From 5073e756f87de81999a6761609794a3473dbad19 Mon Sep 17 00:00:00 2001 From: Chris Rebert Date: Thu, 23 Jun 2016 23:19:06 -0700 Subject: Remove reference to fixed Chrome bug in accessibility docs (#20145) Refs https://bugs.chromium.org/p/chromium/issues/detail?id=454172#c22 [skip sauce] --- docs/getting-started/accessibility.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/accessibility.md b/docs/getting-started/accessibility.md index 9faaaffb1..43dee3569 100644 --- a/docs/getting-started/accessibility.md +++ b/docs/getting-started/accessibility.md @@ -25,7 +25,7 @@ In addition, groups and toolbars should be given an explicit label, as most assi If your navigation contains many links and comes before the main content in the DOM, add a `Skip to main content` link before the navigation (for a simple explanation, see this [A11Y Project article on skip navigation links](http://a11yproject.com/posts/skip-nav-links)). Using the `.sr-only` class will visually hide the skip link, and the .sr-only-focusable class will ensure that the link becomes visible once focused (for sighted keyboard users). {% callout danger %} -Due to long-standing shortcomings/bugs in Chrome (see [issue 454172 in the Chromium bug tracker](https://code.google.com/p/chromium/issues/detail?id=454172 "Chromium bug tracker - Issue 454172: Focus Link Target (sequential focus navigation starting point)")) and Internet Explorer (see this article on [in-page links and focus order](http://accessibleculture.org/articles/2010/05/in-page-links/)), you will need to make sure that the target of your skip link is at least programmatically focusable by adding `tabindex="-1"`. +Due to long-standing shortcomings/bugs in Internet Explorer (see this article on [in-page links and focus order](http://accessibleculture.org/articles/2010/05/in-page-links/)), you will need to make sure that the target of your skip link is at least programmatically focusable by adding `tabindex="-1"`. In addition, you may want to explicitly suppress a visible focus indication on the target (particularly as Chrome currently also sets focus on elements with `tabindex="-1"` when they are clicked with the mouse) with `#content:focus { outline: none; }`. -- cgit v1.2.3 From e613415a76daa4e0d6bb0d3dfa0dccbc073e778d Mon Sep 17 00:00:00 2001 From: Alice Young Date: Tue, 19 Jul 2016 21:40:21 -0400 Subject: Docs: Update `composer require` command to download current v4 alpha version (#20328) --- docs/getting-started/download.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/download.md b/docs/getting-started/download.md index 7ee6fecee..37fbbaa59 100644 --- a/docs/getting-started/download.md +++ b/docs/getting-started/download.md @@ -78,7 +78,7 @@ $ meteor add twbs:bootstrap@={{ site.current_version }} You can also install and manage Bootstrap's Sass and JavaScript using [Composer](https://getcomposer.org): {% highlight bash %} -$ composer require twbs/bootstrap +$ composer require twbs/bootstrap:{{ site.current_version }} {% endhighlight %} ### Bower -- cgit v1.2.3 From 855a82e3a27b73738518ff2486ee9e4e3b7be872 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 26 Jul 2016 20:18:51 -0700 Subject: remove dist download option for now; it has been coming soon for far too long --- docs/getting-started/download.md | 18 ------------------ 1 file changed, 18 deletions(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/download.md b/docs/getting-started/download.md index 37fbbaa59..6e094aa50 100644 --- a/docs/getting-started/download.md +++ b/docs/getting-started/download.md @@ -6,27 +6,10 @@ group: getting-started **Bootstrap v{{ site.current_version}}** is available for download in several ways, including some of your favorite package managers. Choose from the options below to snag just what you need. -
-
-{% markdown %} -### Compiled -Download just the compiled and minified CSS and JavaScript. Doesn't include any documentation or original source files. - -{% comment %} -Download Bootstrap -{% endcomment %} -Coming soon! -{% endmarkdown %} -
-
-{% markdown %} ### Source files Download everything: source Sass, JavaScript, and documentation files. **Requires a Sass compiler, [Autoprefixer](https://github.com/postcss/autoprefixer), [postcss-flexbugs-fixes](https://github.com/luisrudge/postcss-flexbugs-fixes), and [some setup]({{ site.baseurl }}/getting-started/build-tools/#tooling-setup).** Download source -{% endmarkdown %} -
-
## Package managers @@ -121,4 +104,3 @@ Need only a part of Bootstrap's CSS or JS? Use one of the custom builds to snag Download
- -- cgit v1.2.3 From 069a0dd6e7fd0a73a5cbb8a0b716b65f2bb0cfe4 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 26 Jul 2016 20:20:16 -0700 Subject: comment out custom builds for now --- docs/getting-started/download.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'docs/getting-started') diff --git a/docs/getting-started/download.md b/docs/getting-started/download.md index 6e094aa50..be46329be 100644 --- a/docs/getting-started/download.md +++ b/docs/getting-started/download.md @@ -83,6 +83,7 @@ PM> Install-Package bootstrap.sass -Pre The `-Pre` is required until Bootstrap v4 has a stable release. +{% comment %} ## Custom builds Need only a part of Bootstrap's CSS or JS? Use one of the custom builds to snag just what you need. @@ -104,3 +105,4 @@ Need only a part of Bootstrap's CSS or JS? Use one of the custom builds to snag Download +{% endcomment %} -- cgit v1.2.3 From c017eaca2fb318f7d215f41b966d553429e00f90 Mon Sep 17 00:00:00 2001 From: Mark Otto Date: Tue, 26 Jul 2016 20:21:45 -0700 Subject: elaborate on those classes --- docs/getting-started/options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'docs/getting-started') diff --git a/docs/getting-started/options.md b/docs/getting-started/options.md index 8ed206888..dd7f7fb3d 100644 --- a/docs/getting-started/options.md +++ b/docs/getting-started/options.md @@ -37,4 +37,4 @@ You can find and customize these variables for key global options in our `_varia | `$enable-gradients` | `true` or `false` (default) | Enables predefined gradients via `background-image` styles on various components. | | `$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. `.col-md-1` etc.). | +| `$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.). | -- cgit v1.2.3