Skip to content
Merged
Show file tree
Hide file tree
Changes from 20 commits
Commits
Show all changes
40 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
ca4f81a
Fixes from PR comment
cwickham Jul 15, 2025
18fb143
Add link to markdown basics
cwickham Jul 16, 2025
c2decf7
Move setup to include to avoid parsing issue
cwickham Jul 16, 2025
608ed05
Update hello screenshots
cwickham Jul 16, 2025
c8657b8
Light/dark screenshots
cwickham Jul 17, 2025
24f64ac
No yellow cast
cwickham Jul 17, 2025
24c7aa1
Don't use palmerpenguins package for python
cwickham Jul 17, 2025
7cd51ac
Remove palmerpenguins from deps
cwickham Jul 17, 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.

16 changes: 16 additions & 0 deletions docs/get-started/_language-chooser.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
::: {.callout-tip}

# R or Python?

You can work through this tutorial using R or Python code examples.
Select your preferred language:

::: {.panel-tabset group="language"}

## R

## Python

:::
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I have kind of mixed feelings about having a tabset without content in it set up to use as a chooser, and worry that it is not a typical enough website gesture for folks to understand. Maybe we can get another set of eyes on whether this makes sense? Would it be better if there was some content in it?

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed. I'm guessing this couldn't be a radio button, as the selection then carries through to other tabsets. Could this particular tabset be styled differently with CSS to make it look like a radio button or like boxes on top of the page for tool selection? Alternatively, adding some descriptor text would resolve the issue too. Maybe something like "If you primarily code in R, select this tab to see code examples in R. You can always switch over to Python whenever you like throughout the guide."

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I've tweaked the CSS so these first tabsets are more obviously buttons. Added some content in the tabset to clarify too.


:::
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