Skip to content

Commit

Permalink
New downloads page (#26)
Browse files Browse the repository at this point in the history
* Start draft of new page for downloads

* Clean up URLs a bit

* Add link to GH for now, for older releases

* Update freeze

* Move license info higher on page

* Oops forgot freeze
  • Loading branch information
juliasilge authored Dec 3, 2024
1 parent 28533ee commit 1b38b33
Show file tree
Hide file tree
Showing 6 changed files with 91 additions and 23 deletions.
17 changes: 17 additions & 0 deletions _freeze/download/execute-results/html.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
{
"hash": "483269ee203b9553526b6e0ba8fdc2d2",
"result": {
"engine": "knitr",
"markdown": "---\ntitle: \"Download Positron\"\nparams:\n version: \"2024.12.0-96\"\n---\n\n\n\n\nFind out what you need to know to [get started](start.qmd) using Positron, then download the installer for your platform.\n\nPlease review [Positron's license agreement](licensing.qmd). Your acceptance of this license agreement is required as a condition to proceeding with your download or use of the software.\n\n\n\n\n::: {.cell .plain}\n::: {.cell-output-display}\n\n\n|Platform |Download |Size |\n|:-----------------------------------------|:-----------------------------------|:----|\n|Windows 10, 11 x64 (system level install) |[Positron-2024.12.0-96-Setup.exe](https://cdn.posit.co/positron/prereleases/win/x86_64/Positron-2024.12.0-96-Setup.exe)|222M |\n|Windows 10, 11 x64 (user level install) |[Positron-2024.12.0-96-UserSetup.exe](https://cdn.posit.co/positron/prereleases/win/x86_64/Positron-2024.12.0-96-UserSetup.exe)|222M |\n|MacOS 10.15+ (universal) |[Positron-2024.12.0-96.dmg](https://cdn.posit.co/positron/prereleases/mac/universal/Positron-2024.12.0-96.dmg)|629M |\n|Debian-based Linux (Ubuntu 22+) |[Positron-2024.12.0-96.deb](https://cdn.posit.co/positron/prereleases/deb/x86_64/Positron-2024.12.0-96.deb)|227M |\n|Red Hat-based Linux (RHEL9) |[Positron-2024.12.0-96.rpm](https://cdn.posit.co/positron/prereleases/rpm/x86_64/Positron-2024.12.0-96.rpm)|334M |\n\n\n:::\n:::\n\n\n\n\n<br>\n\nOlder releases [are available on GitHub](https://github.com/posit-dev/positron/releases).",
"supporting": [
"download_files"
],
"filters": [
"rmarkdown/pagebreak.lua"
],
"includes": {},
"engineDependencies": {},
"preserve": {},
"postProcess": true
}
}
7 changes: 7 additions & 0 deletions _freeze/site_libs/clipboard/clipboard.min.js

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

16 changes: 10 additions & 6 deletions _quarto.yml
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,12 @@ project:
render:
- "*.qmd"

execute:
freeze: auto

website:
favicon: "images/favicon.svg"
announcement:
announcement:
icon: info-circle
dismissable: false
content: "Positron is available for beta testing and [may not yet be a good fit for you](start.qmd#is-positron-for-me). If you are interested in experimenting with it, we welcome your [feedback](feedback.qmd)!"
Expand All @@ -32,12 +35,12 @@ website:
href: "https://docs.posit.co/"
- text: "<img alt='Link to main Posit site' src='images/posit-icon-fullcolor.svg' id='footer-right-posit-logo'>"
href: "https://posit.co/"
navbar:
navbar:
left:
- text: "Get Started"
href: start.qmd
href: start.qmd
- text: "Guides"
href: interpreters.qmd
href: interpreters.qmd
- text: "Help"
href: troubleshooting.qmd

Expand All @@ -46,6 +49,7 @@ website:
style: "docked"
contents:
- start.qmd
- download.qmd
- extensions.qmd

- title: "Guides"
Expand All @@ -66,5 +70,5 @@ website:
contents:
- troubleshooting.qmd
- feedback.qmd
- faqs.qmd
- faqs.qmd

53 changes: 53 additions & 0 deletions download.qmd
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
---
title: "Download Positron"
params:
version: "2024.12.0-96"
---

Find out what you need to know to [get started](start.qmd) using Positron, then download the installer for your platform.

Please review [Positron's license agreement](licensing.qmd). Your acceptance of this license agreement is required as a condition to proceeding with your download or use of the software.

```{r}
#| echo: false
#| classes: plain
library(purrr)
library(glue)
library(httr)
cdn_url <- "https://cdn.posit.co/positron/prereleases/"
urls <- list(
glue("{cdn_url}win/x86_64/Positron-{params$version}-Setup.exe"),
glue("{cdn_url}win/x86_64/Positron-{params$version}-UserSetup.exe"),
glue("{cdn_url}mac/universal/Positron-{params$version}.dmg"),
glue("{cdn_url}deb/x86_64/Positron-{params$version}.deb"),
glue("{cdn_url}rpm/x86_64/Positron-{params$version}.rpm")
)
cloudfront_headers <- map(urls, HEAD) |> map(headers)
file_sizes <- map(cloudfront_headers, "content-length") |>
map(fs::fs_bytes) |>
map_chr(as.character)
file_names_only <- stringr::str_extract(urls, "[^\\/]+$")
markdown_links <- glue("[{file_names_only}]({urls})")
download_table <- data.frame(
Platform = c(
"Windows 10, 11 x64 (system level install)",
"Windows 10, 11 x64 (user level install)",
"MacOS 10.15+ (universal)",
"Debian-based Linux (Ubuntu 22+)",
"Red Hat-based Linux (RHEL9)"
),
Download = markdown_links,
Size = file_sizes
)
knitr::kable(download_table)
```

<br>

Older releases [are available on GitHub](https://github.com/posit-dev/positron/releases).
9 changes: 2 additions & 7 deletions index.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
pagetitle: "Positron"
toc: false
editor: source
description: |
description: |
A next-generation data science IDE
hide-description: true
---
Expand All @@ -19,15 +19,10 @@ hide-description: true

{{< video https://www.youtube.com/embed/8uRcB34Hhsw >}}

Find out what you need to know to [get started](start.qmd) using Positron, and explore our user guides on topics such as [choosing interpreters](interpreters.qmd) and the [Data Explorer](data-explorer.qmd). Our [FAQs](faqs.qmd) cover some common questions you may have.
Find out what you need to know to [get started](start.qmd) using Positron, and then [download an installer](download.qmd). Explore our user guides on topics such as [choosing interpreters](interpreters.qmd) and the [Data Explorer](data-explorer.qmd). Our [FAQs](faqs.qmd) cover some common questions you may have.

Positron is built on [Code OSS](https://github.com/microsoft/vscode). To learn about basic features like commands, settings, using source control, and more, see the [VS Code documentation](https://code.visualstudio.com/docs).

## Install Positron

Install Positron from our [Releases](https://github.com/posit-dev/positron/releases) page on GitHub.

Currently, Positron is producing pre-release builds from a continuous integration (CI) system for macOS, Windows, and Linux. These pre-release builds are tagged with a version number on our Github repository. Select the build you want to download, then click on **Assets** and download the `.dmg` (for Mac), `.exe` (for Windows), `.deb` (for Ubuntu/Debian), or `.rpm` (for Red Hat) file.

## Share your feedback about Positron

Expand Down
12 changes: 2 additions & 10 deletions start.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ Positron is an early stage project under active development. We don't expect it

## Machine prerequisites

Before installing Positron, ensure your Python and/or R environments are ready to work with Positron. You don't need to install both, but Positron doesn't bundle either Python or R.
Before [installing](download.qmd) Positron, ensure your Python and/or R environments are ready to work with Positron. You don't need to install both, but Positron doesn't bundle either Python or R.

### Windows prerequisites

Expand Down Expand Up @@ -62,17 +62,9 @@ pak::pak(c("usethis", "cli", "crayon", "rlang", "roxygen2", "pkgload"))
install.packages(c("usethis", "cli", "crayon", "rlang", "roxygen2", "pkgload"))
```

## Installing Positron

Install Positron from our [Releases](https://github.com/posit-dev/positron/releases) page on GitHub.

Currently, Positron is producing beta release builds from a continuous integration (CI) system for macOS, Windows, and Linux. Release builds are tagged with a version number on our Github repository. Select the release you want to download, then click on **Assets** and download the `.dmg` (for Mac), `.exe` (for Windows), `.deb` (for Ubuntu/Debian), or `.rpm` (for Red Hat) file.

Learn more about [updating Positron](updating.qmd) after you have first installed it.

## Add Positron to your path

You can add Positron to your path via the command *Install 'positron' command in PATH*:
After you have [installed Positron](download.qmd), you can add Positron to your path via the command *Install 'positron' command in PATH*:

![Add Positron to your path](images/positron-path.png)

Expand Down

0 comments on commit 1b38b33

Please sign in to comment.