Add Reference sidebar landing pages to fix breadcrumb navigation#2003
Open
Add Reference sidebar landing pages to fix breadcrumb navigation#2003
Conversation
Contributor
📝 Preview Deployment🔍 Full site preview: https://deploy-preview-2003.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
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.
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.