Use headings as suggested by HTML5 document outline specifications

Created on 29 September 2014, about 11 years ago

Updated 19 August 2025, about 2 months ago

Problem/Motivation

In HTML5 each section of a html page may use h1 as the html tag of the section title. Also the page title should use h1 becouse that is the root, the main title of the outline.

Unfortunately

There are currently no known implementations of the outline algorithm in graphical browsers…

so this issue must be postponed until browsers implement this feature.

Proposed resolution

Change the html tag to h1 in node.html.twig

  {{ title_prefix }}
  {% if not page %}
    <h2{{ title_attributes }}>
      <a href="{{ url }}" rel="bookmark">{{ label }}</a>
    </h2>
  {% endif %}
  {{ title_suffix }}

Remove the "content title" conditional (see below) from page.html.twig:

        {% if title %}
          <strong class="site-name">
            <a href="{{ front_page }}" title="{{ 'Home'|t }}" rel="home">{{ site_name }}</a>
          </strong>
        {% else %}

Remaining tasks

1. Wait 'till browsers implement document outline.
2. Make the changes suggested in the proposed resolution section above ^^

User interface changes

Moe h1 tags… ;)

API changes

None.

📌 Task

Status

Postponed: needs info

Version

11.0 🔥

Component

theme system

Created by

🇭🇺Hungary thamas Hungary

Live updates comments and jobs are added and updated live.

frontend

stale-issue-cleanup
To track issues in the developing policy for closing stale issues, [Policy, no patch] closing older issues

Incomplete comments

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

Comment about 2 months ago →
🇺🇸United States smustgrave
Thank you for creating this issue to improve Drupal.

We are working to decide if this task is still relevant to a currently supported version of Drupal. There hasn't been any discussion here for over 8 years which suggests that this has either been implemented or is no longer relevant. Your thoughts on this will allow a decision to be made.

Since we need more information to move forward with this issue, the status is now Postponed (maintainer needs more info). If we don't receive additional information to help with the issue, it may be closed after three months.

Thanks!
Comment about 1 month ago →
🇭🇺Hungary thamas Hungary
I think it should be simply closed as "won't fix".

See eg.:https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/Hea...
Comment about 1 month ago →
🇺🇸United States smustgrave

contrib.social Blog FAQ Discussions

Production build 0.71.5 2024