_quarto.yml

project:
  type: website
  output-dir: _site
  post-render:
    - tools/algolia-add-custom-attribute.ts
  resources:
    - "/docs/download/_download.json"
    - "/docs/download/_prerelease.json"
    - "/_redirects"
    - "/docs/blog/posts/2024-07-02-beautiful-tables-in-typst/demo"
    - "/.well-known/atproto-did"

website:
  title: "Quarto"
  image: "quarto-dark-bg.jpeg"
  favicon: "favicon.png"
  google-analytics: "G-FV9Z7SDZ0M"
  open-graph: true
  twitter-card: true
  site-url: https://quarto.org
  repo-url: https://github.com/quarto-dev/quarto-web
  issue-url: https://github.com/quarto-dev/quarto-cli/issues/new/choose
  repo-actions: [edit, issue]
  page-navigation: true
  bread-crumbs: true
  search:
    show-item-context: true
    type: overlay
    algolia:
      index-name: prod_QUARTO
      application-id: ZPJB5I1QN7
      search-only-api-key: 49ee55c4d51cbb25a06182d9eef55814
      analytics-events: true
      show-logo: true
  page-footer:
    left: |
      Proudly supported by
      [![](https://posit.co/wp-content/uploads/2024/06/Posit-Logos-2024_horiz-full-color.svg){fig-alt="Posit" width=65px}](https://posit.co)
    center:
      - text: "About"
        href: about.qmd
      - text: "FAQ"
        href: docs/faq/index.qmd
      - text: "License"
        href: license.md
      - text: "Trademark"
        href: trademark.qmd
    right:
      - icon: twitter
        href: https://twitter.com/quarto_pub
        aria-label: Quarto Twitter
      - icon: github
        href: https://github.com/quarto-dev/quarto-cli
        aria-label: Quarto GitHub
      - icon: rss
        href: https://quarto.org/docs/blog/index.xml
        aria-label: Quarto Blog RSS
  navbar:
    background: light
    logo: quarto.png
    logo-alt: "Quarto logo."
    title: false
    collapse-below: lg
    left:
      - text: "Overview"
        href: index.qmd
      - text: "Get Started"
        href: docs/get-started/index.qmd
      - text: "Guide"
        href: docs/guide/index.qmd
      - text: Extensions
        href: docs/extensions/index.qmd
      - text: "Reference"
        href: docs/reference/index.qmd
      - text: "Gallery"
        href: docs/gallery/index.qmd
      - text: "Blog"
        href: docs/blog/index.qmd
      - text: "Help"
        menu:
          - text: "Report a Bug"
            icon: "bug"
            href: "https://github.com/quarto-dev/quarto-cli/issues"
          - text: "Ask a Question"
            icon: "chat-right-text"
            href: "https://github.com/quarto-dev/quarto-cli/discussions"
          - text: "FAQ"
            icon: "question-circle"
            href: docs/faq/index.qmd
    tools:
      - icon: twitter
        href: https://twitter.com/quarto_pub
        text: Quarto Twitter
      - icon: github
        href: https://github.com/quarto-dev/quarto-cli
        text: Quarto GitHub
      - icon: rss
        href: https://quarto.org/docs/blog/index.xml
        text: Quarto Blog RSS

  sidebar:
    - id: get-started
      title: "Get Started"
      style: "floating"
      collapse-level: 2
      align: left
      contents:
        - docs/get-started/index.qmd
        - text: "Tutorial: Hello, Quarto"
          href: docs/get-started/hello/
        - text: "Tutorial: Computations"
          href: docs/get-started/computations/
        - text: "Tutorial: Authoring"
          href: docs/get-started/authoring/

    - id: guide
      collapse-level: 1
      contents:
        - section: "Guide"
          href: docs/guide/index.qmd
          contents:
            - section: "Authoring"
              contents:
                - docs/authoring/markdown-basics.qmd
                - docs/authoring/figures.qmd
                - docs/authoring/tables.qmd
                - docs/authoring/diagrams.qmd
                - section: "Shortcodes"
                  href: docs/authoring/shortcodes.qmd
                  contents:
                    - text: "Placeholder Image"
                      href: docs/authoring/placeholder.qmd
                    - text: "Lorem Lipsum Text"
                      href: docs/authoring/lipsum.qmd
                    - text: "Rearrange Contents"
                      href: docs/authoring/contents.qmd
                - docs/authoring/videos.qmd
                - text: "Embeds"
                  href: docs/authoring/notebook-embed.qmd
                - docs/authoring/callouts.qmd
                - docs/authoring/code-annotation.qmd
                - text: "Brand"                
                  href: docs/authoring/brand.qmd
                - docs/authoring/article-layout.qmd
                - section: "Scholarly Writing"
                  contents:
                    - docs/authoring/front-matter.qmd
                    - docs/authoring/title-blocks.qmd
                    - docs/authoring/citations.qmd
                    - section: Cross-References
                      contents:
                        - text: Basics
                          href: docs/authoring/cross-references.qmd
                        - text: Options
                          href: docs/authoring/cross-reference-options.qmd
                        - text: Div Syntax
                          href: docs/authoring/cross-references-divs.qmd
                        - text: Custom Floats
                          href: docs/authoring/cross-references-custom.qmd
                    - docs/authoring/create-citeable-articles.qmd
                    - docs/authoring/appendices.qmd
            - section: "Computations"
              contents:
                - docs/computations/python.qmd
                - docs/computations/r.qmd
                - docs/computations/julia.qmd
                - docs/computations/ojs.qmd
                - docs/computations/inline-code.qmd
                - docs/computations/render-scripts.qmd
                - docs/computations/execution-options.qmd
                - docs/computations/parameters.qmd
            - section: "Tools"
              contents:
                - section: "JupyterLab"
                  contents:
                    - text: "JupyterLab Basics"
                      href: docs/tools/jupyter-lab.qmd
                    - text: "JupyterLab Extension"
                      href: docs/tools/jupyter-lab-extension.qmd
                - section: "RStudio IDE"
                  contents:
                    - text: "RStudio Basics"
                      href: docs/tools/rstudio.qmd
                    - section: "Visual Editor"
                      href: docs/visual-editor/index.qmd
                      contents:
                        - text: Editor Basics
                          href: docs/visual-editor/index.qmd
                        - docs/visual-editor/technical.qmd
                        - docs/visual-editor/content.qmd
                        - docs/visual-editor/options.qmd
                        - docs/visual-editor/markdown.qmd
                - section: "VS Code"
                  href: docs/tools/vscode.qmd
                  contents:
                    - text: "VS Code Basics"
                      href: docs/tools/vscode.qmd
                    - text: "Visual Editor"
                      href: docs/visual-editor/vscode/index.qmd
                    - text: "Notebook Editor"
                      href: docs/tools/vscode-notebook.qmd
                - docs/tools/neovim.qmd
                - docs/tools/text-editors.qmd
            - section: "Documents"
              contents:
                - section: "HTML"
                  contents:
                    - docs/output-formats/html-basics.qmd
                    - docs/output-formats/html-code.qmd
                    - docs/output-formats/html-themes.qmd
                    - docs/output-formats/html-multi-format.qmd
                    - docs/output-formats/html-lightbox-figures.qmd
                    - docs/output-formats/html-publishing.qmd
                - section: "PDF"
                  contents:
                    - docs/output-formats/pdf-basics.qmd
                    - docs/output-formats/pdf-engine.qmd
                - section: "MS Word"
                  contents:
                    - docs/output-formats/ms-word.qmd
                    - docs/output-formats/ms-word-templates.qmd
                - section: "Typst"
                  contents:
                    - docs/output-formats/typst.qmd
                    - text: "Custom Formats"
                      href: docs/output-formats/typst-custom.qmd
                - section: "Markdown"
                  contents:
                    - docs/output-formats/gfm.qmd
                    - docs/output-formats/hugo.qmd
                    - docs/output-formats/docusaurus.qmd
                - docs/output-formats/all-formats.qmd
            - section: "Presentations"
              contents:
                - text: "Overview"
                  href: docs/presentations/index.qmd
                - section: docs/presentations/revealjs/index.qmd
                  contents:
                    - text: "Reveal Basics"
                      href: docs/presentations/revealjs/index.qmd
                    - docs/presentations/revealjs/presenting.qmd
                    - docs/presentations/revealjs/advanced.qmd
                    - docs/presentations/revealjs/themes.qmd
                - docs/presentations/powerpoint.qmd
                - docs/presentations/beamer.qmd

            - section: "Dashboards"
              href: docs/dashboards/index.qmd
              contents:
                - text: Overview
                  href: docs/dashboards/index.qmd
                - section: "Using Dashboards"
                  href: docs/dashboards/layout.qmd
                  contents:
                    - text: Layout
                      href: docs/dashboards/layout.qmd
                    - text: Data Display
                      href: docs/dashboards/data-display.qmd
                    - text: Inputs
                      href: docs/dashboards/inputs.qmd
                    - text: Theming
                      href: docs/dashboards/theming.qmd
                    - text: Parameters
                      href: docs/dashboards/parameters.qmd
                    - text: Deployment
                      href: docs/dashboards/deployment.qmd
                - section: "Interactivity"
                  href: docs/dashboards/interactivity/index.qmd
                  contents:
                    - text: Overview
                      href: docs/dashboards/interactivity/index.qmd
                    - section: Shiny for Python
                      href: docs/dashboards/interactivity/shiny-python/index.qmd
                      contents:
                        - text: Getting Started
                          href: docs/dashboards/interactivity/shiny-python/index.qmd
                        - text: Running Dashboards
                          href: docs/dashboards/interactivity/shiny-python/running.qmd
                        - text: Execution Contexts
                          href: docs/dashboards/interactivity/shiny-python/execution.qmd
                    - section: Shiny for R
                      href: docs/dashboards/interactivity/shiny-r.qmd
                      contents:
                        - text: Getting Started
                          href: docs/dashboards/interactivity/shiny-r.qmd
                        - docs/interactive/shiny/running.qmd
                        - docs/interactive/shiny/execution.qmd
                    - text: Observable JS
                      href: docs/dashboards/interactivity/observable.qmd
                - text: Examples
                  href: docs/gallery/index.qmd#dashboards

            - section: "Websites"
              href: docs/websites/website-basics.qmd
              contents:
                - docs/websites/website-basics.qmd
                - docs/websites/website-navigation.qmd
                - docs/websites/website-blog.qmd
                - docs/websites/website-drafts.qmd
                - docs/websites/website-search.qmd
                - docs/websites/website-tools.qmd
                - docs/websites/website-about.qmd
                - section: "Listing Pages"
                  href: docs/websites/website-listings.qmd
                  contents:
                    - docs/websites/website-listings.qmd
                    - docs/websites/website-listings-custom.qmd

            - section: "Books"
              href: docs/books/book-basics.qmd
              contents:
                - docs/books/book-basics.qmd
                - docs/books/book-structure.qmd
                - docs/books/book-crossrefs.qmd
                - text: "Customizing Output"
                  href: docs/books/book-output.qmd

            - section: "Manuscripts"
              href: docs/manuscripts/index.qmd
              contents:
                - text: Getting Started
                  href: docs/manuscripts/index.qmd
                  contents:
                    - text: "Authoring Manuscripts"
                      href: docs/manuscripts/authoring/jupyterlab.qmd
                      contents:
                        - text: Jupyter Lab
                          href: docs/manuscripts/authoring/jupyterlab.qmd
                        - text: VS Code
                          href: docs/manuscripts/authoring/vscode.qmd
                        - text: RStudio
                          href: docs/manuscripts/authoring/rstudio.qmd
                    - text: "Publishing Manuscripts"
                      href: docs/manuscripts/publishing.qmd
                    - text: "Next Steps"
                      href: docs/manuscripts/next-steps.qmd
                - text: "Using Manuscripts"
                  href: docs/manuscripts/components.qmd

            - section: "Interactivity"
              contents:
                - text: "Overview"
                  href: docs/interactive/index.qmd
                - section: docs/interactive/ojs/index.qmd
                  contents:
                    - text: "Introduction"
                      href: docs/interactive/ojs/index.qmd
                    - docs/interactive/ojs/libraries.qmd
                    - docs/interactive/ojs/data-sources.qmd
                    - docs/interactive/ojs/ojs-cells.qmd
                    - docs/interactive/ojs/shiny.qmd
                    - docs/interactive/ojs/code-reuse.qmd
                    - section: "Examples"
                      contents:
                        - docs/interactive/ojs/examples/penguins.qmd
                        - docs/interactive/ojs/examples/sunburst.qmd
                        - docs/interactive/ojs/examples/arquero.qmd
                        - docs/interactive/ojs/examples/population.qmd
                        - docs/interactive/ojs/examples/noaa-co2.qmd
                        - docs/interactive/ojs/examples/github.qmd
                        - docs/interactive/ojs/examples/layout.qmd
                        - section: "Shiny"
                          contents:
                            - text: "K-Means"
                              href: https://jjallaire.shinyapps.io/kmeans-shiny-ojs/
                            - text: "Binning"
                              href: https://jjallaire.shinyapps.io/binning-shiny-ojs/
                            - text: "Data Binding"
                              href: https://jjallaire.shinyapps.io/data-shiny-ojs/
                            - text: "Covid Map"
                              href: https://jjallaire.shinyapps.io/covid19-bicartogram/
                - section: docs/interactive/shiny/index.qmd
                  contents:
                    - text: "Introduction"
                      href: docs/interactive/shiny/index.qmd
                    - docs/interactive/shiny/running.qmd
                    - docs/interactive/shiny/execution.qmd
                    - docs/interactive/shiny/resources.qmd
                    - section: "Examples"
                      contents:
                        - text: "Old Faithful"
                          href: https://jjallaire.shinyapps.io/shiny-old-faithful/
                        - text: "K-Means"
                          href: https://jjallaire.shinyapps.io/shiny-k-means/
                        - text: "Diamonds"
                          href: https://jjallaire.shinyapps.io/shiny-diamonds/
                - section: "Widgets"
                  contents:
                    - docs/interactive/widgets/jupyter.qmd
                    - docs/interactive/widgets/htmlwidgets.qmd
                - docs/interactive/layout.qmd
            - section: "Publishing"
              contents:
                - docs/publishing/index.qmd
                - docs/publishing/quarto-pub.qmd
                - docs/publishing/github-pages.qmd
                - docs/publishing/rstudio-connect.qmd
                - docs/publishing/posit-cloud.qmd
                - docs/publishing/netlify.qmd
                - docs/publishing/confluence.qmd
                - docs/publishing/hugging-face.qmd
                - docs/publishing/other.qmd
                - text: "Publishing with CI"
                  href: docs/publishing/ci.qmd
            - section: "Projects"
              contents:
                - docs/projects/quarto-projects.qmd
                - docs/projects/code-execution.qmd
                - docs/projects/profiles.qmd
                - docs/projects/environment.qmd
                - docs/projects/scripts.qmd
                - docs/projects/virtual-environments.qmd
                - docs/projects/binder.qmd
            - section: "Advanced"
              contents:
                - docs/authoring/includes.qmd
                - docs/authoring/variables.qmd
                - docs/output-formats/page-layout.qmd
                - docs/authoring/language.qmd
                - docs/authoring/conditional.qmd
                - docs/extensions/nbfilter.qmd
                - section: "Jupyter"
                  contents:
                    - docs/advanced/jupyter/kernel-execution.qmd
    - id: extensions
      title: "Extensions"
      contents:
        - "---"
        - section: docs/extensions/index.qmd
          contents:
            - text: "Shortcodes & Filters"
              href: docs/extensions/listing-filters.qmd
            - text: "Journal Articles"
              href: docs/extensions/listing-journals.qmd
            - text: "Custom Formats"
              href: docs/extensions/listing-formats.qmd
            - text: "Revealjs Extensions"
              href: docs/extensions/listing-revealjs.qmd
            - text: "Metadata Extensions"
              href: docs/extensions/metadata.qmd
            - docs/extensions/managing.qmd
        - "---"
        - section: docs/extensions/creating.qmd
          contents:
            - text: "Overview"
              href: docs/extensions/creating.qmd
            - docs/extensions/lua.qmd
            - docs/extensions/lua-api.qmd
            - text: "Distribution"
              href: docs/extensions/distributing.qmd
            - "---"
            - text: "Shortcodes"
              href: docs/extensions/shortcodes.qmd
            - text: "Filters"
              href: docs/extensions/filters.qmd
            - section: "Journal Articles"
              href: docs/journals/formats.qmd
              contents:
                - docs/journals/formats.qmd
                - docs/journals/templates.qmd
                - docs/journals/authors.qmd
            - docs/extensions/formats.qmd
            - docs/extensions/revealjs.qmd
            - docs/extensions/project-types.qmd
            - docs/extensions/starter-templates.qmd

    - id: reference
      title: "Reference"
      collapse-level: 3
      contents:
        - section: "Reference"
          href: docs/reference/index.qmd
          contents:
            - section: "Formats"
              contents:
                - text: "HTML"
                  href: docs/reference/formats/html.qmd
                - text: "PDF"
                  href: docs/reference/formats/pdf.qmd
                - text: "MS Word"
                  href: docs/reference/formats/docx.qmd
                - text: Typst
                  href: docs/reference/formats/typst.qmd
                - text: "OpenDocument"
                  href: docs/reference/formats/odt.qmd
                - text: "ePub"
                  href: docs/reference/formats/epub.qmd
                - section: "Presentations"
                  contents:
                    - text: "Revealjs"
                      href: docs/reference/formats/presentations/revealjs.qmd
                    - text: "PowerPoint"
                      href: docs/reference/formats/presentations/pptx.qmd
                    - text: "Beamer"
                      href: docs/reference/formats/presentations/beamer.qmd
                - text: "Dashboards"
                  href: docs/reference/formats/dashboard.qmd
                - section: "Markdown"
                  contents:
                    - text: "GitHub"
                      href: docs/reference/formats/markdown/gfm.qmd
                    - text: "CommonMark"
                      href: docs/reference/formats/markdown/commonmark.qmd
                    - text: "Markua"
                      href: docs/reference/formats/markdown/markua.qmd
                - section: "Wikis"
                  contents:
                    - text: "MediaWiki"
                      href: docs/reference/formats/wiki/mediawiki.qmd
                    - text: "DokuWiki"
                      href: docs/reference/formats/wiki/dokuwiki.qmd
                    - text: "ZimWiki"
                      href: docs/reference/formats/wiki/zimwiki.qmd
                    - text: "Jira Wiki"
                      href: docs/reference/formats/wiki/jira.qmd
                    - text: "XWiki"
                      href: docs/reference/formats/wiki/xwiki.qmd
                - section: "More Formats"
                  contents:
                    - text: "JATS"
                      href: docs/reference/formats/jats.qmd
                    - text: "Jupyter"
                      href: docs/reference/formats/ipynb.qmd
                    - text: "ConTeXt"
                      href: docs/reference/formats/context.qmd
                    - text: "RTF"
                      href: docs/reference/formats/rtf.qmd
                    - text: "reST"
                      href: docs/reference/formats/rst.qmd
                    - text: "AsciiDoc"
                      href: docs/reference/formats/asciidoc.qmd
                    - text: "Org-Mode"
                      href: docs/reference/formats/org.qmd
                    - text: "Muse"
                      href: docs/reference/formats/muse.qmd
                    - text: "GNU TexInfo"
                      href: docs/reference/formats/texinfo.qmd
                    - text: "Groff Man Page"
                      href: docs/reference/formats/man.qmd
                    - text: "Groff Manuscript"
                      href: docs/reference/formats/ms.qmd
                    - text: "Haddock markup"
                      href: docs/reference/formats/haddock.qmd
                    - text: "OPML"
                      href: docs/reference/formats/opml.qmd
                    - text: "Textile"
                      href: docs/reference/formats/textile.qmd
                    - text: "DocBook"
                      href: docs/reference/formats/docbook.qmd
                    - text: "InDesign"
                      href: docs/reference/formats/icml.qmd
                    - text: "TEI Simple"
                      href: docs/reference/formats/tei.qmd
                    - text: "FictionBook"
                      href: docs/reference/formats/fb2.qmd
            - section: "Code Cells"
              href: docs/reference/cells/index.qmd
              contents:
                - text: "Jupyter"
                  href: docs/reference/cells/cells-jupyter.qmd
                - text: "Knitr"
                  href: docs/reference/cells/cells-knitr.qmd
                - text: "Observable"
                  href: docs/reference/cells/cells-ojs.qmd
            - section: "Projects"
              contents:
                - text: "Options"
                  href: docs/reference/projects/options.qmd
                - text: "Websites"
                  href: docs/reference/projects/websites.qmd
                - text: "Books"
                  href: docs/reference/projects/books.qmd
                - text: "Manuscripts"
                  href: docs/reference/projects/manuscripts.qmd
            - section: "More"
              contents:
                - text: "Dates"
                  href: docs/reference/dates.qmd
                - text: "Globs"
                  href: docs/reference/globs.qmd
                - text: "Citations"
                  href: docs/reference/metadata/citation.qmd
                - text: "Cross-References"
                  href: docs/reference/metadata/crossref.qmd
                - text: "Brand"
                  href: docs/reference/metadata/brand.qmd
    - id: prerelease
      title: "Quarto 1.3"
      contents:
        - section: "Highlights"
          href: docs/prerelease/1.3/index.qmd
          contents:
            - text: "Confluence Publishing"
              href: docs/publishing/confluence.qmd
            - text: "Multi-Format"
              href: docs/output-formats/html-multi-format.qmd
            - text: "Cell Embedding"
              href: docs/authoring/notebook-embed.qmd
            - text: "Grid Customization"
              href: docs/output-formats/page-layout.qmd#grid-customization
            - text: "Code Annotation"
              href: docs/authoring/code-annotation.qmd
            - section: "Quarto AST"
              href: docs/prerelease/1.3/ast.qmd
              contents:
                - text: Callouts
                  href: docs/prerelease/1.3/custom-ast-nodes/callout.qmd
                - text: Tabsets
                  href: docs/prerelease/1.3/custom-ast-nodes/tabset.qmd
                - text: Conditional Blocks
                  href: docs/prerelease/1.3/custom-ast-nodes/conditional-block.qmd
            - text: "Mermaid Theming"
              href: docs/authoring/diagrams.qmd#mermaid-theming
            - text: "PDF Images"
              href: docs/prerelease/1.3/pdf.qmd
            - text: "`kbd` Shortcode"
              href: docs/authoring/markdown-basics.qmd#keyboard-shortcuts
    - title: "Quarto 1.4"
      contents:
        - section: "Quarto 1.4 Highlights"
          href: docs/prerelease/1.4/index.qmd
          contents:
            - text: "Manuscripts"
              href: docs/manuscripts/index.qmd
            - text: "Dashboards"
              href: docs/dashboards/index.qmd
            - text: "Typst Format"
              href: docs/output-formats/typst.qmd
            - section: "Cross-References"
              contents:
                - text: Div Syntax
                  href: docs/authoring/cross-references-divs.qmd
                - text: Custom Types
                  href: docs/authoring/cross-references-custom.qmd
                - text: Listings for Executable Code
                  href: docs/authoring/cross-references.qmd#code-listings
                - text: Callouts
                  href: docs/authoring/cross-references.qmd#callouts
                - text: Behind the Scenes
                  href: docs/prerelease/1.4/crossref.qmd
            - text: Shiny for Python
              href: docs/dashboards/interactivity/shiny-python/index.qmd
            - text: Jupyter Inline Execution
              href: docs/computations/inline-code.qmd
            - text: Script Rendering
              href: docs/computations/render-scripts.qmd
            - text: Binder Config
              href: docs/projects/binder.qmd
            - text: Connect Emails
              href: docs/prerelease/1.4/email.qmd
            - text: Cloud Publishing
              href: docs/publishing/posit-cloud.qmd
            - text: Lightbox Images
              href: docs/output-formats/html-lightbox-figures.qmd
            - text: Lua Changes
              href: docs/prerelease/1.4/lua_changes.qmd
            - text: AST Processing
              href: docs/prerelease/1.4/ast.qmd

bibliography: references.bib

format:
  html:
    toc: true
    theme:
      light: [cosmo, theme.scss]
    code-copy: true
    code-overflow: wrap
    css: styles.css
    include-after-body: js.html
    grid:
      sidebar-width: 250px
      body-width: 900px
      margin-width: 300px

filters:
  - filters/tools-tabset.lua
  - filters/color-box.lua

freeze: true

profile:
  group:
    - [rc, prerelease]