Get Started > Positron (#1692) (#1714)

(cherry picked from commit 1715f6e)

Co-authored-by: Charlotte Wickham <[email protected]>

Author: github-actions[bot]

Pipfile

@@ -27,6 +27,7 @@ plotly = "*"
 pathlib = "*"
 nbformat = "*"
 statsmodels = "*"
+plotnine = "*"
 
 [dev-packages]
 

Pipfile.lock

@@ -0,0 +1,20 @@
+::: {.callout-tip}
+
+# R or Python?
+
+You can work through this tutorial using R or Python code examples. 
+Select your preferred language:
+
+::: {#language-chooser .panel-tabset group="language"} 
+
+## R
+
+You've selected to see examples in R. You can toggle to Python whenever you like throughout the guide.
+
+## Python
+
+You've selected to see examples in Python. You can toggle to R whenever you like throughout the guide.
+
+:::
+
+:::

docs/get-started/_language-chooser.md

@@ -1,6 +1,11 @@
 ```{=html}
 <ul id="choose-your-tool" class="nav nav-tabs" role="tablist">
   <h3 class="no-anchor">Choose your tool</h3>
+  <li class="nav-item" role="presentation">
+    <a class="nav-link" href="positron.html">
+      <img src="../images/positron-logo.svg">Positron
+    </a>
+  </li>
   <li class="nav-item" role="presentation">
     <a class="nav-link" href="vscode.html">
       <img src="../images/vscode-logo.png">VS Code

docs/get-started/_tool-chooser.md

@@ -0,0 +1,12 @@
+::: {.callout-caution}
+
+## LaTeX Required for `format: pdf`
+
+In order to create PDFs you will need to install a recent distribution of [LaTeX](https://www.latex-project.org/).
+We recommend the use of TinyTeX (which is based on TexLive), which you can install with the following command:
+
+``` {.bash filename="Terminal"}
+quarto install tinytex
+```
+
+:::

docs/get-started/authoring/_install-tinytex.md

@@ -0,0 +1,14 @@
+When you preview a document with the **Quarto: Preview** command, the Preview button in the toolbar, or the keyboard shortcut {{< kbd mac=Command-Shift-K win=Ctrl+Shift+K linux=Ctrl+Shift+K >}},
+the first format specified in the document header is rendered and previewed.
+In this case, the file `authoring.pdf` will be created, and opened in the Viewer pane.
+
+To preview a specific format use the **Quarto: Preview Format...** command and select a different format.
+The selected format will then be used whenever you preview. 
+To return to the default format, or a different format, run  **Quarto: Preview Format...** again.
+
+To render all formats specified in the document header, run the command **Quarto: Render Document**. 
+Then the following files would be created.
+
+-   `authoring.pdf`
+-   `authoring.html`
+-   `authoring.docx`