Skip to content

Get Started > Positron #1692

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 32 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
6af69d3
Rough hello page
cwickham May 30, 2025
19f91b0
Add example docs
cwickham May 30, 2025
a75b499
Build out hello
cwickham Jun 11, 2025
74a99f3
Tweak langauge tab styling
cwickham Jun 12, 2025
e547bbb
Rework hello
cwickham Jun 24, 2025
379966c
Use penguins from plotnine
cwickham Jun 25, 2025
971cd14
Extract language chooser from hello
cwickham Jun 27, 2025
4370e5a
Format Python cell with ruff
cwickham Jun 27, 2025
4fda1a3
Build out based on other IDE flows
cwickham Jun 27, 2025
5134bdf
Positron authoring based on VS Code docs
cwickham Jun 27, 2025
3163ab4
Keep default format as pdf
cwickham Jun 27, 2025
ed9e3e8
De-pythonify citations
cwickham Jun 27, 2025
221e63a
Add R examples for Positron page
cwickham Jun 27, 2025
05765cd
Prune computations
cwickham Jun 30, 2025
5bba034
chunk -> cell
cwickham Jun 30, 2025
f1e5290
Call out on landing
cwickham Jun 30, 2025
09dfee2
Update completed computations files
cwickham Jun 30, 2025
8d91542
Update screenshots
cwickham Jun 30, 2025
cf09d71
Add callout for visual and notebook editors
cwickham Jun 30, 2025
8dd4ef0
we -> you, where appropriate
cwickham Jun 30, 2025
abac9a9
Merge branch 'main' into positron-get-started
cwickham Jul 1, 2025
f31ee80
Add metadata to fix "Next Steps" links
cwickham Jul 1, 2025
3b10a5a
Don't call out positron on landing
cwickham Jul 14, 2025
dda8682
Tweak CSS so language chooser is more obviously a button
cwickham Jul 14, 2025
99ba4db
Apply review suggestions
cwickham Jul 14, 2025
6225382
Fix kbd shortcode
cwickham Jul 15, 2025
8638818
Fix another kbd
cwickham Jul 15, 2025
988517d
Remove empty line after code cell options
cwickham Jul 15, 2025
c1d9162
Add screenshots for code-line-numbers
cwickham Jul 15, 2025
a197bea
Omit quotes in YAML
cwickham Jul 15, 2025
b3d7fac
More suggestions from review
cwickham Jul 15, 2025
f8b7e8c
Apply suggestions from review
cwickham Jul 15, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions Pipfile
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,8 @@ plotly = "*"
pathlib = "*"
nbformat = "*"
statsmodels = "*"
plotnine = "*"
palmerpenguins = "*"

[dev-packages]

Expand Down
1,036 changes: 524 additions & 512 deletions Pipfile.lock

Large diffs are not rendered by default.

20 changes: 20 additions & 0 deletions docs/get-started/_language-chooser.md
Original file line number Diff line number Diff line change
@@ -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.

:::

:::
5 changes: 5 additions & 0 deletions docs/get-started/_tool-chooser.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
12 changes: 12 additions & 0 deletions docs/get-started/authoring/_install-tinytex.md
Original file line number Diff line number Diff line change
@@ -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
```

:::
14 changes: 14 additions & 0 deletions docs/get-started/authoring/_positron-render.md
Original file line number Diff line number Diff line change
@@ -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`
Loading