From 92c78ad14f7e519586e4443bc66392fae72deb83 Mon Sep 17 00:00:00 2001 From: christophe dervieux Date: Wed, 29 Apr 2026 11:21:26 +0200 Subject: [PATCH 1/3] Add Formats landing page for Reference sidebar --- _quarto.yml | 1 + docs/reference/formats/index.qmd | 14 +++++ docs/reference/formats/reference.yml | 88 ++++++++++++++++++++++++++++ 3 files changed, 103 insertions(+) create mode 100644 docs/reference/formats/index.qmd create mode 100644 docs/reference/formats/reference.yml diff --git a/_quarto.yml b/_quarto.yml index 9c5bdeab4c..d75eb1ac18 100644 --- a/_quarto.yml +++ b/_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 diff --git a/docs/reference/formats/index.qmd b/docs/reference/formats/index.qmd new file mode 100644 index 0000000000..62a1cc6403 --- /dev/null +++ b/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;"} +::: diff --git a/docs/reference/formats/reference.yml b/docs/reference/formats/reference.yml new file mode 100644 index 0000000000..4fe68e794e --- /dev/null +++ b/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 From 49cc501c6ae34c318e4eec7743e748c42c51df43 Mon Sep 17 00:00:00 2001 From: christophe dervieux Date: Wed, 29 Apr 2026 11:43:12 +0200 Subject: [PATCH 2/3] Add Projects landing page for Reference sidebar --- _quarto.yml | 1 + docs/reference/projects/index.qmd | 14 ++++++++++++++ docs/reference/projects/reference.yml | 10 ++++++++++ 3 files changed, 25 insertions(+) create mode 100644 docs/reference/projects/index.qmd create mode 100644 docs/reference/projects/reference.yml diff --git a/_quarto.yml b/_quarto.yml index d75eb1ac18..301ba53f96 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -587,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 diff --git a/docs/reference/projects/index.qmd b/docs/reference/projects/index.qmd new file mode 100644 index 0000000000..43e1bfcd11 --- /dev/null +++ b/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;"} +::: diff --git a/docs/reference/projects/reference.yml b/docs/reference/projects/reference.yml new file mode 100644 index 0000000000..bfe31d79fd --- /dev/null +++ b/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 From 6523dd4aba0114d34b99954ecb79b5cf9abca104 Mon Sep 17 00:00:00 2001 From: christophe dervieux Date: Wed, 29 Apr 2026 11:46:04 +0200 Subject: [PATCH 3/3] Replace Reference 'More' section with 'Metadata' landing page --- _quarto.yml | 3 ++- docs/reference/metadata/index.qmd | 14 ++++++++++++++ docs/reference/metadata/reference.yml | 12 ++++++++++++ 3 files changed, 28 insertions(+), 1 deletion(-) create mode 100644 docs/reference/metadata/index.qmd create mode 100644 docs/reference/metadata/reference.yml diff --git a/_quarto.yml b/_quarto.yml index 301ba53f96..fdfe4144b6 100644 --- a/_quarto.yml +++ b/_quarto.yml @@ -597,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 diff --git a/docs/reference/metadata/index.qmd b/docs/reference/metadata/index.qmd new file mode 100644 index 0000000000..9960bc15d6 --- /dev/null +++ b/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;"} +::: diff --git a/docs/reference/metadata/reference.yml b/docs/reference/metadata/reference.yml new file mode 100644 index 0000000000..fb243e3600 --- /dev/null +++ b/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