quarto-dev / quarto-dev/quarto-cli
General support for references to the name of a Section/Chapter/etc. rather than its number.
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 6k
- Forks
- 458
- Avg merge
- 1d 9h
- Merged PRs (30d)
- 41
Description
Discussed in https://github.com/quarto-dev/quarto-cli/discussions/1178
Originally posted by fuhrmanator June 18, 2022
In books it is very useful to refer to a section by its name. The Quarto documentation does this, e.g. the link to "Cross references" on this line:
But it's done with a hyperlink to an absolute HTML page.
Another example is within a page:
There's an anchor generated through ## Options {#options}. It seems to be HTML-specific.
In LaTeX, it's done by \nameref{sec-blahblah} and I see that quarto supports this for PDF output.
Are there plans to make this work with @sec-blahblah for other render destinations (e.g. html)? I'm thinking something like [caption@sec-blahblah] as a general solution.
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.
Assessment
This issue has not been assessed yet.