From 9e549c744757591e7a1fdc1d9b6f9cacfa130e55 Mon Sep 17 00:00:00 2001 From: Charlotte Wickham Date: Fri, 10 May 2024 09:17:57 -0700 Subject: [PATCH] Update to 1.4 --- _freeze/html/quarto/execute-results/html.json | 4 ++-- html/quarto.qmd | 16 ++++------------ 2 files changed, 6 insertions(+), 14 deletions(-) diff --git a/_freeze/html/quarto/execute-results/html.json b/_freeze/html/quarto/execute-results/html.json index 8f07e213..8dd091c9 100644 --- a/_freeze/html/quarto/execute-results/html.json +++ b/_freeze/html/quarto/execute-results/html.json @@ -1,8 +1,8 @@ { - "hash": "660b0b601b02de2dff193236e3f1255d", + "hash": "717a4199481932ecc2b305795a4fa3b8", "result": { "engine": "knitr", - "markdown": "---\ntitle: \"Publish and Share with Quarto :: Cheatsheet\"\ndescription: \"QMD Edition\"\nimage-alt: \"\"\nengine: knitr\nexecute:\n eval: true\n output: false\n warning: false\ncode-overflow: wrap\n---\n\n\n\n::: column-margin\n\n\n```{=html}\n\"Hex\n

\n```\n\n\n:::\n\n\n\n::: {.cell .column-margin}\n\n

Download PDF

\n\"\"/\n\n

\n:::\n\n\n\n## Overview\n\n![](images/quarto-illustration.png){fig-alt=\"A schematic representing the multi-language input (e.g. Python, R, Observable, Julia) and multi-format output (e.g. PDF, html, Word documents, and more) versatility of Quarto.\"}[^1]\n\n[^1]: Artwork from \"Hello, Quarto\" keynote by Julia Lowndes and Mine Çetinkaya-Rundel, presented at RStudio Conference 2022.\n Illustrated by [Allison Horst](https://allisonhorst.com/allison-horst).\n\n- **Author**: Write and code in plain text.\n Author documents as .qmd files, or Jupyter notebooks.\n Write in a rich Markdown syntax.\n\n- **Render**: Generate documents, presentations and more.\n Produce HTML, PDF, MS Word, reveal.js, MS Powerpoint, Beamer, websites, blogs, books...\n\n- **Share**: Share your work with the world.\n Quickly deploy to GitHub Pages, Netlify, Quarto Pub, Posit Cloud, or Posit Connect.\n\n### Get Quarto\n\nGet Quarto from: \n\nOr, use version **bundled with RStudio.**\n\n### Get Started\n\n\n\n## Author\n\n### Source File: hello.qmd\n\n```` markdown\n---\ntitle: \"Hello, Penguins\"\nformat: html\nexecute:\n echo: false\n---\n\n## Meet the penguins\n\nThe `penguins` data contains size measurements for \npenguins from three islands in the Palmer Archipelago, \nAntarctica.\n\nThe three species of penguins have quite distinct \ndistributions of physical dimensions (@fig-penguins).\n\n```{{r}}\n#| label: fig-penguins\n#| fig-cap: \"Dimensions of penguins across three species.\"\n#| warning: false\nlibrary(tidyverse, quietly = TRUE)\nlibrary(palmerpenguins)\npenguins |>\n ggplot(aes(x = flipper_length_mm, y = bill_length_mm)) +\n geom_point(aes(color = species)) +\n scale_color_manual(\n values = c(\"darkorange\", \"purple\", \"cyan4\")) +\n theme_minimal()\n```\n````\n\n### Highlights in the source file\n\n- Set format(s) and options.\n Use YAML Syntax.\n\n ``` markdown\n ---\n title: \"Hello, Penguins\"\n format: html\n execute:\n echo: false\n ---\n ```\n\n- `## Write with **Markdown**`\n\n **RStudio**: Help \\> Markdown Quick Reference\n\n RStudio & VS Code: Use the **Visual Editor**\n\n ``` markdown\n ## Meet the penguins\n\n The `penguins` data contains size measurements for \n penguins from three islands in the Palmer Archipelago, \n Antarctica.\n\n The three species of penguins have quite distinct \n distributions of physical dimensions (@fig-penguins).\n ```\n\n- Include code.\n R, Python, Julia, Observable, or any language with a Jupyter kernel.\n\n ```` markdown\n ```{{r}}\n #| label: fig-penguins\n #| fig-cap: \"Dimensions of penguins across three species.\"\n #| warning: false\n library(tidyverse, quietly = TRUE)\n library(palmerpenguins)\n penguins |>\n ggplot(aes(x = flipper_length_mm, y = bill_length_mm)) +\n geom_point(aes(color = species)) +\n scale_color_manual(\n values = c(\"darkorange\", \"purple\", \"cyan4\")) +\n theme_minimal()\n ```\n ````\n\n### Use a tool with a rich authoring experience\n\n[RStudio](https://posit.co/products/open-source/rstudio/), or\\\n[Visual Studio Code](https://code.visualstudio.com/) + [Quarto extension](https://marketplace.visualstudio.com/items?itemName=quarto.quarto)\n\n- **Run** code cells as you write\n\n- **Render** with a button or keyboard shortcut\n\n- Edit Quarto documents with a **Visual Editor**\n\n ![](images/quarto-visual-editor.png){fig-alt=\"Screenshot of the Visual Editor toolbar. Toolbar shows menu items: Normal with dropdown, bold, italics, code, bulleted list, numbered list, link, image, Format dropdown, Insert dropdown and Table dropdown.\"}\n\n - Apply formatting in Visual Editor.\n Saved as Markdown in source.\n\n - Insert elements like code cells, cross references, and more.\n\n### Or any text editor\n\nQuarto documents (.qmd) can be edited in any tool that edits text.\n\n## Render\n\n**Save,** then render to **preview** the document output.\n\n``` {.bash filename=\"Terminal\"}\nquarto preview hello.qmd\n```\n\nRStudio: Use **Render** button ![](images/quarto-render-button.png){fig-alt=\"Icon from the Render button in RStudio\" height=\"1.5em\"}\n\nVS Code: Use **Preview** button ![](images/quarto-preview-button.svg){fig-alt=\"Icon from the Preview button in VS Code\"}\n\nThe resulting HTML/PDF/MS Word/etc.\ndocument will be created and saved in the same directory as the source .qmd file.\n\n### Rendered output: hello.html\n\n![](images/quarto-rendered-output.png){fig-alt=\"Screenshot of a webpage with the title 'Hello, Penguins'. There is a subheading 'Meet the penguins' followed by a paragraph of text including a link to 'Figure 1', then a scatterplot.\"}\n\n### Highlights in the rendered output\n\n- Features for scientific publishing.\n Cross references, citations, equations, and more.\n\n- Output integrated into document.\n Control how output appears with special comments in your code.\n\n### Behind the Scenes\n\nWhen you render a document, Quarto:\n\n1. Runs the code and embeds results and text into an .md file with:\n - **Knitr**, if any `{r}` cells, or\n - **Jupyter**, if any other cells.\n2. Converts the .md file into the output format with Pandoc.\n\n## Publish\n\n``` {.bash filename=\"Terminal\"}\nquarto publish {venue} hello.qmd\n```\n\n`{venue}`: quarto-pub, connect, gh-pages, netlify, confluence, (*v1.4*) posit-cloud\n\nRStudio: Use **Publish** button ![](images/quarto-rstudio-publish.png){fig-alt=\"Publish button icon in RStudio\" width=\"10%\"}\n\n- [**Quarto Pub**](https://quartopub.com/) Free publishing service for Quarto content.\n\n- [**Posit Cloud**](https://posit.cloud/) Cloud-hosted, control access to project and output.\n ![](images/quarto-rstudio-publish.png){fig-alt=\"Push button publishing from RStudio\" width=\"10%\"}\n\n- [**Posit Connect**](https://posit.co/products/enterprise/connect/) Org-hosted, control access, schedule updates.\n ![](images/quarto-rstudio-publish.png){fig-alt=\"Push button publishing from RStudio\" width=\"10%\"}\n\n## Quarto Projects\n\n### Create websites, books and more\n\nA directory of Quarto documents + a configuration file (`_quarto.yml`)\n\nSee examples at: \n\nGet started from the command line:\n\n``` {.bash filename=\"Terminal\"}\nquarto create project {type}\n```\n\n`{type}`: default, website, blog, book, confluence, (*v1.4*) manuscript\n\nRStudio: Use **File** \\> **New Project**\n\n## Include Code\n\n### Code Cells\n\nCode cells start with ```` ```{language} ````, and end with ```` ``` ````.\n\nRStudio & VS Code: Use **Insert Code Chunk/Cell**.\n\n::: {layout-ncol=\"2\"}\n```{{r}}\n#| label: chunk-id\n```\n\n```{{python}}\n#| label: chunk-id\n```\n:::\n\nOther languages: `{julia}`, `{ojs}`\n\nAdd code cell options with `#|` comments.\n\nCell options control [**execution**](#execution), [figures](#figures), [tables](#tables), layout and more.\nSee them all at: \n\n### Execution Options {#execution}\n\n+-----------+-----------+----------------------------------------------------------+\n| Option | Default | Effects |\n+===========+===========+==========================================================+\n| `echo` | `true` | `false`: hide code in output\\ |\n| | | `fenced`: include code cell syntax |\n+-----------+-----------+----------------------------------------------------------+\n| `eval` | `true` | `false`: don't run code |\n+-----------+-----------+----------------------------------------------------------+\n| `include` | `true` | `false`: don't include code or results |\n+-----------+-----------+----------------------------------------------------------+\n| `output` | `true` | `false`: don't include results\\ |\n| | | `asis`: treat results as raw markdown |\n+-----------+-----------+----------------------------------------------------------+\n| `warning` | `true` | `false`: don't include warnings in output |\n+-----------+-----------+----------------------------------------------------------+\n| `error` | `false` | `true`: include error in output and continue with render |\n+-----------+-----------+----------------------------------------------------------+\n\nSet execution options at the **cell level**:\n\n::: {layout-ncol=\"2\"}\n```{{r}}\n#| echo: false\n```\n\n```{{python}}\n#| echo: false\n```\n:::\n\nSet options in code cells with `#|` comments and YAML syntax: `key: value`.\n\nOr globally in the YAML header with the **execute** option:\n\n``` yaml\n---\nexecute:\n echo: false\n---\n```\n\n### Inline Code\n\nUse computed values directly in text sections.\nCode is evaluated at render and results appear as text.\n\n::: {layout-ncol=\"3\"}\n
\n\n#### Knitr\n\nValue is `` `r 2 + 2` ``.\n\n
\n\n
\n\n#### Jupyter\n\n[v1.4]{.small .muted}\n\nValue is `` `{python} 2 + 2` ``.\n\n
\n\n
\n\n#### Output\n\nValue is 4.\n\n
\n:::\n\n## Set Formats and Options\n\n::: {layout-ncol=\"2\"}\n::: {#set-options}\n### Set Format Options\n\n``` yaml\n---\ntitle: \"My Document\"\nformat: \n html: \n code-fold: true\n toc: true\n---\n```\n\n- Indent format 2 spaces\n- Indent options 4 spaces\n:::\n\n::: {#multiple-formats}\n### Multiple Formats\n\n``` yaml\n---\ntitle: \"My Document\"\ntoc: true\nformat: \n html: \n code-fold: true\n pdf: default\n---\n```\n\n- Top-level options (e.g. `toc`) apply to all formats\n:::\n:::\n\nCommon values for `format`: html, pdf[^2], docx, odt, rtf, gfm, pptx, revealjs, beamer\n[^3]\n\n[^2]: PDFs and Beamer slides require LaTeX, use:\n\n ``` {.bash filename=\"Terminal\"}\n quarto install tinytex\n ```\n\n[^3]: PDFs and Beamer slides require LaTeX, use:\n\n ``` {.bash filename=\"Terminal\"}\n quarto install tinytex\n ```\n\nRender **all** formats:\n\n``` {.bash filename=\"Terminal\"}\nquarto render hello.qmd\n```\n\nRender a **specific** format:\n\n``` {.bash filename=\"Terminal\"}\nquarto render hello.qmd --to pdf\n```\n\n### Output Options Table\n\n\n\n::: {.cell tbl-cap='Important Options. The first column is the option name, an \"X\" in the next three columns indicates whether the option applies to the format, the fourth column decribes the options and possible values, the final column indicates whether the options can also be set in a code cell.'}\n::: {.cell-output-display}\n\n```{=html}\n
\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n
Optionhtml/revealjspdf/beamerdocx/pptxDescriptioncell level?
Navigation
tocXXX

Add a table of contents (true or false)

\n

toc-depthXXX

Lowest level of headings to add to table of contents (e.g. 2, 3)

\n

anchor-sectionsX

Show section anchors on mouse hover (true or false)

\n

Style
highlight-styleXXX

Syntax highlighting theme (e.g. arrow, pygments, kate, zenburn)

\n

mainfont, monofontXX

Font name. HTML: sets CSS font-family; LaTeX: via fontspec package

\n

themeX

Bootswatch theme name (e.g. cosmo, darkly, solar etc.)

\n

cssX

CSS or SCSS file to use to style the document (e.g. “style.css”)

\n

reference-doc

X

docx/pptx file containing template styles (e.g. file.docx, file.pptx)

\n

NA
include-in-headerXX

Files of content to include in header of output document, also include-before-body, include-after-body

\n

keep-mdXXX

Keep intermediate files (true or false), also keep-tex, keep-ipynb

\n

LaTeX
documentclass
X

LaTeX document class, set document options with classoption

\n

pdf-engine
X

LaTeX engine to produce PDF output (xelatex, pdflatex, lualatex)

\n

cite-method
X

Method used to format citations (citeproc, natbib, biblatex)

\n

Code
code-foldX

Let readers toggle the display of R code (false, true, or show)

\n
X
code-toolsX

Add menu for hiding, showing, and downloading code (true or false)

\n

code-overflowX

Display of wide code (scroll, or wrap)

\n
X
Figures
fig-alignXXdocx only

Alignment of figures (default, left, right, center)

\n
X
fig-width, fig-heightXXX

Default width and height for figures in inches

\n
Knitr only
fig-formatXXX

Format for Matplotlib or R figures (retina, png, jpeg, svg, or pdf)

\n

\n
\n```\n\n:::\n:::\n\n\n\nVisit to see all options by format\n\n## Add Content\n\n### Figures {#figures}\n\n#### Markdown\n\n``` markdown\n![CAP](image.png){#fig-LABEL fig-alt=\"ALT\"}\n```\n\n#### Computation\n\n```{{python}}\n#| label: fig-LABEL\n#| fig-cap: CAP\n#| fig-alt: ALT\n{{ plot code here }}\n```\n\nOr `{r}`\n\n### Tables {#tables}\n\n#### Markdown\n\n``` markdown\n|object | radius|\n|:------|------:|\n|Sun | 696000|\n|Earth | 6371|\n\n: CAPTION {#tbl-LABEL}\n```\n\n#### Computation\n\nOutput a markdown table or an HTML table from your code.\n\n::: {layout-ncol=\"2\"}\n
\n\n##### Knitr\n\nUse `knitr::kable()` to produce markdown:\n\n```{{r}}\n#| label: tbl-LABEL\n#| tbl-cap: CAPTION\n\nknitr::kable(head(cars))\n```\n\nAlso see the R packages: gt, flextable, kableExtra.\n\n
\n\n
\n\n##### Jupyter\n\nAdd `Markdown()` to Markdown output:\n\n```{{python}}\n#| label: tbl-LABEL\n#| tbl-cap: CAPTION\nimport pandas as pd, tabulate\nfrom IPython.display import Markdown\ndf = pd.DataFrame({\"A\": [1, 2], \n \"B\": [1, 2]})\nMarkdown(df.to_markdown(index=False))\n```\n\n
\n:::\n\n### Cross References\n\n1. **Add labels:**\n\n - **Code cell:** add option `label: prefix-LABEL`\n - **Markdown:** add attribute `#prefix-LABEL`\n\n2. **Add references:** `@prefix-LABEL`, e.g.\n\n ``` markdown\n You can see in @fig-scatterplot, that...\n ```\n\n| `prefix` | Renders |\n|----------|------------|\n| `fig-` | Figure 1 |\n| `tbl-` | Table 1 |\n| `eq-` | Equation 1 |\n| `sec-` | Section 1 |\n\n### Citations\n\n1. Add bibliography **file** to the YAML header:\n\n ``` yaml\n ---\n bibliography: references.bib\n ---\n ```\n\n2. Add citations: `[@citation]`, or `@citation`\n\nRStudio & VS Code: Use **Insert Citations** dialog in the Visual Editor.\nBuild your bibliography file from your Zotero library, DOI, Crossref, DataCite, or PubMed.\n\n### Callouts\n\n``` markdown\n::: {.callout-tip}\n## Title\n\nText\n:::\n```\n\nInstead of `tip` use one of: `note`, `caution`, `warning`, or `important`:\n\n::: callout-tip\n## tip\n:::\n\n::: callout-note\n## note\n:::\n\n::: callout-caution\n## caution\n:::\n\n::: callout-warning\n## warning\n:::\n\n::: callout-important\n## important\n:::\n\n### Shortcodes\n\n```{.markdown}\n{{{< include _file.qmd >}}}\n```\n\n``` {.markdown shortcodes=\"false\"}\n{{< embed file.ipynb#id >}}\n```\n\n``` {.markdown shortcodes=\"false\"}\n{{< video video.mp4 >}}\n```\n\n------------------------------------------------------------------------\n\nCC BY SA Posit Software, PBC • [info\\@posit.co](mailto:info@posit.co) • [posit.co](https://posit.co)\n\nLearn more at [quarto.org](https://quarto.org).\n\nQuarto 1.3\n\nUpdated: 2024-05.\n\n------------------------------------------------------------------------\n", + "markdown": "---\ntitle: \"Publish and Share with Quarto :: Cheatsheet\"\ndescription: \"QMD Edition\"\nimage-alt: \"\"\nengine: knitr\nexecute:\n eval: true\n output: false\n warning: false\ncode-overflow: wrap\n---\n\n\n\n::: column-margin\n\n\n```{=html}\n\"Hex\n

\n```\n\n\n:::\n\n\n\n::: {.cell .column-margin}\n\n

Download PDF

\n\"\"/\n\n

\n:::\n\n\n\n## Overview\n\n![](images/quarto-illustration.png){fig-alt=\"A schematic representing the multi-language input (e.g. Python, R, Observable, Julia) and multi-format output (e.g. PDF, html, Word documents, and more) versatility of Quarto.\"}[^1]\n\n[^1]: Artwork from \"Hello, Quarto\" keynote by Julia Lowndes and Mine Çetinkaya-Rundel, presented at RStudio Conference 2022.\n Illustrated by [Allison Horst](https://allisonhorst.com/allison-horst).\n\n- **Author**: Write and code in plain text.\n Author documents as .qmd files, or Jupyter notebooks.\n Write in a rich Markdown syntax.\n\n- **Render**: Generate documents, presentations and more.\n Produce HTML, PDF, MS Word, reveal.js, MS Powerpoint, Beamer, websites, blogs, books...\n\n- **Share**: Share your work with the world.\n Quickly deploy to GitHub Pages, Netlify, Quarto Pub, Posit Cloud, or Posit Connect.\n\n### Get Quarto\n\nGet Quarto from: \n\nOr, use version **bundled with RStudio.**\n\n### Get Started\n\n\n\n## Author\n\n### Source File: hello.qmd\n\n```` markdown\n---\ntitle: \"Hello, Penguins\"\nformat: html\nexecute:\n echo: false\n---\n\n## Meet the penguins\n\nThe `penguins` data contains size measurements for \npenguins from three islands in the Palmer Archipelago, \nAntarctica.\n\nThe three species of penguins have quite distinct \ndistributions of physical dimensions (@fig-penguins).\n\n```{{r}}\n#| label: fig-penguins\n#| fig-cap: \"Dimensions of penguins across three species.\"\n#| warning: false\nlibrary(tidyverse, quietly = TRUE)\nlibrary(palmerpenguins)\npenguins |>\n ggplot(aes(x = flipper_length_mm, y = bill_length_mm)) +\n geom_point(aes(color = species)) +\n scale_color_manual(\n values = c(\"darkorange\", \"purple\", \"cyan4\")) +\n theme_minimal()\n```\n````\n\n### Highlights in the source file\n\n- Set format(s) and options.\n Use YAML Syntax.\n\n ``` markdown\n ---\n title: \"Hello, Penguins\"\n format: html\n execute:\n echo: false\n ---\n ```\n\n- `## Write with **Markdown**`\n\n **RStudio**: Help \\> Markdown Quick Reference\n\n RStudio & VS Code: Use the **Visual Editor**\n\n ``` markdown\n ## Meet the penguins\n\n The `penguins` data contains size measurements for \n penguins from three islands in the Palmer Archipelago, \n Antarctica.\n\n The three species of penguins have quite distinct \n distributions of physical dimensions (@fig-penguins).\n ```\n\n- Include code.\n R, Python, Julia, Observable, or any language with a Jupyter kernel.\n\n ```` markdown\n ```{{r}}\n #| label: fig-penguins\n #| fig-cap: \"Dimensions of penguins across three species.\"\n #| warning: false\n library(tidyverse, quietly = TRUE)\n library(palmerpenguins)\n penguins |>\n ggplot(aes(x = flipper_length_mm, y = bill_length_mm)) +\n geom_point(aes(color = species)) +\n scale_color_manual(\n values = c(\"darkorange\", \"purple\", \"cyan4\")) +\n theme_minimal()\n ```\n ````\n\n### Use a tool with a rich authoring experience\n\n[RStudio](https://posit.co/products/open-source/rstudio/), or\\\n[Visual Studio Code](https://code.visualstudio.com/) + [Quarto extension](https://marketplace.visualstudio.com/items?itemName=quarto.quarto)\n\n- **Run** code cells as you write\n\n- **Render** with a button or keyboard shortcut\n\n- Edit Quarto documents with a **Visual Editor**\n\n ![](images/quarto-visual-editor.png){fig-alt=\"Screenshot of the Visual Editor toolbar. Toolbar shows menu items: Normal with dropdown, bold, italics, code, bulleted list, numbered list, link, image, Format dropdown, Insert dropdown and Table dropdown.\"}\n\n - Apply formatting in Visual Editor.\n Saved as Markdown in source.\n\n - Insert elements like code cells, cross references, and more.\n\n### Or any text editor\n\nQuarto documents (.qmd) can be edited in any tool that edits text.\n\n## Render\n\n**Save,** then render to **preview** the document output.\n\n``` {.bash filename=\"Terminal\"}\nquarto preview hello.qmd\n```\n\nRStudio: Use **Render** button ![](images/quarto-render-button.png){fig-alt=\"Icon from the Render button in RStudio\" height=\"1.5em\"}\n\nVS Code: Use **Preview** button ![](images/quarto-preview-button.svg){fig-alt=\"Icon from the Preview button in VS Code\"}\n\nThe resulting HTML/PDF/MS Word/etc.\ndocument will be created and saved in the same directory as the source .qmd file.\n\n### Rendered output: hello.html\n\n![](images/quarto-rendered-output.png){fig-alt=\"Screenshot of a webpage with the title 'Hello, Penguins'. There is a subheading 'Meet the penguins' followed by a paragraph of text including a link to 'Figure 1', then a scatterplot.\"}\n\n### Highlights in the rendered output\n\n- Features for scientific publishing.\n Cross references, citations, equations, and more.\n\n- Output integrated into document.\n Control how output appears with special comments in your code.\n\n### Behind the Scenes\n\nWhen you render a document, Quarto:\n\n1. Runs the code and embeds results and text into an .md file with:\n - **Knitr**, if any `{r}` cells, or\n - **Jupyter**, if any other cells.\n2. Converts the .md file into the output format with Pandoc.\n\n## Publish\n\n``` {.bash filename=\"Terminal\"}\nquarto publish {venue} hello.qmd\n```\n\n`{venue}`: quarto-pub, connect, gh-pages, netlify, confluence, posit-cloud\n\nRStudio: Use **Publish** button ![](images/quarto-rstudio-publish.png){fig-alt=\"Publish button icon in RStudio\" width=\"10%\"}\n\n- [**Quarto Pub**](https://quartopub.com/) Free publishing service for Quarto content.\n\n- [**Posit Cloud**](https://posit.cloud/) Cloud-hosted, control access to project and output.\n ![](images/quarto-rstudio-publish.png){fig-alt=\"Push button publishing from RStudio\" width=\"10%\"}\n\n- [**Posit Connect**](https://posit.co/products/enterprise/connect/) Org-hosted, control access, schedule updates.\n ![](images/quarto-rstudio-publish.png){fig-alt=\"Push button publishing from RStudio\" width=\"10%\"}\n\n## Quarto Projects\n\n### Create websites, books and more\n\nA directory of Quarto documents + a configuration file (`_quarto.yml`)\n\nSee examples at: \n\nGet started from the command line:\n\n``` {.bash filename=\"Terminal\"}\nquarto create project {type}\n```\n\n`{type}`: default, website, blog, book, confluence, manuscript\n\nRStudio: Use **File** \\> **New Project**\n\n## Include Code\n\n### Code Cells\n\nCode cells start with ```` ```{language} ````, and end with ```` ``` ````.\n\nRStudio & VS Code: Use **Insert Code Chunk/Cell**.\n\n::: {layout-ncol=\"2\"}\n```{{r}}\n#| label: chunk-id\n```\n\n```{{python}}\n#| label: chunk-id\n```\n:::\n\nOther languages: `{julia}`, `{ojs}`\n\nAdd code cell options with `#|` comments.\n\nCell options control [**execution**](#execution), [figures](#figures), [tables](#tables), layout and more.\nSee them all at: \n\n### Execution Options {#execution}\n\n+-----------+-----------+----------------------------------------------------------+\n| Option | Default | Effects |\n+===========+===========+==========================================================+\n| `echo` | `true` | `false`: hide code in output\\ |\n| | | `fenced`: include code cell syntax |\n+-----------+-----------+----------------------------------------------------------+\n| `eval` | `true` | `false`: don't run code |\n+-----------+-----------+----------------------------------------------------------+\n| `include` | `true` | `false`: don't include code or results |\n+-----------+-----------+----------------------------------------------------------+\n| `output` | `true` | `false`: don't include results\\ |\n| | | `asis`: treat results as raw markdown |\n+-----------+-----------+----------------------------------------------------------+\n| `warning` | `true` | `false`: don't include warnings in output |\n+-----------+-----------+----------------------------------------------------------+\n| `error` | `false` | `true`: include error in output and continue with render |\n+-----------+-----------+----------------------------------------------------------+\n\nSet execution options at the **cell level**:\n\n::: {layout-ncol=\"2\"}\n```{{r}}\n#| echo: false\n```\n\n```{{python}}\n#| echo: false\n```\n:::\n\nSet options in code cells with `#|` comments and YAML syntax: `key: value`.\n\nOr globally in the YAML header with the **execute** option:\n\n``` yaml\n---\nexecute:\n echo: false\n---\n```\n\n### Inline Code\n\nUse computed values directly in text sections.\nCode is evaluated at render and results appear as text.\n\n::: {layout-ncol=\"3\"}\n
\n\n#### Knitr\n\nValue is `` `r 2 + 2` ``.\n\n
\n\n
\n\n#### Jupyter\n\nValue is `` `{python} 2 + 2` ``.\n\n
\n\n
\n\n#### Output\n\nValue is 4.\n\n
\n:::\n\n## Set Formats and Options\n\n::: {layout-ncol=\"2\"}\n::: {#set-options}\n### Set Format Options\n\n``` yaml\n---\ntitle: \"My Document\"\nformat: \n html: \n code-fold: true\n toc: true\n---\n```\n\n- Indent format 2 spaces\n- Indent options 4 spaces\n:::\n\n::: {#multiple-formats}\n### Multiple Formats\n\n``` yaml\n---\ntitle: \"My Document\"\ntoc: true\nformat: \n html: \n code-fold: true\n pdf: default\n---\n```\n\n- Top-level options (e.g. `toc`) apply to all formats\n:::\n:::\n\nCommon values for `format`: html, pdf[^2], docx, odt, rtf, gfm, pptx, revealjs, beamer\n[^2]\n\n[^2]: PDFs and Beamer slides require LaTeX, use:\n\n ``` {.bash filename=\"Terminal\"}\n quarto install tinytex\n ```\n\nRender **all** formats:\n\n``` {.bash filename=\"Terminal\"}\nquarto render hello.qmd\n```\n\nRender a **specific** format:\n\n``` {.bash filename=\"Terminal\"}\nquarto render hello.qmd --to pdf\n```\n\n### Output Options Table\n\n\n\n::: {.cell tbl-cap='Important Options. The first column is the option name, an \"X\" in the next three columns indicates whether the option applies to the format, the fourth column decribes the options and possible values, the final column indicates whether the options can also be set in a code cell.'}\n::: {.cell-output-display}\n\n```{=html}\n
\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n \n\n\n\n\n\n \n\n\n\n\n\n \n\n\n\n\n\n \n \n \n
Optionhtml/revealjspdf/beamerdocx/pptxDescriptioncell level?
Navigation
tocXXX

Add a table of contents (true or false)

\n

toc-depthXXX

Lowest level of headings to add to table of contents (e.g. 2, 3)

\n

anchor-sectionsX

Show section anchors on mouse hover (true or false)

\n

Style
highlight-styleXXX

Syntax highlighting theme (e.g. arrow, pygments, kate, zenburn)

\n

mainfont, monofontXX

Font name. HTML: sets CSS font-family; LaTeX: via fontspec package

\n

themeX

Bootswatch theme name (e.g. cosmo, darkly, solar etc.)

\n

cssX

CSS or SCSS file to use to style the document (e.g. “style.css”)

\n

reference-doc

X

docx/pptx file containing template styles (e.g. file.docx, file.pptx)

\n

NA
include-in-headerXX

Files of content to include in header of output document, also include-before-body, include-after-body

\n

keep-mdXXX

Keep intermediate files (true or false), also keep-tex, keep-ipynb

\n

LaTeX
documentclass
X

LaTeX document class, set document options with classoption

\n

pdf-engine
X

LaTeX engine to produce PDF output (xelatex, pdflatex, lualatex)

\n

cite-method
X

Method used to format citations (citeproc, natbib, biblatex)

\n

Code
code-foldX

Let readers toggle the display of R code (false, true, or show)

\n
X
code-toolsX

Add menu for hiding, showing, and downloading code (true or false)

\n

code-overflowX

Display of wide code (scroll, or wrap)

\n
X
Figures
fig-alignXXdocx only

Alignment of figures (default, left, right, center)

\n
X
fig-width, fig-heightXXX

Default width and height for figures in inches

\n
Knitr only
fig-formatXXX

Format for Matplotlib or R figures (retina, png, jpeg, svg, or pdf)

\n

\n
\n```\n\n:::\n:::\n\n\n\nVisit to see all options by format\n\n## Add Content\n\n### Figures {#figures}\n\n#### Markdown\n\n``` markdown\n![CAP](image.png){#fig-LABEL fig-alt=\"ALT\"}\n```\n\n#### Computation\n\n```{{python}}\n#| label: fig-LABEL\n#| fig-cap: CAP\n#| fig-alt: ALT\n{{ plot code here }}\n```\n\nOr `{r}`\n\n### Tables {#tables}\n\n#### Markdown\n\n``` markdown\n|object | radius|\n|:------|------:|\n|Sun | 696000|\n|Earth | 6371|\n\n: CAPTION {#tbl-LABEL}\n```\n\n#### Computation\n\nOutput a markdown table or an HTML table from your code.\n\n::: {layout-ncol=\"2\"}\n
\n\n##### Knitr\n\nUse `knitr::kable()` to produce markdown:\n\n```{{r}}\n#| label: tbl-LABEL\n#| tbl-cap: CAPTION\n\nknitr::kable(head(cars))\n```\n\nAlso see the R packages: gt, flextable, kableExtra.\n\n
\n\n
\n\n##### Jupyter\n\nAdd `Markdown()` to Markdown output:\n\n```{{python}}\n#| label: tbl-LABEL\n#| tbl-cap: CAPTION\nimport pandas as pd, tabulate\nfrom IPython.display import Markdown\ndf = pd.DataFrame({\"A\": [1, 2], \n \"B\": [1, 2]})\nMarkdown(df.to_markdown(index=False))\n```\n\n
\n:::\n\n### Cross References\n\n1. **Add labels:**\n\n - **Code cell:** add option `label: prefix-LABEL`\n - **Markdown:** add attribute `#prefix-LABEL`\n\n2. **Add references:** `@prefix-LABEL`, e.g.\n\n ``` markdown\n You can see in @fig-scatterplot, that...\n ```\n\n| `prefix` | Renders |\n|----------|------------|\n| `fig-` | Figure 1 |\n| `tbl-` | Table 1 |\n| `eq-` | Equation 1 |\n| `sec-` | Section 1 |\n\n### Citations\n\n1. Add bibliography **file** to the YAML header:\n\n ``` yaml\n ---\n bibliography: references.bib\n ---\n ```\n\n2. Add citations: `[@citation]`, or `@citation`\n\nRStudio & VS Code: Use **Insert Citations** dialog in the Visual Editor.\nBuild your bibliography file from your Zotero library, DOI, Crossref, DataCite, or PubMed.\n\n### Callouts\n\n``` markdown\n::: {.callout-tip}\n## Title\n\nText\n:::\n```\n\nInstead of `tip` use one of: `note`, `caution`, `warning`, or `important`:\n\n::: callout-tip\n## tip\n:::\n\n::: callout-note\n## note\n:::\n\n::: callout-caution\n## caution\n:::\n\n::: callout-warning\n## warning\n:::\n\n::: callout-important\n## important\n:::\n\n### Shortcodes\n\n```{.markdown}\n{{{< include _file.qmd >}}}\n```\n\n``` {.markdown shortcodes=\"false\"}\n{{< embed file.ipynb#id >}}\n```\n\n``` {.markdown shortcodes=\"false\"}\n{{< video video.mp4 >}}\n```\n\n------------------------------------------------------------------------\n\nCC BY SA Posit Software, PBC • [info\\@posit.co](mailto:info@posit.co) • [posit.co](https://posit.co)\n\nLearn more at [quarto.org](https://quarto.org).\n\nQuarto 1.3\n\nUpdated: 2024-05.\n\n------------------------------------------------------------------------\n", "supporting": [], "filters": [ "rmarkdown/pagebreak.lua" diff --git a/html/quarto.qmd b/html/quarto.qmd index 911c65b1..4ebac86b 100644 --- a/html/quarto.qmd +++ b/html/quarto.qmd @@ -204,7 +204,7 @@ When you render a document, Quarto: quarto publish {venue} hello.qmd ``` -`{venue}`: quarto-pub, connect, gh-pages, netlify, confluence, (*v1.4*) posit-cloud +`{venue}`: quarto-pub, connect, gh-pages, netlify, confluence, posit-cloud RStudio: Use **Publish** button ![](images/quarto-rstudio-publish.png){fig-alt="Publish button icon in RStudio" width="10%"} @@ -230,7 +230,7 @@ Get started from the command line: quarto create project {type} ``` -`{type}`: default, website, blog, book, confluence, (*v1.4*) manuscript +`{type}`: default, website, blog, book, confluence, manuscript RStudio: Use **File** \> **New Project** @@ -320,8 +320,6 @@ Value is `` `r knitr::inline_expr("2 + 2")` ``. #### Jupyter -[v1.4]{.small .muted} - Value is `` `{python} 2 + 2` ``. @@ -374,7 +372,7 @@ format: ::: Common values for `format`: html, pdf[^2], docx, odt, rtf, gfm, pptx, revealjs, beamer -[^3] +[^2] [^2]: PDFs and Beamer slides require LaTeX, use: @@ -382,12 +380,6 @@ Common values for `format`: html, pdf[^2], docx, odt, rtf, gfm, pptx, revealjs, quarto install tinytex ``` -[^3]: PDFs and Beamer slides require LaTeX, use: - - ``` {.bash filename="Terminal"} - quarto install tinytex - ``` - Render **all** formats: ``` {.bash filename="Terminal"} @@ -594,7 +586,7 @@ CC BY SA Posit Software, PBC • [info\@posit.co](mailto:info@posit.co) • [pos Learn more at [quarto.org](https://quarto.org). -Quarto 1.3 +Quarto 1.4 Updated: `r format(Sys.Date(), "%Y-%m")`.