{"id":94593,"date":"2018-11-28T23:13:31","date_gmt":"2018-11-28T23:13:31","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/wp-html5-outliner\/"},"modified":"2020-01-27T02:54:36","modified_gmt":"2020-01-27T02:54:36","slug":"wp-html5-outliner","status":"publish","type":"plugin","link":"https:\/\/ml.wordpress.org\/plugins\/wp-html5-outliner\/","author":13995440,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.3.0","stable_tag":"trunk","tested":"5.3.21","requires":"3.3","requires_php":"5.4.5","requires_plugins":"","header_name":"WP HTML5 Outliner","header_author":"Ryan Born","header_description":"Adds an HTML 5 outline plus a heading-level outline to the WordPress Toolbar.","assets_banners_color":"","last_updated":"2020-01-27 02:54:36","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/github.com\/ryansborn\/WP_HTML5_Outliner","header_author_uri":"https:\/\/github.com\/ryansborn","rating":0,"author_block_rating":0,"active_installs":10,"downloads":1383,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","faq","changelog"],"tags":[],"upgrade_notice":{"1.3.0":"<ul>\n<li>Finalized support for internationalization.<\/li>\n<\/ul>","1.2.0":"<ul>\n<li>Ensured &#039;No outline was created&#039; message replaces heading-level outline if source has no headings.<\/li>\n<\/ul>","1.1.0":"<ul>\n<li>Shortened Toolbar node title to &quot;Outline&quot;.<\/li>\n<li>Fixed notices for empty headings in an hgroup element that also contains non-heading elements.<\/li>\n<\/ul>"},"ratings":[],"assets_icons":{"icon.svg":{"filename":"icon.svg","revision":"1982265","resolution":"","location":"assets","locale":""}},"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.1.0","1.2.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"1989321","resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"1989321","resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"1989321","resolution":"3","location":"assets","locale":""}},"screenshots":{"1":"HTML 5 outline in a Toolbar dropdown box. <em>Theme<\/em>: Twenty Nineteen. <em>Context<\/em>: Homepage. <em>WordPress Version<\/em>: 5.0.","2":"Heading-level outline in a Toolbar dropdown box. <em>Theme<\/em>: Twenty Nineteen. <em>Context<\/em>: Homepage. <em>WordPress Version<\/em>: 5.0.","3":"HTML 5 outline and heading-level outline in a new window. <em>Theme<\/em>: Twenty Nineteen. <em>Context<\/em>: Homepage. <em>WordPress Version<\/em>: 5.0."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[1953,203,3510],"plugin_category":[34],"plugin_contributors":[164879],"plugin_business_model":[],"class_list":["post-94593","plugin","type-plugin","status-publish","hentry","plugin_tags-accessibility","plugin_tags-html5","plugin_tags-outline","plugin_category-accessibility","plugin_contributors-rsborn","plugin_committers-rsborn"],"banners":[],"icons":{"svg":"https:\/\/ps.w.org\/wp-html5-outliner\/assets\/icon.svg?rev=1982265","icon":"https:\/\/ps.w.org\/wp-html5-outliner\/assets\/icon.svg?rev=1982265","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/wp-html5-outliner\/assets\/screenshot-1.png?rev=1989321","caption":"HTML 5 outline in a Toolbar dropdown box. <em>Theme<\/em>: Twenty Nineteen. <em>Context<\/em>: Homepage. <em>WordPress Version<\/em>: 5.0."},{"src":"https:\/\/ps.w.org\/wp-html5-outliner\/assets\/screenshot-2.png?rev=1989321","caption":"Heading-level outline in a Toolbar dropdown box. <em>Theme<\/em>: Twenty Nineteen. <em>Context<\/em>: Homepage. <em>WordPress Version<\/em>: 5.0."},{"src":"https:\/\/ps.w.org\/wp-html5-outliner\/assets\/screenshot-3.png?rev=1989321","caption":"HTML 5 outline and heading-level outline in a new window. <em>Theme<\/em>: Twenty Nineteen. <em>Context<\/em>: Homepage. <em>WordPress Version<\/em>: 5.0."}],"raw_content":"<!--section=description-->\n<p>WP HTML5 Outliner (WPH5O) adds an HTML 5 outline plus a heading-level outline to the WordPress Toolbar.<\/p>\n\n<h4>Features<\/h4>\n\n<ul>\n<li>Matches the outlines provided by the <a href=\"https:\/\/validator.w3.org\/#validate_by_uri+with_options\">W3C Markup Validation Service<\/a>. <em>Caveat<\/em>: In an HTML 5 outline, the W3C validator may hide some of the headings in an <code>&lt;hgroup&gt;<\/code> if any of them are empty. WPH5O will not. This difference is presentational, not structural.<\/li>\n<li>Adds an 'Outline\u2019 node to the Toolbar. Outlines are displayed in a dropdown box, with the option to view them in a new browser window.<\/li>\n<li>Runs only on pages or posts the user can edit. Administrators can view outlines for any page or post. Administration Screens are not outlined.<\/li>\n<\/ul>\n\n<!--section=faq-->\n<dl>\n<dt>What is an HTML 5 outline?<\/dt>\n<dd><p>An HTML 5 outline represents the sections of an HTML document. Each section corresponds to an element from one of three categories:<\/p>\n\n<p><em>Sectioning root<\/em>: <code>&lt;blockquote&gt;<\/code>, <code>&lt;body&gt;<\/code>, <code>&lt;details&gt;<\/code>, <code>&lt;dialog&gt;<\/code>, <code>&lt;fieldset&gt;<\/code>, <code>&lt;figure&gt;<\/code>, <code>&lt;td&gt;<\/code>\n <em>Sectioning content<\/em>: <code>&lt;article&gt;<\/code>, <code>&lt;aside&gt;<\/code>, <code>&lt;nav&gt;<\/code>, <code>&lt;section&gt;<\/code>\n <em>Heading content<\/em>: <code>&lt;h1&gt;<\/code>, <code>&lt;h2&gt;<\/code>, <code>&lt;h3&gt;<\/code>, <code>&lt;h4&gt;<\/code>, <code>&lt;h5&gt;<\/code>, <code>&lt;h6&gt;<\/code><\/p>\n\n<p>Sections may be nested to create subsections.<\/p>\n\n<p>Source: <a href=\"https:\/\/www.w3.org\/TR\/html52\/sections.html\">W3C HTML 5.2 Specification<\/a><\/p><\/dd>\n<dt>What is a heading-level outline?<\/dt>\n<dd><p>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.<\/p>\n\n<p>Sources: <a href=\"https:\/\/www.w3.org\/QA\/Tips\/headings\">W3C Quality Assurance<\/a>, <a href=\"https:\/\/www.w3.org\/TR\/html52\/sections.html\">W3C HTML 5.2 Specification<\/a><\/p><\/dd>\n<dt>Why do these outlines matter?<\/dt>\n<dd><p>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 <em>that<\/em> outline matter?<\/p>\n\n<p>Although user agents still haven\u2019t implemented the HTML 5 outline (<a href=\"https:\/\/www.w3.org\/TR\/2008\/WD-html5-20080610\/the-root.html#outlines\">introduced in 2008<\/a>), developers aren\u2019t giving up on it. And they have their reasons. The MDN web docs highlight some <a href=\"https:\/\/wiki.developer.mozilla.org\/en-US\/docs\/Web\/Guide\/HTML\/Using_HTML_sections_and_outlines$revision\/1532798#Problems_solved_by_HTML5\">problems solved by HTML 5 document structure<\/a>.<\/p>\n\n<p>Sources: <a href=\"https:\/\/www.w3.org\/WAI\/tutorials\/page-structure\/headings\/\">W3C Web Accessibility Initiative<\/a>, <a href=\"https:\/\/www.w3.org\/TR\/html52\/sections.html\">W3C HTML 5.2 Specification<\/a><\/p><\/dd>\n<dt>Is there developer documentation?<\/dt>\n<dd><p>Yes. The source code conforms to <a href=\"https:\/\/make.wordpress.org\/core\/handbook\/best-practices\/inline-documentation-standards\/\">WordPress Inline Documentation Standards<\/a>. Fork this plugin at the <a href=\"https:\/\/github.com\/ryansborn\/WP_HTML5_Outliner\">WPH5O GitHub page<\/a>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Change text domain to plugin slug.<\/li>\n<li>Add i18n support to JS files.<\/li>\n<li>Edit readme section titled \u201cWhy do these outlines matter?\u201d.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Add function to load plugin's text domain.<\/li>\n<li>Ensure 'No outline was created' message replaces heading-level outline if source has no headings.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Fix notices for empty headings in an hgroup element that also contains non-heading elements.<\/li>\n<li>Shorten Toolbar node title to \"Outline\".<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Release the plugin!<\/li>\n<\/ul>","raw_excerpt":"Adds an HTML 5 outline plus a heading-level outline to the WordPress Toolbar.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/94593","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=94593"}],"author":[{"embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/rsborn"}],"wp:attachment":[{"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=94593"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=94593"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=94593"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=94593"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=94593"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ml.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=94593"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}