quarto-extensions/about.qmd at main · mcanouil/quarto-extensions · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
---
title: About
repo-actions: false
image: assets/media/social-card.png
about:
  id: quarto-extensions-about
  template: trestles
  image: assets/media/social-card.png
  links:
    - text: "{{< iconify octicon:mark-github-16 title='GitHub Source Repository' label='GitHub Source Repository' >}} GitHub"
      href: "https://github.com/mcanouil/quarto-extensions"
      aria-label: "GitHub logo linking to mcanouil/quarto-extensions repository"
    - text: "{{< iconify octicon:heart-16 title='Heart Sponsor' label='Heart Sponsor' style='color:#c96198;' >}} Sponsor"
      href: "https://github.com/sponsors/mcanouil?o=esb"
      aria-label: "Heart Sponsor logo linking to mcanouil's GitHub Sponsors page"
    - text: "{{< iconify simple-icons:quarto title='Quarto Documentation' label='Quarto Documentation' >}} Quarto"
      href: "https://quarto.org/"
      aria-label: "Quarto logo linking to quarto.org website"
default-image-extension: ""
---

:::: {#quarto-extensions-about}

## What is this?

This is a listing of [{{< iconify simple-icons:quarto title='Quarto Logo' label='Quarto Logo' >}} Quarto](https://quarto.org) extensions using {{< iconify octicon:mark-github-16 title='GitHub Logo' label='GitHub Logo' >}} GitHub API to retrieve information from the repositories.

## Use with []{.quarto-wizard title="Quarto Wizard Logo" aria-label="Quarto Wizard Logo"} Quarto Wizard

[![Visual Studio Marketplace Downloads](https://img.shields.io/visual-studio-marketplace/d/mcanouil.quarto-wizard?style=flat-square&color=333333&label=Visual%20Studio%20Marketplace)](https://marketplace.visualstudio.com/items?itemName=mcanouil.quarto-wizard)
[![Open VSX Downloads](https://img.shields.io/open-vsx/dt/mcanouil/quarto-wizard?style=flat-square&color=333333&label=Open%20VSX)](https://open-vsx.org/extension/mcanouil/quarto-wizard)
[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/mcanouil/quarto-wizard/total?style=flat-square&color=333333&label=GitHub)](https://github.com/mcanouil/quarto-wizard/releases/latest)

[[]{.quarto-wizard title="Quarto Wizard Logo" aria-label="Quarto Wizard Logo"} Quarto Wizard](https://github.com/mcanouil/quarto-wizard) is a Visual Studio Code extension/Positron/Codium that helps you manage your [{{< iconify simple-icons:quarto title='Quarto Logo' label='Quarto Logo' >}} Quarto](https://quarto.org) projects.
It allows you to easily install Quarto extensions directly from the [Quarto Extensions](https://github.com/mcanouil/quarto-extensions) listing repository.
This extension provides a user-friendly interface to browse, select, and install Quarto extensions, enhancing your Quarto development experience.

:::

## How to submit your extension?

To add your extension to this list, please submit a pull request to this repository by adding your extension repository at the bottom of [`extensions/quarto-extensions.csv`](https://github.com/mcanouil/quarto-extensions/edit/main/extensions/quarto-extensions.csv) following `<owner>/<repository></optional-path>`.

:::: {.callout-important title="Before submitting"}
Please make sure that:

- The extension is not already listed.
- Your GitHub repository contains a **Description**.
  - Avoid special characters/strings in the **Description**, such as `'<style>'` instead of `` `<style>` ``.
- Your GitHub repository contains **Topics**.
- Your GitHub repository contains a **Release** with **Tag**.
- Your GitHub repository has `example.qmd` or `template.qmd` file.
- Your GitHub repository has only one extension or a set of extensions under `_extensions`.

:::

## Extension Status Indicators

Extensions can display status banners to indicate their maintenance or development state.
Add one of the following topics to your GitHub repository to display a status banner:

- [{{< iconify bi:exclamation-triangle-fill >}} superseded]{.alert .alert-warning .mb-0 .rounded-0 .text-center .py-1 role="alert"} - For extensions that have been replaced by a newer version or alternative.
- [{{< iconify bi:exclamation-triangle-fill >}} deprecated]{.alert .alert-warning .mb-0 .rounded-0 .text-center .py-1 role="alert"} - For extensions that are outdated and should not be used in new projects.
- [{{< iconify bi:archive-fill >}} archived]{.alert .alert-secondary .mb-0 .rounded-0 .text-center .py-1 role="alert"} - For extensions that are no longer actively maintained.
- [{{< iconify bi:flask >}} experimental]{.alert .alert-info .mb-0 .rounded-0 .text-center .py-1 role="alert"} - For extensions that are in early development or testing phase.
- [{{< iconify bi:check-circle-fill >}} stable]{.alert .alert-success .mb-0 .rounded-0 .text-center .py-1 role="alert"} - For extensions that are production-ready and actively maintained.

If multiple status topics are present, the priority order is: `superseded` > `deprecated` > `archived` > `experimental` > `stable`.

## Disclaimer

This project is an independent community resource and is not affiliated with or endorsed by Quarto or its maintainers.

## Support

If you find this project helpful, please consider [sponsoring it](https://github.com/sponsors/mcanouil?o=esb) to support ongoing development and maintenance.