diff options
Diffstat (limited to 'docs/getting-started')
| -rw-r--r-- | docs/getting-started/accessibility.md | 13 | ||||
| -rw-r--r-- | docs/getting-started/community.md | 3 | ||||
| -rw-r--r-- | docs/getting-started/compiling.md | 4 | ||||
| -rw-r--r-- | docs/getting-started/template.md | 3 |
4 files changed, 16 insertions, 7 deletions
diff --git a/docs/getting-started/accessibility.md b/docs/getting-started/accessibility.md index 1d60957ea..c1a23da35 100644 --- a/docs/getting-started/accessibility.md +++ b/docs/getting-started/accessibility.md @@ -7,13 +7,20 @@ Bootstrap follows common web standards and—with minimal extra effort—can be ### 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](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 <code>.sr-only-focusable</code> class will ensure that the link becomes visible once focused (for sighted keyboard users). + +<div class="bs-callout bs-callout-danger" id="callout-skiplinks"> + <p>Due to long-standing shortcomings/bugs in Chrome (see <a href="https://code.google.com/p/chromium/issues/detail?id=262171" title="Chromium bug tracker - Issue 262171: Focus should cycle from named anchor">issue 262171 in the Chromium bug tracker</a>) and Internet Explorer (see this article on <a href="http://accessibleculture.org/articles/2010/05/in-page-links/">in-page links and focus order</a>), you will need to make sure that the target of your skip link is at least programmatically focusable by adding <code>tabindex="-1"</code>.</p> + <p>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 <code>tabindex="-1"</code> when they are clicked with the mouse) with <code>#content:focus { outline: none; }</code>.</p> + <p>Note that this bug will also affect any other in-page links your site may be using, rendering them useless for keyboard users. You may consider adding a similar stop-gap fix to all other named anchors / fragment identifiers that act as link targets.</p> +</div> {% highlight html %} <body> <a href="#content" class="sr-only sr-only-focusable">Skip to main content</a> - <div class="container" id="content"> - The main page content. + ... + <div class="container" id="content" tabindex="-1"> + <!-- The main page content --> </div> </body> {% endhighlight %} diff --git a/docs/getting-started/community.md b/docs/getting-started/community.md index d6270c381..d9a8cd166 100644 --- a/docs/getting-started/community.md +++ b/docs/getting-started/community.md @@ -9,6 +9,7 @@ Stay up to date on the development of Bootstrap and reach out to the community w - Chat with fellow Bootstrappers using IRC in the `irc.freenode.net` server, in the [##twitter-bootstrap channel](irc://irc.freenode.net/%23twitter-bootstrap). - For help using Bootstrap, ask on [StackOverflow using the tag `twitter-bootstrap-3`](http://stackoverflow.com/questions/tagged/twitter-bootstrap-3). - Find inspiring examples of people building with Bootstrap at the [Bootstrap Expo](http://expo.getbootstrap.com). +- Developers should use the keyword `bootstrap` on packages which modify or add to the functionality of Bootstrap when distributing through [npm](https://www.npmjs.com/browse/keyword/bootstrap) or similar delivery mechanisms for maximum discoverability. -You can also follow [@twbootstrap on Twitter](https://twitter.com/twbootstrap) for the latest gossip and awesome music videos. +You can also follow [@getbootstrap on Twitter](https://twitter.com/getbootstrap) for the latest gossip and awesome music videos. diff --git a/docs/getting-started/compiling.md b/docs/getting-started/compiling.md index 38aa249d5..1d5b29d0e 100644 --- a/docs/getting-started/compiling.md +++ b/docs/getting-started/compiling.md @@ -7,7 +7,7 @@ Bootstrap uses [Grunt](http://gruntjs.com) for its build system, with convenient ### Install Grunt -**To install Grunt, you must first [download and install node.js](http://nodejs.org/download/)** (which includes npm). npm stands for [node packaged modules](http://npmjs.org/) and is a way to manage development dependencies through node.js. +**To install Grunt, you must first [download and install node.js](http://nodejs.org/download/)** (which includes npm). npm stands for [node packaged modules](http://npmjs.com/) and is a way to manage development dependencies through node.js. From the command line: @@ -17,7 +17,7 @@ From the command line: When completed, you'll be able to run the various Grunt commands provided from the command line. -**Unfamiliar with npm? Don't have node installed?** That's a-okay. npm stands for [node packaged modules](http://npmjs.org/) and is a way to manage development dependencies through node.js. [Download and install node.js](http://nodejs.org/download/) before proceeding. +**Unfamiliar with npm? Don't have node installed?** That's a-okay. npm stands for [node packaged modules](http://npmjs.com/) and is a way to manage development dependencies through node.js. [Download and install node.js](http://nodejs.org/download/) before proceeding. [install-ruby]: https://www.ruby-lang.org/en/documentation/installation/ [gembundler]: http://bundler.io/ diff --git a/docs/getting-started/template.md b/docs/getting-started/template.md index 97982c2da..c1293c921 100644 --- a/docs/getting-started/template.md +++ b/docs/getting-started/template.md @@ -14,6 +14,7 @@ Copy the HTML below to begin working with a minimal Bootstrap document. <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> + <!-- The above 3 meta tags *must* come first in the head; any other head content must come *after* these tags. --> <title>Bootstrap 101 Template</title> <!-- Bootstrap --> @@ -23,7 +24,7 @@ Copy the HTML below to begin working with a minimal Bootstrap document. <h1>Hello, world!</h1> <!-- jQuery (necessary for Bootstrap's JavaScript plugins) --> - <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script> + <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.2/jquery.min.js"></script> <!-- Include all compiled plugins (below), or include individual files as needed --> <script src="js/bootstrap.min.js"></script> </body> |