diff options
| author | Mark Otto <[email protected]> | 2014-07-11 23:46:47 -0700 |
|---|---|---|
| committer | Mark Otto <[email protected]> | 2014-07-11 23:46:47 -0700 |
| commit | 2bbbf55180524c6e7510dc15d49fe6e17e8ff724 (patch) | |
| tree | 4f75b546ef2e67b7235af5dda9db45d06b490129 /docs | |
| parent | 28c946af900f7edf1bfb03e2ad466687a0d5c464 (diff) | |
| download | bootstrap-2bbbf55180524c6e7510dc15d49fe6e17e8ff724.tar.xz bootstrap-2bbbf55180524c6e7510dc15d49fe6e17e8ff724.zip | |
Move accessibility to markdown
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/_includes/getting-started/accessibility.html | 26 | ||||
| -rw-r--r-- | docs/getting-started/accessibility.md | 31 |
2 files changed, 31 insertions, 26 deletions
diff --git a/docs/_includes/getting-started/accessibility.html b/docs/_includes/getting-started/accessibility.html deleted file mode 100644 index cb9b3e11e..000000000 --- a/docs/_includes/getting-started/accessibility.html +++ /dev/null @@ -1,26 +0,0 @@ -<div class="bs-docs-section"> - <h1 id="accessibility" class="page-header">Accessibility</h1> - <p class="lead">Bootstrap follows common web standards and—with minimal extra effort—can be used to create sites that are accessible to those using <abbr title="Assistive Technology" class="initialism">AT</abbr>.</p> - - <h3>Skip navigation</h3> - <p>If your navigation contains many links and comes before the main content in the DOM, add a <code>Skip to main content</code> link immediately after your opening <code><body></code> tag. <a href="http://a11yproject.com/posts/skip-nav-links/">(read why)</a></p> -{% 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> -</body> -{% endhighlight %} - - <h3>Nested headings</h3> - <p>When nesting headings (<code><h1></code> - <code><h6></code>), your primary document header should be an <code><h1></code>. Subsequent headings should make logical use of <code><h2></code> - <code><h6></code> such that screen readers can construct a table of contents for your pages.</p> - <p>Learn more at <a href="http://squizlabs.github.io/HTML_CodeSniffer/Standards/Section508/">HTML CodeSniffer</a> and <a href="http://accessibility.psu.edu/headings">Penn State's AccessAbility</a>.</p> - - <h3>Additional resources</h3> - <ul> - <li><a href="https://github.com/squizlabs/HTML_CodeSniffer">"HTML Codesniffer" bookmarklet for identifying accessibility issues</a></li> - <li><a href="http://a11yproject.com/">The A11Y Project</a></li> - <li><a href="https://developer.mozilla.org/en-US/docs/Accessibility">MDN accessibility documentation</a></li> - </ul> -</div> diff --git a/docs/getting-started/accessibility.md b/docs/getting-started/accessibility.md new file mode 100644 index 000000000..4d95a1631 --- /dev/null +++ b/docs/getting-started/accessibility.md @@ -0,0 +1,31 @@ +--- +layout: page +title: Accessibility +--- + +Bootstrap follows common web standards and—with minimal extra effort—can be used to create sites that are accessible to those using <abbr title="Assistive Technology" class="initialism">AT</abbr>. + +### Skip navigation + +If your navigation contains many links and comes before the main content in the DOM, add a `Skip to main content` link immediately after your opening `<body>` tag. [(read why)](http://a11yproject.com/posts/skip-nav-links/) + +{% 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> +</body> +{% endhighlight %} + +### 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](http://squizlabs.github.io/HTML_CodeSniffer/Standards/Section508/) and [Penn State's Accessability](http://accessibility.psu.edu/headings). + +### Additional resources + +- ["HTML Codesniffer" bookmarklet for identifying accessibility issues](https://github.com/squizlabs/HTML_CodeSniffer) +- [The A11Y Project](http://a11yproject.com/) +- [MDN accessibility documentation](https://developer.mozilla.org/en-US/docs/Accessibility) |