_quarto-workbench.yml

project:
  output-dir: _site-workbench
  render:
    - "!licensing.qmd"
    - "!privacy.qmd"
    - "!download.qmd"
    - "!install.qmd"
    - "!updating.qmd"
    - "!remote-ssh.qmd"
    - "!dev-containers.qmd"
    - "!add-to-path.qmd"
    - "!education.qmd"
  resources:
    - _redirects
    - "!videos/**"

website:
  open-graph: true
  bread-crumbs: true
  page-navigation: true
  favicon: "images/favicon.svg"
  image: "images/positron-social.png"
  search:
    copy-button: true
    show-item-context: true
    keyboard-shortcut: ["?", "H"]

  page-footer:
    left:
      - text: "<img class='posit-footer-logo' alt='Posit' src='/images/posit-logo-black-TM.svg'>Copyright &copy; 2022-2026 Posit Software, PBC. All Rights Reserved."
        href: "https://posit.co/"
    center: "Positron {{< env RELEASE_VERSION >}}"
    right:
      - text: "Support"
        href: "https://support.posit.co/"
      - text: "User Guide"
        href: "https://docs.posit.co/ide/server-pro/user/"
      - text: "Admin Guide"
        href: "https://docs.posit.co/ide/server-pro/admin/"
      - text: "Privacy Policy"
        aria-label: "Link to Privacy Policy"
        href: "https://posit.co/about/privacy-policy/"

  navbar:
    pinned: true
    logo: "assets/images/positron-logo_fullcolor-TM.png"
    logo-alt: "Positron Documentation"
    title: false

    left:
      - text: "Features"
        href: features.qmd
      - text: "Guides"
        href: welcome.qmd
      - text: "Help"
        href: troubleshooting.qmd
      - text: "About"
        href: about.qmd
      - text: "Resources"
        menu:
          - text: "Sign up for updates"
            href: https://posit.co/positron-updates-signup/
            target: _blank
            icon: envelope
          - text: "Positron at Posit Open Source"
            icon: code-slash
            href: https://opensource.posit.co/blog/q/positron/
            target: _blank  
          - text: "Company Blog Posts"
            icon: box-arrow-up-right
            href: https://posit.co/blog/?post_tag=positron  
            target: _blank
          - text: "Events"
            icon: calendar-event
            href: https://posit.co/events/?search=positron&poststatus=all
            target: _blank
      
    right:
      - icon: github
        aria-label: 'Link to Positron Github Repository'
        href: https://github.com/posit-dev/positron
    
  sidebar:
    - title: "Guides"
      style: "docked"
      contents:
        - section: "Getting Started"
          href: welcome.qmd
        - section: "Configuration"
          contents:
            - keyboard-shortcuts.qmd
            - git.qmd
            - extensions.qmd
            - folder-templates.qmd
        - section: "User Interface"
          href: layout.qmd
          contents:
            - layout.qmd
            - command-palette.qmd
            - action-bars.qmd
            - help-pane.qmd
        - section: "AI Tools"
          contents:
            - section: "Positron Assistant"
              href: assistant.qmd
              contents:
              - text: "Overview"
                href: assistant.qmd
              - assistant-getting-started.qmd
              - section: "Chat"
                href: assistant-chat.qmd
                contents:
                  - text: "Overview"
                    href: assistant-chat.qmd
                  - href: assistant-chat-agents.qmd
                  - href: assistant-chat-context.qmd
                  - href: assistant-chat-commands-participants.qmd
                  - href: assistant-chat-instructions.qmd
              - assistant-completions.qmd
              - assistant-troubleshooting.qmd
              - assistant-tips.qmd
              - assistant-provider-info.qmd
            - databot.qmd
        - section: "Language Guides"
          href: language-guides.qmd
          contents:
            - text: "Overview"
              href: language-guides.qmd
            - guide-python.qmd
            - section: "R in Positron"
              href: guide-r.qmd
              contents:
              - guide-r.qmd
              - guide-r-debugging.qmd
              - guide-r-air.qmd
        - section: "Data Analysis"
          contents:
            - section: "Data Explorer"
              href: data-explorer.qmd
              contents:
              - text: "Overview"
                href: data-explorer.qmd
              - data-explorer-data-grid.qmd
              - data-explorer-filter-bar.qmd
              - data-explorer-summary-panel.qmd
            - variables-pane.qmd
            - plots-pane.qmd
        - section: "Database Connections"
          contents:
            - connections-pane.qmd
            - extending-connections.qmd 
            - catalog-explorer.qmd
        - section: "Dynamic Documents and Apps"
          contents:
            - quarto.qmd
            - section: "Jupyter Notebooks"
              href: jupyter-notebooks.qmd
              contents:
                - text: "Overview"
                  href: jupyter-notebooks.qmd
                - positron-notebook-editor.qmd
                - legacy-notebook-editor.qmd
            - develop-data-apps.qmd
            - publish-to-connect.qmd
        - section: "Interpreters"
          contents:
            - managing-interpreters.qmd
            - interpreter-startup.qmd
            - packages-pane.qmd
            - section: "Language-Specific Setup"
              contents:
                - python-installations.qmd
                - r-installations.qmd
                - reticulate.qmd
                - environment-modules.qmd
        - section: "Migration Guides"
          contents:
          - text: "Migrating from VS Code"
            href: migrate-vscode.qmd
          - section: "Migrating from RStudio"
            contents:
            - migrate-rstudio.qmd
            - migrate-rstudio-keybindings.qmd
            - migrate-rstudio-settings-and-extensions.qmd
            - migrate-rstudio-snippets.qmd
            - migrate-rstudio-rproj.qmd
            - migrate-rstudio-compare.qmd
        - section: "Extending Positron"  
          contents:
          - extension-development.qmd
    - title: "Help"
      style: "docked"
      contents:
        - troubleshooting.qmd
        - faqs.qmd
        - feedback.qmd
    - title: "About"
      style: "docked"
      contents:
        - about.qmd
        - release-notes.qmd

format:
  html:
    theme:
      - css/theme.scss
      - css/theme-workbench.scss
    highlight-style:
      light: github
    lightbox: true
    code-copy: true
    toc: true
    toc-expand: true

show-videos: false

filters:
  - quarto
  - video-filter