From 2bbbf55180524c6e7510dc15d49fe6e17e8ff724 Mon Sep 17 00:00:00 2001 From: Mark Otto <otto@github.com> Date: Fri, 11 Jul 2014 23:46:47 -0700 Subject: [PATCH] Move accessibility to markdown --- .../getting-started/accessibility.html | 26 ---------------- docs/getting-started/accessibility.md | 31 +++++++++++++++++++ 2 files changed, 31 insertions(+), 26 deletions(-) delete mode 100644 docs/_includes/getting-started/accessibility.html create mode 100644 docs/getting-started/accessibility.md diff --git a/docs/_includes/getting-started/accessibility.html b/docs/_includes/getting-started/accessibility.html deleted file mode 100644 index cb9b3e11e1..0000000000 --- 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 0000000000..4d95a1631a --- /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) -- GitLab