-
Notifications
You must be signed in to change notification settings - Fork 980
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
Merged
Merged
Get Started > Positron #1692
Changes from 20 commits
Commits
Show all changes
40 commits
Select commit
Hold shift + click to select a range
6af69d3
Rough hello page
cwickham 19f91b0
Add example docs
cwickham a75b499
Build out hello
cwickham 74a99f3
Tweak langauge tab styling
cwickham e547bbb
Rework hello
cwickham 379966c
Use penguins from plotnine
cwickham 971cd14
Extract language chooser from hello
cwickham 4370e5a
Format Python cell with ruff
cwickham 4fda1a3
Build out based on other IDE flows
cwickham 5134bdf
Positron authoring based on VS Code docs
cwickham 3163ab4
Keep default format as pdf
cwickham ed9e3e8
De-pythonify citations
cwickham 221e63a
Add R examples for Positron page
cwickham 05765cd
Prune computations
cwickham 5bba034
chunk -> cell
cwickham f1e5290
Call out on landing
cwickham 09dfee2
Update completed computations files
cwickham 8d91542
Update screenshots
cwickham cf09d71
Add callout for visual and notebook editors
cwickham 8dd4ef0
we -> you, where appropriate
cwickham abac9a9
Merge branch 'main' into positron-get-started
cwickham f31ee80
Add metadata to fix "Next Steps" links
cwickham 3b10a5a
Don't call out positron on landing
cwickham dda8682
Tweak CSS so language chooser is more obviously a button
cwickham 99ba4db
Apply review suggestions
cwickham 6225382
Fix kbd shortcode
cwickham 8638818
Fix another kbd
cwickham 988517d
Remove empty line after code cell options
cwickham c1d9162
Add screenshots for code-line-numbers
cwickham a197bea
Omit quotes in YAML
cwickham b3d7fac
More suggestions from review
cwickham f8b7e8c
Apply suggestions from review
cwickham ca4f81a
Fixes from PR comment
cwickham 18fb143
Add link to markdown basics
cwickham c2decf7
Move setup to include to avoid parsing issue
cwickham 608ed05
Update hello screenshots
cwickham c8657b8
Light/dark screenshots
cwickham 24f64ac
No yellow cast
cwickham 24c7aa1
Don't use palmerpenguins package for python
cwickham 7cd51ac
Remove palmerpenguins from deps
cwickham File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Large diffs are not rendered by default.
Oops, something went wrong.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 | ||
|
|
||
| ::: | ||
|
|
||
| ::: | ||
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 | ||
| ``` | ||
|
|
||
| ::: |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 >}} | ||
cwickham marked this conversation as resolved.
Outdated
Show resolved
Hide resolved
|
||
| 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` | ||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
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?
There was a problem hiding this comment.
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."
There was a problem hiding this comment.
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.