quarto-dev / quarto-dev/quarto-cli

shortcode meta author fails in any file other than index.qmd when rendering a book to html, works everywhere for PDF

Open
#8,675 4 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

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

Description

Bug description

When attempting to render a book project, the shortcode
{{< meta author >}}
only works in index.qmd when rendering to HTML.

If used in any other file it renders as ?meta:author

During rendering quarto produces a warning message for every use of the shortcode:
WARNING (/Applications/quarto/share/filters/main.lua:15677) Unknown meta key author specified in a metadata Shortcode.

Steps to reproduce

In RStudio create a new Project of type Quarto Book

Add the shortcode
{{< meta author >}}

somewhere in the text of in index.qmd and in any other file (I used intro.qmd)

Save and Render Book to All Formats

Expected behavior

The shortcode should render correctly, no matter which .qmd file it is used in.
Rendering should also be (broadly) consistent between output formats.

Actual behavior

The shortcode {{< meta author >}} in any file except index.qmd renders to ?meta:author when rendering to HTML
The shortcode works correctly in index.qmd for HTML and PDF, and in any file when rendering to PDF

Your environment
  • IDE: RStudio 2023.12.1+402
  • OS: MacOS Sonoma 14.2.1 (23C71)
  • Hardware: Apple M1 Pro, 14 inch 2021
Quarto check output

Quarto 1.4.549
[✓] 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.549
Path: /Applications/quarto/bin

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

[✓] Checking LaTeX....................OK
Using: TinyTex
Path: /Users/yadbor/Library/TinyTeX/bin/universal-darwin
Version: 2023

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

[✓] Checking Python 3 installation....OK
Version: 3.9.6
Path: /Library/Developer/CommandLineTools/usr/bin/python3
Jupyter: (None)

  Jupyter is not available in this Python installation.
  Install with python3 -m pip install jupyter

[✓] Checking R installation...........OK
Version: 4.3.2
Path: /Library/Frameworks/R.framework/Resources
LibPaths:
- /Library/Frameworks/R.framework/Versions/4.3-arm64/Resources/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 in a Quarto Book using index.qmd and intro.qmd, rendering both HTML and PDF. Start by tracing the metadata shortcode warning reported at /Applications/quarto/share/filters/main.lua:15677. Done means {{< meta author >}} renders the author consistently in every .qmd file and across both output formats.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
build-system, documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.