|
--- |
|
title: Quarto Template |
|
emoji: 🌖 |
|
colorFrom: green |
|
colorTo: pink |
|
sdk: docker |
|
pinned: false |
|
--- |
|
|
|
To get started working with quarto we recommend you first [install quarto](https://quarto.org/docs/get-started/) locally so that you can render the site without Docker. |
|
We also recommend the [Quarto VS Code Extension](https://marketplace.visualstudio.com/items?itemName=quarto.quarto) which provides syntax highlighting, code completion, a preview button and more. |
|
|
|
The quarto source is located in `src` and you can preview the site with: |
|
|
|
``` |
|
quarto preview src |
|
``` |
|
|
|
A web browser should open up with a live preview of the site. |
|
|
|
## Making changes |
|
|
|
The `src/_quarto.yml` contains the site-level configuration for the quarto website and tells quarto which files to render, and how they should be organized. |
|
For example if you wanted to modify the [site navigation](https://quarto.org/docs/reference/site-navigation.html) you should modify this file. |
|
|
|
Quarto can render markdown, ipynb, and .qmd files, and you can mix formats in a single document. |
|
|
|
## Executing code |
|
|
|
One of the main virtues of Quarto is that it lets you combine code and text in a single document. |
|
By default if you include a code chunk in your document, Quarto will execute that code and include the output in the rendered document. |
|
This is great for reproducibility and for creating documents that are always up-to-date. |
|
|
|
```{python} |
|
import seaborn as sns |
|
import matplotlib.pyplot as plt |
|
|
|
# Sample data |
|
tips = sns.load_dataset("tips") |
|
|
|
# Create a seaborn plot |
|
sns.set_style("whitegrid") |
|
g = sns.lmplot(x="total_bill", y="tip", data=tips, aspect=2) |
|
g = (g.set_axis_labels("Total bill (USD)", "Tip").set(xlim=(0, 60), ylim=(0, 12))) |
|
|
|
plt.title("Tip by Total Bill") |
|
plt.show() |
|
``` |
|
|
