quarto-dev / quarto-dev/quarto-cli

Footnote on chapter header for quarto html book

Open
#8,023 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

books bug
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Bug description

Footnote on chapter header in a quarto html book is not rendering correctly. This is related to a question post in stackoverflow and in #7841 by John K. Kruschke

Steps to reproduce

The structure of the book is the following:

_quarto.yml

project:
  type: book

book:
  title: "Book test"
  chapters:
    - index.qmd
    - a_chapter.qmd
    
number-sections: true

format:
  html:
    theme: default
  pdf:
    documentclass: book

editor: visual

index.qmd

# Preface {.unnumbered}

This is a Quarto book.

a_chapter.qmd

# A Chapter Header[^a_chapter-1] {#sec-a_chapter}

[^a_chapter-1]: Footnote Chapter A Header.

This sentence has a footnote[^a_chapter-2]

[^a_chapter-2]: Footnote Chapter A paragraph.

See @sec-a_chapter.
Expected behavior

I should expect to obtain a similar result as in the case of quarto pdf book:

Screenshot 2023-12-24 091600

Actual behavior

I obtain the following result:

Screenshot 2023-12-24 090956

Your environment
  • IDE: RStudio 2023.12.0+369
    "Ocean Storm" Release (33206f75bd14d07d84753f965eaa24756eda97b7, 2023-12-17)
    for windows Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) RStudio/2023.12.0+369 Chrome/116.0.5845.190 Electron/26.2.4 Safari/537.36
  • OS: Edition: Windows 11 Pro
    Version: 22H2
    Installed on: 2023-‎06-‎26
    OS build: 22621.2861
    Experience: Windows Feature Experience Pack 1000.22681.1000.0
Quarto check output
$ quarto check
Quarto 1.4.533
[>] Checking versions of quarto binary dependencies...
      Pandoc version 3.1.11: OK
      Dart Sass version 1.69.5: OK
      Deno version 1.37.2: OK
[>] Checking versions of quarto dependencies......OK
[>] Checking Quarto installation......OK
      Version: 1.4.533
      Path: C:\Users\Usuario\AppData\Local\Programs\Quarto\bin
      CodePage: 1252

[>] Checking tools....................OK
      TinyTeX: (external install)
      Chromium: (not installed)

[>] Checking LaTeX....................OK
      Using: TinyTex
      Path: C:\Users\Usuario\AppData\Roaming\TinyTeX\bin\windows\
      Version: 2023

[>] Checking basic markdown render....OK

[>] Checking Python 3 installation....OK
      Version: 3.11.6 (Conda)
      Path: C:/Users/Usuario/anaconda3/python.exe
      Jupyter: 5.5.1
      Kernels: ir, julia-1.9, python3

[>] Checking Jupyter engine render....OK

[>] Checking R installation...........OK
      Version: 4.3.2
      Path: C:/PROGRA~1/R/R-43~1.2
      LibPaths:
        - C:/Users/Usuario/AppData/Local/R/win-library/4.3
        - C:/Program Files/R/R-4.3.2/library
      knitr: 1.45
      rmarkdown: 2.25

[>] Checking Knitr engine render......OK

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Reproduce the issue using the supplied _quarto.yml, index.qmd, and a_chapter.qmd examples, first running the Quarto HTML book render. Compare the chapter-header footnote with the paragraph footnote and the expected PDF behavior; done means the header footnote renders correctly in the HTML book while the existing references still work.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
documentation
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Clearly specified
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.