quarto-dev / quarto-dev/quarto-cli

have custom appendix sections work in formats besides html

Open
#10,928 6 comments 2 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

docx enhancement latex typst
Dominant language
JavaScript
Stars
6k
Forks
458
Avg merge
1d 9h
Merged PRs (30d)
41

Description

Feature requested

Currently, the the custom appendix mechanism only works for HTML. It would be nice if it also worked for, say, pdf and docx. At the moment {.appendix} has no effect whatsoever in these formats.

Current behaviour
---
title: "Document en français avec annexes"
format: pdf
lang: fr
toc: true
number-sections: true
---

## Un problème intéressant

Une description

## Plus de détail {.appendix}

Des détails

## Un problème compliqué

Des compléments

## Encore plus de détail {.appendix}

Plein de détails

-> No section is moved nor considered part of the appendix.

Whised-for behavior

I would expect uniform behaviour across html, pdf and docx formats, that is all the appendices to be sent at the end of the document and be numbered together.

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

Start by reproducing the embedded .qmd example in HTML, PDF, and DOCX output, focusing on how sections marked {.appendix} are handled. Compare the generated section placement and numbering across formats; done means appendix sections move to the end and are numbered together consistently.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
42/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.