forked from mcanouil/awesome-quarto
-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit bc36229
Showing
6 changed files
with
400 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
name: Suggestion | ||
description: Help us improve with suggestions | ||
body: | ||
- type: markdown | ||
attributes: | ||
value: | | ||
Thanks for taking the time to fill out this suggestion form! | ||
- type: input | ||
id: suggestion | ||
attributes: | ||
label: Link to suggestion | ||
description: Please share a link to your suggestion | ||
placeholder: https://... | ||
validations: | ||
required: true | ||
- type: textarea | ||
id: description | ||
attributes: | ||
label: Describe your suggestion | ||
description: How and why is your suggestion useful to this community? | ||
placeholder: I wish to see tool <xyz> here because it is used for... | ||
validations: | ||
required: true |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,43 @@ | ||
name: lint | ||
on: | ||
pull_request: | ||
push: | ||
branches: | ||
- main | ||
|
||
jobs: | ||
awesome-lint: | ||
strategy: | ||
fail-fast: false | ||
matrix: | ||
files: "README.md" | ||
runs-on: ubuntu-latest | ||
steps: | ||
- name: "checkout repo" | ||
uses: actions/checkout@v3 | ||
with: | ||
fetch-depth: 0 | ||
- name: asdf_install | ||
uses: asdf-vm/actions/install@v1 | ||
- name: "linting: ${{ matrix.files }}" | ||
run: npx -y awesome-lint ${{ matrix.files }} | ||
awesome-bot: | ||
strategy: | ||
fail-fast: false | ||
matrix: | ||
files: "README.md" | ||
runs-on: ubuntu-latest | ||
steps: | ||
- name: "checkout repo" | ||
uses: actions/checkout@v3 | ||
with: | ||
fetch-depth: 0 | ||
- name: "setup ruby" | ||
uses: ruby/setup-ruby@v1 | ||
with: | ||
ruby-version: 3.0.1 | ||
bundler-cache: true | ||
- name: "install awesome-bot" | ||
run: gem install awesome_bot | ||
- name: "linting: ${{ matrix.files }}" | ||
run: awesome_bot --allow-redirect ${{ matrix.files }} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1 @@ | ||
/.DS_Store |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,179 @@ | ||
<div align="center"> | ||
|
||
<!-- title --> | ||
|
||
<!--lint ignore no-dead-urls--> | ||
|
||
# Awesome Quarto [](https://awesome.re) [](https://github.com/mcanouil/awesome-quarto/actions/workflows/lint.yaml) <!-- omit in toc --> | ||
|
||
<!-- subtitle --> | ||
|
||
## The most up to date list of [Quarto®](https://quarto.org) docs, talks, tools, examples & articles the internet has to offer. <!-- omit in toc --> | ||
|
||
<!-- image --> | ||
|
||
<a href="" target="_blank" rel="noopener noreferrer"> | ||
<img src="https://quarto.org/quarto.png" alt-text="Quarto logo with text, which is a filled circle splitted in four with quarto as text on the right in lower case and the trademark symbol in superscrit at the end."/> | ||
</a> | ||
|
||
<!-- description --> | ||
|
||
> [Quarto®](https://quarto.org) is an open-source scientific and technical publishing system built on [Pandoc]([Pandoc](https://pandoc.org/)). | ||
> - Create dynamic content with [Python](https://quarto.org/docs/computations/python.html), [R](https://quarto.org/docs/computations/r.html), [Julia](https://quarto.org/docs/computations/julia.html), and [Observable](https://quarto.org/docs/computations/ojs.html). | ||
> - Author documents as plain text markdown or [Jupyter](https://jupyter.org/) notebooks. | ||
> - Publish high-quality articles, reports, presentations, websites, blogs, and books in HTML, PDF, MS Word, ePub, and more. | ||
> - Author with scientific markdown, including equations, citations, crossrefs, figure panels, callouts, advanced layout, and more. | ||
</div> | ||
|
||
--- | ||
|
||
<!-- TOC --> | ||
|
||
## Contents <!-- omit in toc --> | ||
|
||
- [Featured (new releases)](#featured-new-releases) | ||
- [Official documentation & quickstarts](#official-documentation--quickstarts) | ||
- [Turorials & workshops](#turorials--workshops) | ||
- [Supported editors/software](#supported-editorssoftware) | ||
- [Extensions](#extensions) | ||
- [Templates](#templates) | ||
- [Journals](#journals) | ||
- [Presentations](#presentations) | ||
- [Blog posts](#blog-posts) | ||
- [Talks and videos](#talks-and-videos) | ||
- [Real life examples](#real-life-examples) | ||
- [Presentations](#presentations-1) | ||
- [Websites](#websites) | ||
- [Book](#book) | ||
- [Follow](#follow) | ||
- [Official](#official) | ||
- [Community](#community) | ||
- [Contributing[^1]](#contributing1) | ||
|
||
--- | ||
|
||
<!-- CONTENT --> | ||
|
||
## Featured (new releases) | ||
|
||
## Official documentation & quickstarts | ||
|
||
- [Documentation: Quarto documentation](https://quarto.org/) - Official Quarto Documentation. | ||
- [GitHub: Quarto GitHub repository](https://github.com/quarto-dev) - Official Quarto GitHub repository. | ||
- [Tutorial: Hello, Quarto](https://quarto.org/docs/get-started/hello/) - Official "Hello, Quarto" tutorial. | ||
- [Tutorial: Computations](https://quarto.org/docs/get-started/computations/) - Official "Computations" tutorial. | ||
- [Tutorial: Authoring](https://quarto.org/docs/get-started/authoring/) - Official "Authoring" tutorial. | ||
|
||
## Turorials & workshops | ||
|
||
- [Making shareable docs with Quarto](https://openscapes.github.io/quarto-website-tutorial/) - A tutorial to make website with Quarto. | ||
|
||
## Supported editors/software | ||
|
||
- [Emacs](https://github.com/quarto-dev/quarto-emacs) - [Emacs](https://www.gnu.org/software/emacs/) mode for Quarto. | ||
- [Julia](https://github.com/quarto-dev/quarto-julia) - [Julua](https://julialang.org/) interface package to Quarto CLI. | ||
- [Neovim](https://github.com/quarto-dev/quarto-nvim) - [Neovim](https://neovim.io/) tools to work with Quarto. | ||
- [Python](https://github.com/quarto-dev/quarto-python) - [Python](https://www.python.org/) interface package to Quarto CLI. | ||
- [R](https://github.com/quarto-dev/quarto-r) - [R](https://www.r-project.org/) interface package to Quarto CLI. | ||
- [Sublime Text](https://github.com/quarto-dev/quarto-sublime) - [Sublime Text](https://www.sublimetext.com/) plugin to work with Quarto. | ||
- [Vim](https://github.com/quarto-dev/quarto-vim) - [Vim](https://www.vim.org/) plugin to work with Quarto. | ||
- [Visual Studio Code](https://github.com/quarto-dev/quarto-vscode) - [Visual Studio Code](https://code.visualstudio.com/) extension for Quarto. | ||
|
||
|
||
## Extensions | ||
|
||
<!-- - [Apple](https://apple.com) - Apple as a placeholder. --> | ||
- [code-filename](https://github.com/quarto-ext/code-filename) - An extension that enables you to add a `filename` attribute to code blocks, which is useful if you are documenting the contents of a file and want to be especially clear about the name of the file the code is associated with. | ||
- [fancy-text](https://github.com/quarto-ext/fancy-text) - A very simple shortcode extension that adds shortcodes for outputing nicely formatted versions of fancy strings (such as LaTeX and BibTeX). | ||
- [fontawesome](https://github.com/quarto-ext/fontawesome) - This extension provides support including free icons provided by [Font Awesome](https://fontawesome.com). | ||
- [grouped-tabsets](https://github.com/quarto-ext/grouped-tabsets) - This extension provides support for "grouped" tabsets (*HTML-based format only*). | ||
- [latex-environment](https://github.com/quarto-ext/latex-environment) - This extension enables `divs` to be output as a custom environment in LaTeX. | ||
- [lightbox](https://github.com/quarto-ext/lightbox) - An extension that uses the [GLightbox](https://biati-digital.github.io/glightbox/) javascript library to add lightbox styling and behavior to images (*HTML-based format only*). | ||
- [lordicon](https://github.com/jmgirard/lordicon) - This extension provides support for | ||
[Lordicon](https://lordicon.com/) icons library (*HTML-based format only*). | ||
- [academicons](https://github.com/schochastics/academicons) - This extension provides support for | ||
[academicons](https://jpswalsh.github.io/academicons/) icons library (*HTML-based format only*). | ||
|
||
## Templates | ||
|
||
### Journals | ||
|
||
<!-- - [Microsoft](https://www.microsoft.com/) - Microsoft as an example. --> | ||
- [acm](https://github.com/quarto-journals/acm) - Template for *Association of Computing Machinery*. | ||
- [acs](https://github.com/quarto-journals/acs) - Template for *American Chemical Society*. | ||
- [biophysical-journal](https://github.com/quarto-journals/biophysical-journal) - Template for *Biophysical journal*. | ||
- [elsevier](https://github.com/quarto-journals/elsevier) - Template for *Elsevier Journals*. | ||
- [jasa](https://github.com/quarto-journals/jasa) - Template for *American Statistical Association Journals*. | ||
- [jss](https://github.com/quarto-journals/jss) - Template for *Journal of Statistical Software*. | ||
- [plos](https://github.com/quarto-journals/plos) - Template for *Public Library of Science*. | ||
|
||
### Presentations | ||
|
||
<!-- - [Microsoft](https://www.microsoft.com/) - Microsoft as an example. --> | ||
- [quarto-revealjs-storybook](https://github.com/mcanouil/quarto-revealjs-storybook) - A medieval like template for Quarto `revealjs` format. | ||
- [quarto-revealjs-coeos](https://github.com/mcanouil/quarto-revealjs-coeos) - A dark grey / white based template for Quarto `revealjs` format. | ||
- [quarto-rladies-theme](https://github.com/beatrizmilz/quarto-rladies-theme) - R-Ladies (@rladies) template for Quarto `revealjs` format. | ||
- [onyxia-quarto](https://github.com/RLesur/onyxia-quarto) - [Onyxia](https://github.com/InseeFrLab/onyxia) template for Quarto `revealjs` format. | ||
|
||
## Blog posts | ||
|
||
- [Quarto tip a day](https://mine-cetinkaya-rundel.github.io/quarto-tip-a-day/) - A website made with Quarto highlighting a tip for Quarto every day as a blog post. | ||
|
||
## Talks and videos | ||
|
||
## Real life examples | ||
|
||
### Presentations | ||
|
||
<!-- - []() - See slides [here](). --> | ||
- [Advanced Introduction to R (French)](https://m.canouil.fr/radvanced/) - See slides [here](https://github.com/mcanouil/radvanced)). | ||
- [Streamlining with R](https://github.com/meghall06/personal-website/blob/master/static/slides/NEAIR/NEAIR.qmd) - See slides [here](https://meghan.rbind.io/slides/neair/neair.html). | ||
- [An educator's perspective of the tidyverse](https://github.com/mine-cetinkaya-rundel/tidyperspective/blob/main/talks/dagstat-2022.qmd) - See slides [here](https://mine-cetinkaya-rundel.github.io/tidyperspective/talks/dagstat-2022.html). | ||
- [An anthology of experimental designs](https://github.com/emitanaka/talks/tree/master/Toronto2022) - See slides [here](https://emitanaka.org/slides/toronto2022/). | ||
- [The untold story of palmerpenguins](https://github.com/apreshill/palmerpenguins-useR-2022) - See slides [here](https://apreshill.github.io/palmerpenguins-useR-2022/). | ||
- [Outrageously efficient EDA](https://github.com/jthomasmock/arrow-dplyr) - See slides [here](https://jthomasmock.github.io/arrow-dplyr/). | ||
- [Improvements in textrecipes](https://github.com/emilhvitfeldt/useR2022-textrecipes/) - See slides [here](https://emilhvitfeldt.github.io/useR2022-textrecipes/). | ||
|
||
### Websites | ||
|
||
- [quarto.org](https://github.com/quarto-dev/quarto-web) - The Quarto documentation website. | ||
- [rlille.fr](https://github.com/RLille/rlille.fr) - The R Lille (R User Group) website using Quarto. | ||
- [R-Manuals](https://github.com/rstudio/r-manuals) - R Manuals rewritten with Quarto. | ||
- [Quarto tip a day](https://github.com/mine-cetinkaya-rundel/quarto-tip-a-day) - Website/blog highlighting a tip for Quarto every day. | ||
- [Making shareable docs with Quarto](https://github.com/openscapes/quarto-website-tutorial) - A tutorial to make website with Quarto (see <https://openscapes.github.io/quarto-website-tutorial/>). | ||
|
||
### Book | ||
|
||
- [R for Data Science, 2E](https://github.com/hadley/r4ds/) - "R for Data Science" book second edition (see <https://r4ds.hadley.nz/>). | ||
- [R Packages, 2E](https://github.com/hadley/r-pkgs/) - "R Packages" book second edition (see <https://r-pkgs.org/>). | ||
- [mlr3book](https://github.com/mlr-org/mlr3book/tree/main/book/) - Book on the [`ml3r`](https://mlr3.mlr-org.com/) packages ecosystem (see <https://mlr3book.mlr-org.com/>). | ||
|
||
<!-- ### Other formats --> | ||
|
||
<!-- END CONTENT --> | ||
|
||
## Follow | ||
|
||
<!-- list people worth following on social sites (Twitter, LinkedIn, GitHub, YouTube etc.) --> | ||
|
||
### Official | ||
|
||
- [@quarto-dev](https://github.com/quarto-dev) - GitHub organisation containing Quarto CLI, IDE plugins/extension, etc. | ||
- [@quarto-ext](https://github.com/quarto-ext) - GitHub organisation containing extensions developed/maintained by Quarto's team. | ||
- [@quarto-journals](https://github.com/quarto-journals) - GitHub organisation containing journals templates developed/maintained by Quarto's team. | ||
- [J.J. Allaire (\@jjallaire)](https://github.com/jjallaire/) - Member of Quarto's core team. | ||
- [Christophe Dervieux (\@cderv)](https://github.com/cderv) - Member of Quarto's core team. | ||
- [Carlos Scheidegger (\@cscheid)](https://github.com/cscheid) - Member of Quarto's core team. | ||
- [Charles Teague (\@dragonstyle)](https://github.com/dragonstyle) - Member of Quarto's core team. | ||
- [Yihui Xie (\@yihui)](https://github.com/yihui) - Member of Quarto's core team. | ||
|
||
### Community | ||
|
||
*Who else should we be following!?* | ||
|
||
### Contributing[^1] | ||
|
||
[Thanks goes to these contributors!](https://github.com/mcanouil/awesome-quarto/graphs/contributors) | ||
|
||
[^1]: [Contributions of any kind welcome, just follow the guidelines!](contributing.md) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,134 @@ | ||
|
||
# Contributor Covenant Code of Conduct | ||
|
||
## Our Pledge | ||
|
||
We as members, contributors, and leaders pledge to make participation in our | ||
community a harassment-free experience for everyone, regardless of age, body | ||
size, visible or invisible disability, ethnicity, sex characteristics, gender | ||
identity and expression, level of experience, education, socio-economic status, | ||
nationality, personal appearance, race, caste, color, religion, or sexual identity | ||
and orientation. | ||
|
||
We pledge to act and interact in ways that contribute to an open, welcoming, | ||
diverse, inclusive, and healthy community. | ||
|
||
## Our Standards | ||
|
||
Examples of behavior that contributes to a positive environment for our | ||
community include: | ||
|
||
* Demonstrating empathy and kindness toward other people | ||
* Being respectful of differing opinions, viewpoints, and experiences | ||
* Giving and gracefully accepting constructive feedback | ||
* Accepting responsibility and apologizing to those affected by our mistakes, | ||
and learning from the experience | ||
* Focusing on what is best not just for us as individuals, but for the | ||
overall community | ||
|
||
Examples of unacceptable behavior include: | ||
|
||
* The use of sexualized language or imagery, and sexual attention or | ||
advances of any kind | ||
* Trolling, insulting or derogatory comments, and personal or political attacks | ||
* Public or private harassment | ||
* Publishing others' private information, such as a physical or email | ||
address, without their explicit permission | ||
* Other conduct which could reasonably be considered inappropriate in a | ||
professional setting | ||
|
||
## Enforcement Responsibilities | ||
|
||
Community leaders are responsible for clarifying and enforcing our standards of | ||
acceptable behavior and will take appropriate and fair corrective action in | ||
response to any behavior that they deem inappropriate, threatening, offensive, | ||
or harmful. | ||
|
||
Community leaders have the right and responsibility to remove, edit, or reject | ||
comments, commits, code, wiki edits, issues, and other contributions that are | ||
not aligned to this Code of Conduct, and will communicate reasons for moderation | ||
decisions when appropriate. | ||
|
||
## Scope | ||
|
||
This Code of Conduct applies within all community spaces, and also applies when | ||
an individual is officially representing the community in public spaces. | ||
Examples of representing our community include using an official e-mail address, | ||
posting via an official social media account, or acting as an appointed | ||
representative at an online or offline event. | ||
|
||
## Enforcement | ||
|
||
Instances of abusive, harassing, or otherwise unacceptable behavior may be | ||
reported to the community leaders responsible for enforcement at | ||
[INSERT CONTACT METHOD]. | ||
All complaints will be reviewed and investigated promptly and fairly. | ||
|
||
All community leaders are obligated to respect the privacy and security of the | ||
reporter of any incident. | ||
|
||
## Enforcement Guidelines | ||
|
||
Community leaders will follow these Community Impact Guidelines in determining | ||
the consequences for any action they deem in violation of this Code of Conduct: | ||
|
||
### 1. Correction | ||
|
||
**Community Impact**: Use of inappropriate language or other behavior deemed | ||
unprofessional or unwelcome in the community. | ||
|
||
**Consequence**: A private, written warning from community leaders, providing | ||
clarity around the nature of the violation and an explanation of why the | ||
behavior was inappropriate. A public apology may be requested. | ||
|
||
### 2. Warning | ||
|
||
**Community Impact**: A violation through a single incident or series | ||
of actions. | ||
|
||
**Consequence**: A warning with consequences for continued behavior. No | ||
interaction with the people involved, including unsolicited interaction with | ||
those enforcing the Code of Conduct, for a specified period of time. This | ||
includes avoiding interactions in community spaces as well as external channels | ||
like social media. Violating these terms may lead to a temporary or | ||
permanent ban. | ||
|
||
### 3. Temporary Ban | ||
|
||
**Community Impact**: A serious violation of community standards, including | ||
sustained inappropriate behavior. | ||
|
||
**Consequence**: A temporary ban from any sort of interaction or public | ||
communication with the community for a specified period of time. No public or | ||
private interaction with the people involved, including unsolicited interaction | ||
with those enforcing the Code of Conduct, is allowed during this period. | ||
Violating these terms may lead to a permanent ban. | ||
|
||
### 4. Permanent Ban | ||
|
||
**Community Impact**: Demonstrating a pattern of violation of community | ||
standards, including sustained inappropriate behavior, harassment of an | ||
individual, or aggression toward or disparagement of classes of individuals. | ||
|
||
**Consequence**: A permanent ban from any sort of public interaction within | ||
the community. | ||
|
||
## Attribution | ||
|
||
This Code of Conduct is adapted from the [Contributor Covenant][homepage], | ||
version 2.0, available at | ||
[https://www.contributor-covenant.org/version/2/0/code_of_conduct.html][v2.0]. | ||
|
||
Community Impact Guidelines were inspired by | ||
[Mozilla's code of conduct enforcement ladder][Mozilla CoC]. | ||
|
||
For answers to common questions about this code of conduct, see the FAQ at | ||
[https://www.contributor-covenant.org/faq][FAQ]. Translations are available | ||
at [https://www.contributor-covenant.org/translations][translations]. | ||
|
||
[homepage]: https://www.contributor-covenant.org | ||
[v2.0]: https://www.contributor-covenant.org/version/2/0/code_of_conduct.html | ||
[Mozilla CoC]: https://github.com/mozilla/diversity | ||
[FAQ]: https://www.contributor-covenant.org/faq | ||
[translations]: https://www.contributor-covenant.org/translations | ||
|
Oops, something went wrong.