Add Reference sidebar landing pages to fix breadcrumb navigation

_quarto.yml

@@ -493,6 +493,7 @@ website:
           href: docs/reference/index.qmd
           contents:
             - section: "Formats"
+              href: docs/reference/formats/index.qmd
               contents:
                 - text: "HTML"
                   href: docs/reference/formats/html.qmd
@@ -586,6 +587,7 @@ website:
                 - text: "Observable"
                   href: docs/reference/cells/cells-ojs.qmd
             - section: "Projects"
+              href: docs/reference/projects/index.qmd
               contents:
                 - text: "Options"
                   href: docs/reference/projects/options.qmd
@@ -595,7 +597,8 @@ website:
                   href: docs/reference/projects/books.qmd
                 - text: "Manuscripts"
                   href: docs/reference/projects/manuscripts.qmd
-            - section: "More"
+            - section: "Metadata"
+              href: docs/reference/metadata/index.qmd
               contents:
                 - text: "Dates"
                   href: docs/reference/dates.qmd

docs/reference/formats/index.qmd

@@ -0,0 +1,14 @@
+---
+title: Formats
+toc: false
+anchor-sections: false
+listing:
+  id: reference-links
+  template: ../../../ejs/links.ejs
+  contents: ./reference.yml
+---
+
+Reference for the document, presentation, markdown, wiki, and other output formats Quarto can produce. Each link points to the YAML option reference for that format.
+
+::: {#reference-links .column-screen-inset-right style="max-width: 850px;"}
+:::

docs/reference/formats/reference.yml

@@ -0,0 +1,88 @@
+- title: "Documents"
+  links:
+    - text: HTML
+      href: html.qmd
+    - text: PDF
+      href: pdf.qmd
+    - text: MS Word
+      href: docx.qmd
+    - text: Typst
+      href: typst.qmd
+    - text: OpenDocument
+      href: odt.qmd
+    - text: ePub
+      href: epub.qmd
+
+- title: "Presentations"
+  links:
+    - text: Revealjs
+      href: presentations/revealjs.qmd
+    - text: PowerPoint
+      href: presentations/pptx.qmd
+    - text: Beamer
+      href: presentations/beamer.qmd
+
+- title: "Markdown"
+  links:
+    - text: GitHub
+      href: markdown/gfm.qmd
+    - text: CommonMark
+      href: markdown/commonmark.qmd
+    - text: Hugo
+      href: markdown/hugo.qmd
+    - text: Markua
+      href: markdown/markua.qmd
+
+- title: "Wikis"
+  links:
+    - text: MediaWiki
+      href: wiki/mediawiki.qmd
+    - text: DokuWiki
+      href: wiki/dokuwiki.qmd
+    - text: ZimWiki
+      href: wiki/zimwiki.qmd
+    - text: Jira Wiki
+      href: wiki/jira.qmd
+    - text: XWiki
+      href: wiki/xwiki.qmd
+
+- title: "More Formats"
+  links:
+    - text: JATS
+      href: jats.qmd
+    - text: Jupyter
+      href: ipynb.qmd
+    - text: Dashboards
+      href: dashboard.qmd
+    - text: ConTeXt
+      href: context.qmd
+    - text: RTF
+      href: rtf.qmd
+    - text: reST
+      href: rst.qmd
+    - text: AsciiDoc
+      href: asciidoc.qmd
+    - text: Org-Mode
+      href: org.qmd
+    - text: Muse
+      href: muse.qmd
+    - text: GNU TexInfo
+      href: texinfo.qmd
+    - text: Groff Man Page
+      href: man.qmd
+    - text: Groff Manuscript
+      href: ms.qmd
+    - text: Haddock markup
+      href: haddock.qmd
+    - text: OPML
+      href: opml.qmd
+    - text: Textile
+      href: textile.qmd
+    - text: DocBook
+      href: docbook.qmd
+    - text: InDesign
+      href: icml.qmd
+    - text: TEI Simple
+      href: tei.qmd
+    - text: FictionBook
+      href: fb2.qmd

docs/reference/metadata/index.qmd

@@ -0,0 +1,14 @@
+---
+title: Metadata
+toc: false
+anchor-sections: false
+listing:
+  id: reference-links
+  template: ../../../ejs/links.ejs
+  contents: ./reference.yml
+---
+
+Reference for document- and project-level metadata: dates, glob patterns, citations, cross-references, and brand configuration.
+
+::: {#reference-links .column-screen-inset-right style="max-width: 850px;"}
+:::

docs/reference/metadata/reference.yml

@@ -0,0 +1,12 @@
+- title: "Metadata"
+  links:
+    - text: Dates
+      href: ../dates.qmd
+    - text: Globs
+      href: ../globs.qmd
+    - text: Citations
+      href: citation.qmd
+    - text: Cross-References
+      href: crossref.qmd
+    - text: Brand
+      href: brand.qmd

docs/reference/projects/index.qmd

@@ -0,0 +1,14 @@
+---
+title: Projects
+toc: false
+anchor-sections: false
+listing:
+  id: reference-links
+  template: ../../../ejs/links.ejs
+  contents: ./reference.yml
+---
+
+Reference for Quarto project types and their YAML options. Project types include websites, books, and manuscripts; the Options page covers settings shared across all project types.
+
+::: {#reference-links .column-screen-inset-right style="max-width: 850px;"}
+:::

docs/reference/projects/reference.yml

@@ -0,0 +1,10 @@
+- title: "Projects"
+  links:
+    - text: Options
+      href: options.qmd
+    - text: Websites
+      href: websites.qmd
+    - text: Books
+      href: books.qmd
+    - text: Manuscripts
+      href: manuscripts.qmd