Add Positron where appropriate (#1719)

* Enable include-dark.lua everywhere

* Add Positron to websites quick start

* Add Positron to blog quick start

* Add Positron to book quick start

* Add Positron sections to Guide > Computing

* Add Positron to virtual environments

* Generalize LUA dev to Positron

* Mention Positron where appropriate

* Update docs/projects/profiles.qmd

Co-authored-by: Julia Silge <[email protected]>

* Fix wrong link

* Changes based on review

* Include both links for extension

* Link to both registries for LUA extension too

---------

Co-authored-by: Carlos Scheidegger <[email protected]>
Co-authored-by: Julia Silge <[email protected]>

Author: 3 people

_quarto.yml

@@ -691,6 +691,8 @@ format:
 filters:
   - filters/tools-tabset.lua
   - filters/color-box.lua
+  - at: post-quarto
+    path: filters/include-dark.lua
 
 freeze: true
 

docs/authoring/diagrams.qmd

@@ -94,12 +94,10 @@ There are a variety of tools available to improve your productivity authoring di
 
 3)  [RStudio](https://www.rstudio.com/products/rstudio/download/) includes support for editing and previewing `.mmd` and `.dot` files (with help from the [DiagrammeR](https://rich-iannone.github.io/DiagrammeR/) package).
 
-4)  The Quarto [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=quarto.quarto) supports live preview of diagrams embedded in `.qmd` files and in `.mmd` and `.dot` files:
+4)  The Quarto Extension for VS Code and Positron (available on both [OpenVSX](https://open-vsx.org/extension/quarto/quarto) and [Microsoft's marketplace](https://marketplace.visualstudio.com/items?itemName=quarto.quarto)) supports live preview of diagrams embedded in `.qmd` files and in `.mmd` and `.dot` files:
 
     ![](images/vscode-graphviz.gif){.border fig-alt="A Quarto document being edited in Visual Studio Code, with a live preview of the currenly edited diagram shown in a pane to the right"}
 
-    Note that you should be sure to have installed the [very latest](https://marketplace.visualstudio.com/items?itemName=quarto.quarto) version of the Quarto VS Code extension to try this out.
-
 ## Cross-References
 
 Diagrams can be treated as figures the same way that images and plot output are. For example, if we added the following figure options to the diagram above:

docs/books/book-basics.qmd

@@ -34,6 +34,26 @@ Follow the Quick Start for your tool of choice to get a simple book up and runni
 
 ::: {.panel-tabset group="tools-tabset"}
 
+### Positron
+
+To create a new book project within Positron, execute the **Quarto: Create Project** command from the command-palette:
+
+![](/docs/websites/images/positron-create-project-command.png){.include-dark .border}
+
+Then, select **Book Project**:
+
+![](images/positron-create-project-book.png){.include-dark .border}
+
+You'll be prompted to select a parent directory to create the project within. Then, you'll be asked to name the directory for your book project:
+
+![](/docs/websites/images/positron-create-project-directory.png){.include-dark .border}
+
+The new book project will be created and opened within Positron. Click the **Preview** button (![](/docs/tools/images/vscode-preview-icon.svg){.light-content fig-alt="Preview icon"}![](/docs/tools/images/vscode-preview-icon-white.svg){.dark-content fig-alt="Preview icon"}) to preview the book:
+
+![](images/positron-create-project-render-book.png){.include-dark .border}
+
+The preview will show to the right of the source file. As you re-render `index.qmd` or render other files like `intro.qmd`, the preview is automatically updated.
+
 ### VS Code
 
 To create a new book project within VS Code, execute the **Quarto: Create Project** command from the command-palette:
@@ -48,7 +68,7 @@ You'll be prompted to select a parent directory to create the project within. Th
 
 ![](/docs/websites/images/vscode-create-project-directory.png){.border}
 
-The new book project will be created and opened within VS Code. Click the **Preview** button (![](/docs/tools/images/vscode-preview-icon.svg){fig-alt="Preview icon"}) to preview the book:
+The new book project will be created and opened within VS Code. Click the **Preview** button (![](/docs/tools/images/vscode-preview-icon.svg){.light-content fig-alt="Preview icon"}![](/docs/tools/images/vscode-preview-icon-white.svg){.dark-content fig-alt="Preview icon"}) to preview the book:
 
 ![](/docs/websites/images/vscode-create-project-render-book.png)
 

docs/books/images/positron-create-project-book-dark.png

@@ -19,6 +19,10 @@ quarto preview document.ipynb
 
 In addition to including executable {{< meta jupyter-language >}} code chunks in a Quarto document, you can also embed cells from an external Jupyter Notebook (`.ipynb`). See [Embedding Jupyter Notebook Cells](/docs/authoring/notebook-embed.qmd) for more details.
 
+## Positron
+
+{{< include _positron.md >}}
+
 ## VS Code
 
 The [Quarto Extension](https://marketplace.visualstudio.com/items?itemName=quarto.quarto) for VS Code provides a variety of tools for working with `.qmd` files in VS Code. The extension integrates directly with the {{< meta vscode-extension >}} to provide the following {{< meta jupyter-language >}}-specific capabilities:

docs/books/images/positron-create-project-book.png

@@ -0,0 +1,12 @@
+The [Quarto Extension](https://open-vsx.org/extension/quarto/quarto) is bundled with Positron, and provides a variety of tools for working with `.qmd` files. The extension integrates directly with {{< meta positron-extension>}} to provide code completion, cell execution and side-by-side preview of Quarto documents.
+
+![]({{< meta positron-screenshot >}}){.include-dark .border fig-alt="Screen shot of qmd file open in Positron with source markdown shown in Editor pane and a rendered document shown in the Viewer Pane."}
+
+The extension includes a **Quarto: Preview** command that can be accessed via the Command Palette, the keyboard shortcut {{< kbd mac=Command-Shift-K win=Control-Shift-K linux=Control-Shift-K >}}, or a **Preview** button (![](/docs/tools/images/vscode-preview-icon.svg){.light-content fig-alt="Preview icon"}![](/docs/tools/images/vscode-preview-icon-white.svg){.dark-content fig-alt="Preview icon"}) in the editor toolbar. 
+After rendering, a preview is displayed in the Viewer pane within Positron. 
+
+You can read more about using Positron in [Tools: Positron](/docs/tools/positron/index.qmd).
+
+::: {.content-visible unless-meta="is_r"}
+You can also use the Positron notebook editor to create `.ipynb` notebooks that you will render with Quarto. The [Jupyter Lab](#jupyter-lab) section discusses using notebooks with Quarto in the context of Jupyter Lab, but the same concepts apply to Positron.
+:::