Skip to content

Accessibility suggestions: Footers, table of contents, and headers #1032

@mine-cetinkaya-rundel

Description

@mine-cetinkaya-rundel

This issue came up in the review of the accessible cheatsheets, see mine-cetinkaya-rundel/html-cheatsheets#2 (comment) for the original issue.


The following is a simplified version of the HTML output with format: html and toc: true:

<!DOCTYPE html>
<html lang="en">

  <head>
    <title>Document Title</title>
  </head>
  
  <body>
  
    <div id="quarto-content">
  
      <div id="quarto-margin-sidebar" class="sidebar margin-sidebar">
        TABLE OF CONTENTS...
      </div>
  
      <main class="content" id="quarto-document-content">
  
        <header id="title-block-header" class="quarto-title-block default">
          <div class="quarto-title">
            <h1 class="title">Document Title</h1>
          </div>
        </header>
  
        DOCUMENT TEXT...
  
      </main>
  
    </div>
  
  </body>

</html>

Three accessibility suggestions are:

  1. Make footer available to HTML output via the yaml (like page-footer for websites, for example).
  2. Move the table of contents into the header.
  3. Move the header outside of main.

Similar to #1030, (2) and (3) might be things to address in Pandoc. I'm guessing (1) is addressable in Quarto.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions