Positron authoring based on VS Code docs

Author: cwickham

docs/get-started/authoring/_install-tinytex.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/_positron-render.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.html` 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.html`
+-   `authoring.pdf`
+-   `authoring.docx`

docs/get-started/authoring/_text-editor.md

@@ -8,7 +8,17 @@ Quarto supports rendering notebooks to dozens of different [output formats](/doc
 
 ### Format Options
 
-Let's create a new file (`authoring.qmd`) and define various formats for it to be rendered to, adding some options to each of the formats. As a reminder, document options are specified in YAML at the beginning of the source file.
+::: {.content-visible when-meta="tool.is_positron"}
+Let's create a new file (`authoring.qmd`) and define various formats for it to be rendered to, adding some options to each of the formats.
+To create a new Quarto document, run the **Quarto: New Document** command, or use the **File > New File ...** menu and select **Quarto Document**.
+
+Save the file as `authoring.qmd` and edit the YAML header to:
+:::
+
+::: {.content-visible unless-meta="tool.is_positron"}
+Let's create a new file (`authoring.qmd`) and define various formats for it to be rendered to, adding some options to each of the formats. 
+As a reminder, document options are specified in YAML at the beginning of the source file.
+:::
 
 ``` yaml
 ---
@@ -33,6 +43,8 @@ format:
 ---
 ```
 
+{{< include _install-tinytex.md >}}
+
 ### Multiple Formats
 
 Some documents you create will have only a single output format, however in many cases it will be desirable to support multiple formats. Let's add the `html` and `docx` formats to our document.
@@ -89,6 +101,11 @@ The `html` and `pdf` formats each provide an option or two. For example, for the
 
 ## Rendering
 
+::: {.content-visible when-meta="tool.is_positron"}
+{{< include _positron-render.md >}}
+:::
+
+::: {.content-visible unless-meta="tool.is_positron"}
 The formats specified within document options define what is rendered by default. If we render the document with all the options given above using the following.
 
 ``` {.bash filename="Terminal"}
@@ -117,6 +134,7 @@ quarto render authoring.qmd --to odt
 ```
 
 Since the `odt` format isn't included within document options, the default options for the format will be used.
+:::
 
 ## Sections
 

docs/get-started/authoring/positron.qmd

@@ -0,0 +1,15 @@
+---
+title: "Tutorial: Authoring"
+css: ../positron.css
+tool:
+  is_positron: true
+---
+
+{{< include ../_tool-chooser.md >}}
+
+{{< include ../_language-chooser.md >}}
+
+{{< include _text-editor.md >}}
+
+
+Additionally, if you are interested in seeing how to use Quarto from within `.ipynb` notebooks, check out the documentation on using the Positron [Notebook Editor](/docs/tools/positron/notebook.qmd) with Quarto.

docs/get-started/authoring/rstudio.qmd

@@ -61,12 +61,7 @@ If you would like to follow along step-by-step in your own environment, download
 <i class="bi bi-download"></i> [Download authoring.qmd](_authoring.qmd){download="authoring.qmd"}
 :::
 
-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
-```
+{{< include _install-tinytex.md >}}
 
 See the article on [PDF Engines](/docs/output-formats/pdf-engine.qmd) for details on using other LaTeX distributions and PDF compilation engines.