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
Nobody has claimed this yet.
- 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
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- 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