[Sync to prerelease] Add Reference sidebar landing pages to fix breadcrumb navigation#2035
Merged
Conversation
* Add Formats landing page for Reference sidebar * Add Projects landing page for Reference sidebar * Replace Reference 'More' section with 'Metadata' landing page (cherry picked from commit 32e1c70)
Member
|
/deploy-preview |
Contributor
Author
📝 Preview Deployment🔍 Full site preview: https://deploy-preview-2035.quarto.org 🔄 Modified Documents |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Description
Sync of #2003 to
prerelease.Original PR
Add Reference sidebar landing pages to fix breadcrumb navigation
When clicking the
Formatsbreadcrumb on/docs/reference/formats/<page>.html, the link led toformats/html.html(the first child) instead of a section landing. TheReference > Moresection had a similar issue and was not a coherent grouping for its contents.Adds explicit landing pages for three Reference sidebar sections so the breadcrumb renders as a clickable link to a real page:
Formats→ newdocs/reference/formats/index.qmdProjects→ newdocs/reference/projects/index.qmdMore→ renamed toMetadataand pointed at newdocs/reference/metadata/index.qmdThe
More→Metadatarename matches the grouping already used indocs/reference/reference.yml(the master listing the website renders) — Dates, Globs, Citations, Cross-References, and Brand are now grouped underMetadatain the sidebar too. The five items themselves are unchanged.Each landing mirrors the existing
docs/reference/cells/pattern: smallindex.qmdshell + a per-subdirreference.ymlsubset rendered by the existingejs/links.ejstemplate. No new extension, shortcode, or filter. The masterdocs/reference/reference.ymlis untouched.Reported in quarto-dev/quarto-cli#14402. The underlying CLI fallback behavior (sidebar sections without
href:usecontents[0].href) is tracked separately at quarto-dev/quarto-cli#14454 and is not addressed here. Inner Guide sub-sections (HTML/PDF/MS Word/Typst/Markdown under Documents) andReference > Quarto CLIcontinue to inherit the same fallback and are deferred.A follow-up PR will fix the
Documentssection in the Guide sidebar.