Skip to content

Pass epub-title-page set in YAML on to Pandoc - #15239

Open
Masad791 wants to merge 1 commit into
quarto-dev:mainfrom
Masad791:bugfix/epub-title-page-yaml
Open

Masad791 wants to merge 1 commit into
quarto-dev:mainfrom
Masad791:bugfix/epub-title-page-yaml

Conversation

@Masad791

Copy link
Copy Markdown
Contributor

Description

Fixes #15201.

epub-title-page wasn't in kPandocDefaultsKeys, so metadataAsFormat filed it under metadata instead of pandoc. It ended up as document metadata and never reached the Pandoc defaults file, so Pandoc kept writing title_page.xhtml. On the command line it worked because --epub-title-page=false is passed to Pandoc as is.

This adds it next to the other epub-* defaults keys. Pandoc reads epub-title-page from a defaults file. I checked that with the bundled Pandoc 3.10 on its own (-d with epub-title-page: false gives no title page).

Checked with the reporter's book project (format: epub: epub-title-page: false in _quarto.yml): repro.epub no longer contains title_page.xhtml. It's the same for front matter in a single document.

Test: 2026/10/31/issue-15201.qmd renders an epub with epub-title-page: false in front matter and asserts that content.opf has no title_page entry. It fails on main and passes with this change.

Checklist

I have (if applicable):

  • referenced the GitHub issue this PR closes
  • updated the appropriate changelog in the PR
  • ensured the present test suite passes
  • added new tests
  • created a separate documentation PR in Quarto's website repo and linked it to this PR
AI-assisted PR
  • AI tool used: Claude Code
  • Codebase grounding: local clone
  • Human review: I have reviewed, tested, and verified the AI-generated content before submitting.

epub-title-page was missing from kPandocDefaultsKeys, so a value set in
front matter or _quarto.yml was filed under metadata instead of the
Pandoc defaults file, and Pandoc kept generating the title page. It only
worked as --epub-title-page=false on the command line.

Fixes quarto-dev#15201
@posit-snyk-bot

posit-snyk-bot commented Oct 31, 2026 •

Copy link
Copy Markdown
Collaborator

✅ Snyk checks have passed. No issues have been found so far.

Status Scan Engine Critical High Medium Low Total (0)
✅ Open Source Security 0 0 0 0 0 issues
✅ Licenses 0 0 0 0 0 issues

💻 Catch issues earlier using the plugins for VS Code, JetBrains IDEs, Visual Studio, and Eclipse.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

"epub-title-page: false" in _quarto.yml is ignored unless passed as a CLI argument

2 participants