Skip to content

Commit

Permalink
first commit
Browse files Browse the repository at this point in the history
  • Loading branch information
mcanouil committed Jul 31, 2022
0 parents commit bc36229
Show file tree
Hide file tree
Showing 6 changed files with 400 additions and 0 deletions.
23 changes: 23 additions & 0 deletions .github/ISSUE_TEMPLATE/suggestion.yaml
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
43 changes: 43 additions & 0 deletions .github/workflows/lint.yaml
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 }}
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
/.DS_Store
179 changes: 179 additions & 0 deletions README.md
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 [![Awesome](https://awesome.re/badge.svg)](https://awesome.re) [![lint](https://github.com/mcanouil/awesome-quarto/actions/workflows/lint.yaml/badge.svg)](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)
134 changes: 134 additions & 0 deletions code_of_conduct.md
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

Loading

0 comments on commit bc36229

Please sign in to comment.