=== WP HTML5 Outliner === Contributors: rsborn Tags: html5, outline, accessibility Requires at least: 3.3 Tested up to: 5.3.2 Requires PHP: 5.4.5 Stable tag: 1.3.0 License: GPL-2.0 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Adds an HTML 5 outline plus a heading-level outline to the WordPress Toolbar. == Description == WP HTML5 Outliner (WPH5O) adds an HTML 5 outline plus a heading-level outline to the WordPress Toolbar. = Features = - Matches the outlines provided by the [W3C Markup Validation Service](https://validator.w3.org/#validate_by_uri+with_options). *Caveat*: In an HTML 5 outline, the W3C validator may hide some of the headings in an `` if any of them are empty. WPH5O will not. This difference is presentational, not structural. - Adds an 'Outline’ node to the Toolbar. Outlines are displayed in a dropdown box, with the option to view them in a new browser window. - Runs only on pages or posts the user can edit. Administrators can view outlines for any page or post. Administration Screens are not outlined. == Frequently Asked Questions == = What is an HTML 5 outline? = An HTML 5 outline represents the sections of an HTML document. Each section corresponds to an element from one of three categories: *Sectioning root*: `

`, ``, `
`, ``, `
`, `
`, `` *Sectioning content*: `
`, `
`, `
`, `
` *Heading content*: `
`, `
`, `
`, `
`, `
`, `
` Sections may be nested to create subsections. Source: [W3C HTML 5.2 Specification](https://www.w3.org/TR/html52/sections.html) = What is a heading-level outline? = A heading-level outline represents the sections of an HTML document. Each section corresponds to a heading element. Sections may be nested to create subsections. Sources: [W3C Quality Assurance](https://www.w3.org/QA/Tips/headings), [W3C HTML 5.2 Specification](https://www.w3.org/TR/html52/sections.html) = Why do these outlines matter? = Each outline shows how well a page meets web standards for marking up document structure. User agents, particularly screen readers, use the heading-level outline to aid navigation. However, no web browsers or assistive technologies make use of the HTML 5 outline. So, really, the question is this: Why does *that* outline matter? Although user agents still haven’t implemented the HTML 5 outline ([introduced in 2008](https://www.w3.org/TR/2008/WD-html5-20080610/the-root.html#outlines)), developers aren’t giving up on it. And they have their reasons. The MDN web docs highlight some [problems solved by HTML 5 document structure](https://wiki.developer.mozilla.org/en-US/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines$revision/1532798#Problems_solved_by_HTML5). Sources: [W3C Web Accessibility Initiative](https://www.w3.org/WAI/tutorials/page-structure/headings/), [W3C HTML 5.2 Specification](https://www.w3.org/TR/html52/sections.html) = Is there developer documentation? = Yes. The source code conforms to [WordPress Inline Documentation Standards](https://make.wordpress.org/core/handbook/best-practices/inline-documentation-standards/). Fork this plugin at the [WPH5O GitHub page](https://github.com/ryansborn/WP_HTML5_Outliner). == Screenshots == 1. HTML 5 outline in a Toolbar dropdown box. *Theme*: Twenty Nineteen. *Context*: Homepage. *WordPress Version*: 5.0. 2. Heading-level outline in a Toolbar dropdown box. *Theme*: Twenty Nineteen. *Context*: Homepage. *WordPress Version*: 5.0. 3. HTML 5 outline and heading-level outline in a new window. *Theme*: Twenty Nineteen. *Context*: Homepage. *WordPress Version*: 5.0. == Changelog == = 1.3.0 = - Change text domain to plugin slug. - Add i18n support to JS files. - Edit readme section titled “Why do these outlines matter?”. = 1.2.0 = - Add function to load plugin's text domain. - Ensure 'No outline was created' message replaces heading-level outline if source has no headings. = 1.1.0 = - Fix notices for empty headings in an hgroup element that also contains non-heading elements. - Shorten Toolbar node title to "Outline". = 1.0.0 = - Release the plugin! == Upgrade Notice == = 1.3.0 = - Finalized support for internationalization. = 1.2.0 = - Ensured 'No outline was created' message replaces heading-level outline if source has no headings. = 1.1.0 = - Shortened Toolbar node title to "Outline". - Fixed notices for empty headings in an hgroup element that also contains non-heading elements.