From e105d156420864807dca97d4953d0baf843f01f9 Mon Sep 17 00:00:00 2001 From: XhmikosR Date: Tue, 18 Sep 2018 22:27:46 +0300 Subject: Use https, fix broken links and unneeded redirects. --- docs/_includes/getting-started/accessibility.html | 14 +++++++------- docs/_includes/getting-started/browser-device-support.html | 12 ++++++------ docs/_includes/getting-started/community.html | 6 +++--- docs/_includes/getting-started/download.html | 10 +++++----- docs/_includes/getting-started/grunt.html | 6 +++--- docs/_includes/getting-started/tools.html | 2 +- docs/_includes/getting-started/whats-included.html | 4 ++-- 7 files changed, 27 insertions(+), 27 deletions(-) (limited to 'docs/_includes/getting-started') diff --git a/docs/_includes/getting-started/accessibility.html b/docs/_includes/getting-started/accessibility.html index 60820c121..5910a1b9f 100644 --- a/docs/_includes/getting-started/accessibility.html +++ b/docs/_includes/getting-started/accessibility.html @@ -3,9 +3,9 @@

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 before the navigation (for a simple explanation, see this A11Y Project article on skip navigation 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). 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).

@@ -21,17 +21,17 @@

Nested headings

When nesting headings (<h1> - <h6>), your primary document header should be an <h1>. Subsequent headings should make logical use of <h2> - <h6> such that screen readers can construct a table of contents for your pages.

-

Learn more at HTML CodeSniffer and Penn State's AccessAbility.

+

Learn more at HTML CodeSniffer and Penn State's AccessAbility.

Color contrast

-

Currently, some of the default color combinations available in Bootstrap (such as the various styled button classes, some of the code highlighting colors used for basic code blocks, the .bg-primary contextual background helper class, and the default link color when used on a white background) have a low contrast ratio (below the recommended ratio of 4.5:1). This can cause problems to users with low vision or who are color blind. These default colors may need to be modified to increase their contrast and legibility.

+

Currently, some of the default color combinations available in Bootstrap (such as the various styled button classes, some of the code highlighting colors used for basic code blocks, the .bg-primary contextual background helper class, and the default link color when used on a white background) have a low contrast ratio (below the recommended ratio of 4.5:1). This can cause problems to users with low vision or who are color blind. These default colors may need to be modified to increase their contrast and legibility.

Additional resources

diff --git a/docs/_includes/getting-started/browser-device-support.html b/docs/_includes/getting-started/browser-device-support.html index a0a12115f..758530f76 100644 --- a/docs/_includes/getting-started/browser-device-support.html +++ b/docs/_includes/getting-started/browser-device-support.html @@ -75,7 +75,7 @@

On Windows, we support Internet Explorer 8-11.

-

For Firefox, in addition to the latest normal stable release, we also support the latest Extended Support Release (ESR) version of Firefox.

+

For Firefox, in addition to the latest normal stable release, we also support the latest Extended Support Release (ESR) version of Firefox.

Unofficially, Bootstrap should look and behave well enough in Chromium and Chrome for Linux, Firefox for Linux, and Internet Explorer 7, as well as Microsoft Edge, 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.

@@ -119,7 +119,7 @@ -

Visit Can I use... for details on browser support of CSS3 and HTML5 features.

+

Visit Can I use... for details on browser support of CSS3 and HTML5 features.

Internet Explorer 8 and Respond.js

Beware of the following caveats when using Respond.js in your development and production environments for Internet Explorer 8.

@@ -143,14 +143,14 @@ {% 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 for more information.

+

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 scss %} @-ms-viewport { width: device-width; } {% endhighlight %} -

However, this doesn't work for devices running Windows Phone 8 versions older than Update 3 (a.k.a. GDR3), as it causes such devices to show a mostly desktop view instead of narrow "phone" view. To address this, you'll need to include the following CSS and JavaScript to work around the bug.

+

However, this doesn't work for devices running Windows Phone 8 versions older than Update 3 (a.k.a. GDR3), as it causes such devices to show a mostly desktop view instead of narrow "phone" view. To address this, you'll need to include the following CSS and JavaScript to work around the bug.

{% highlight scss %} @-ms-viewport { width: device-width; } @-o-viewport { width: device-width; } @@ -170,7 +170,7 @@ if (navigator.userAgent.match(/IEMobile\/10\.0/)) { document.querySelector('head').appendChild(msViewportStyle) } {% endhighlight %} -

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

+

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

As a heads up, we include this in all of Bootstrap's documentation and examples as a demonstration.

Safari percent rounding

@@ -228,7 +228,7 @@ $(function () { }) {% endhighlight %} -

Want to see an example? Check out this JS Bin demo.

+

Want to see an example? Check out this JS Bin demo.

Validators

In order to provide the best possible experience to old and buggy browsers, Bootstrap uses CSS browser hacks in several places to target special CSS to certain browser versions in order to work around bugs in the browsers themselves. These hacks understandably cause CSS validators to complain that they are invalid. In a couple places, we also use bleeding-edge CSS features that aren't yet fully standardized, but these are used purely for progressive enhancement.

diff --git a/docs/_includes/getting-started/community.html b/docs/_includes/getting-started/community.html index 73a88f807..c832e948c 100644 --- a/docs/_includes/getting-started/community.html +++ b/docs/_includes/getting-started/community.html @@ -3,11 +3,11 @@

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

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

diff --git a/docs/_includes/getting-started/download.html b/docs/_includes/getting-started/download.html index 08ddfe7d4..06426c60e 100644 --- a/docs/_includes/getting-started/download.html +++ b/docs/_includes/getting-started/download.html @@ -41,23 +41,23 @@ {% endhighlight %}

Install with Bower

-

You can also install and manage Bootstrap's Less, CSS, JavaScript, and fonts using Bower:

+

You can also install and manage Bootstrap's Less, CSS, JavaScript, and fonts using Bower:

{% highlight bash %}bower install bootstrap{% endhighlight %}

Install with npm

-

You can also install Bootstrap using npm:

+

You can also install Bootstrap using npm:

{% highlight bash %}npm install bootstrap@3{% endhighlight %}

require('bootstrap') will load all of Bootstrap's jQuery plugins onto the jQuery object. The bootstrap module itself does not export anything. You can manually load Bootstrap's jQuery plugins individually by loading the /js/*.js files under the package's top-level directory.

Bootstrap's package.json contains some additional metadata under the following keys:

Install with Composer

-

You can also install and manage Bootstrap's Less, CSS, JavaScript, and fonts using Composer:

+

You can also install and manage Bootstrap's Less, CSS, JavaScript, and fonts using Composer:

{% highlight bash %}composer require twbs/bootstrap{% endhighlight %}

Autoprefixer required for Less/Sass

-

Bootstrap uses Autoprefixer to deal with CSS vendor prefixes. If you're compiling Bootstrap from its Less/Sass source and not using our Gruntfile, you'll need to integrate Autoprefixer into your build process yourself. If you're using precompiled Bootstrap or using our Gruntfile, you don't need to worry about this because Autoprefixer is already integrated into our Gruntfile.

+

Bootstrap uses Autoprefixer to deal with CSS vendor prefixes. If you're compiling Bootstrap from its Less/Sass source and not using our Gruntfile, you'll need to integrate Autoprefixer into your build process yourself. If you're using precompiled Bootstrap or using our Gruntfile, you don't need to worry about this because Autoprefixer is already integrated into our Gruntfile.

diff --git a/docs/_includes/getting-started/grunt.html b/docs/_includes/getting-started/grunt.html index fc71f2881..09438715f 100644 --- a/docs/_includes/getting-started/grunt.html +++ b/docs/_includes/getting-started/grunt.html @@ -1,7 +1,7 @@

Compiling CSS and JavaScript

-

Bootstrap uses Grunt for its build system, with convenient methods for working with the framework. It's how we compile our code, run tests, and more.

+

Bootstrap uses Grunt for its build system, with convenient methods for working with the framework. It's how we compile our code, run tests, and more.

Installing Grunt

To install Grunt, you must first download and install node.js (which includes npm). npm stands for node packaged modules and is a way to manage development dependencies through node.js.

@@ -22,13 +22,13 @@

Watches the Less source files and automatically recompiles them to CSS whenever you save a change.

grunt test (Run tests)

-

Runs JSHint and runs the QUnit tests in real browsers thanks to Karma.

+

Runs JSHint and runs the QUnit tests in real browsers thanks to Karma.

grunt docs (Build & test the docs assets)

Builds and tests CSS, JavaScript, and other assets which are used when running the documentation locally via bundle exec jekyll serve.

grunt (Build absolutely everything and run tests)

-

Compiles and minifies CSS and JavaScript, builds the documentation website, runs the HTML5 validator against the docs, regenerates the Customizer assets, and more. Requires Jekyll. Usually only necessary if you're hacking on Bootstrap itself.

+

Compiles and minifies CSS and JavaScript, builds the documentation website, runs the HTML5 validator against the docs, regenerates the Customizer assets, and more. Requires Jekyll. Usually only necessary if you're hacking on Bootstrap itself.

Troubleshooting

Should you encounter problems with installing dependencies or running Grunt commands, first delete the /node_modules/ directory generated by npm. Then, rerun npm install.

diff --git a/docs/_includes/getting-started/tools.html b/docs/_includes/getting-started/tools.html index 2a38643fa..826fe80fc 100644 --- a/docs/_includes/getting-started/tools.html +++ b/docs/_includes/getting-started/tools.html @@ -2,5 +2,5 @@

Tools

Bootlint

-

Bootlint is the official Bootstrap HTML linter tool. It automatically checks for several common HTML mistakes in webpages that are using Bootstrap in a fairly "vanilla" way. Vanilla Bootstrap's components/widgets require their parts of the DOM to conform to certain structures. Bootlint checks that instances of Bootstrap components have correctly-structured HTML. Consider adding Bootlint to your Bootstrap web development toolchain so that none of the common mistakes slow down your project's development.

+

Bootlint is the official Bootstrap HTML linter tool. It automatically checks for several common HTML mistakes in webpages that are using Bootstrap in a fairly "vanilla" way. Vanilla Bootstrap's components/widgets require their parts of the DOM to conform to certain structures. Bootlint checks that instances of Bootstrap components have correctly-structured HTML. Consider adding Bootlint to your Bootstrap web development toolchain so that none of the common mistakes slow down your project's development.

diff --git a/docs/_includes/getting-started/whats-included.html b/docs/_includes/getting-started/whats-included.html index 3d48efa2d..a82c11889 100644 --- a/docs/_includes/getting-started/whats-included.html +++ b/docs/_includes/getting-started/whats-included.html @@ -5,7 +5,7 @@

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.

+

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.

Precompiled Bootstrap

@@ -35,7 +35,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.*). CSS source maps (bootstrap.*.map) are available for use with certain browsers' developer tools. Fonts from Glyphicons are included, as is the optional Bootstrap theme.

+

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.*). CSS source maps (bootstrap.*.map) are available for use with certain browsers' developer tools. Fonts from Glyphicons are included, as is the optional Bootstrap theme.

Bootstrap source code

The Bootstrap source code download includes the precompiled CSS, JavaScript, and font assets, along with source Less, JavaScript, and documentation. More specifically, it includes the following and more:

-- cgit v1.2.3