From 1b38b332ec6644385df5be4a3fca13de46291cbf Mon Sep 17 00:00:00 2001
From: Julia Silge <julia.silge@gmail.com>
Date: Tue, 3 Dec 2024 15:30:44 -0700
Subject: [PATCH] New downloads page (#26)

* 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
---
 _freeze/download/execute-results/html.json   | 17 +++++++
 _freeze/site_libs/clipboard/clipboard.min.js |  7 +++
 _quarto.yml                                  | 16 +++---
 download.qmd                                 | 53 ++++++++++++++++++++
 index.qmd                                    |  9 +---
 start.qmd                                    | 12 +----
 6 files changed, 91 insertions(+), 23 deletions(-)
 create mode 100644 _freeze/download/execute-results/html.json
 create mode 100644 _freeze/site_libs/clipboard/clipboard.min.js
 create mode 100644 download.qmd

diff --git a/_freeze/download/execute-results/html.json b/_freeze/download/execute-results/html.json
new file mode 100644
index 0000000..a92a1dd
--- /dev/null
+++ b/_freeze/download/execute-results/html.json
@@ -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
+  }
+}
\ No newline at end of file
diff --git a/_freeze/site_libs/clipboard/clipboard.min.js b/_freeze/site_libs/clipboard/clipboard.min.js
new file mode 100644
index 0000000..1103f81
--- /dev/null
+++ b/_freeze/site_libs/clipboard/clipboard.min.js
@@ -0,0 +1,7 @@
+/*!
+ * clipboard.js v2.0.11
+ * https://clipboardjs.com/
+ *
+ * Licensed MIT © Zeno Rocha
+ */
+!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.ClipboardJS=e():t.ClipboardJS=e()}(this,function(){return n={686:function(t,e,n){"use strict";n.d(e,{default:function(){return b}});var e=n(279),i=n.n(e),e=n(370),u=n.n(e),e=n(817),r=n.n(e);function c(t){try{return document.execCommand(t)}catch(t){return}}var a=function(t){t=r()(t);return c("cut"),t};function o(t,e){var n,o,t=(n=t,o="rtl"===document.documentElement.getAttribute("dir"),(t=document.createElement("textarea")).style.fontSize="12pt",t.style.border="0",t.style.padding="0",t.style.margin="0",t.style.position="absolute",t.style[o?"right":"left"]="-9999px",o=window.pageYOffset||document.documentElement.scrollTop,t.style.top="".concat(o,"px"),t.setAttribute("readonly",""),t.value=n,t);return e.container.appendChild(t),e=r()(t),c("copy"),t.remove(),e}var f=function(t){var e=1<arguments.length&&void 0!==arguments[1]?arguments[1]:{container:document.body},n="";return"string"==typeof t?n=o(t,e):t instanceof HTMLInputElement&&!["text","search","url","tel","password"].includes(null==t?void 0:t.type)?n=o(t.value,e):(n=r()(t),c("copy")),n};function l(t){return(l="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t})(t)}var s=function(){var t=0<arguments.length&&void 0!==arguments[0]?arguments[0]:{},e=t.action,n=void 0===e?"copy":e,o=t.container,e=t.target,t=t.text;if("copy"!==n&&"cut"!==n)throw new Error('Invalid "action" value, use either "copy" or "cut"');if(void 0!==e){if(!e||"object"!==l(e)||1!==e.nodeType)throw new Error('Invalid "target" value, use a valid Element');if("copy"===n&&e.hasAttribute("disabled"))throw new Error('Invalid "target" attribute. Please use "readonly" instead of "disabled" attribute');if("cut"===n&&(e.hasAttribute("readonly")||e.hasAttribute("disabled")))throw new Error('Invalid "target" attribute. You can\'t cut text from elements with "readonly" or "disabled" attributes')}return t?f(t,{container:o}):e?"cut"===n?a(e):f(e,{container:o}):void 0};function p(t){return(p="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t})(t)}function d(t,e){for(var n=0;n<e.length;n++){var o=e[n];o.enumerable=o.enumerable||!1,o.configurable=!0,"value"in o&&(o.writable=!0),Object.defineProperty(t,o.key,o)}}function y(t,e){return(y=Object.setPrototypeOf||function(t,e){return t.__proto__=e,t})(t,e)}function h(n){var o=function(){if("undefined"==typeof Reflect||!Reflect.construct)return!1;if(Reflect.construct.sham)return!1;if("function"==typeof Proxy)return!0;try{return Date.prototype.toString.call(Reflect.construct(Date,[],function(){})),!0}catch(t){return!1}}();return function(){var t,e=v(n);return t=o?(t=v(this).constructor,Reflect.construct(e,arguments,t)):e.apply(this,arguments),e=this,!(t=t)||"object"!==p(t)&&"function"!=typeof t?function(t){if(void 0!==t)return t;throw new ReferenceError("this hasn't been initialised - super() hasn't been called")}(e):t}}function v(t){return(v=Object.setPrototypeOf?Object.getPrototypeOf:function(t){return t.__proto__||Object.getPrototypeOf(t)})(t)}function m(t,e){t="data-clipboard-".concat(t);if(e.hasAttribute(t))return e.getAttribute(t)}var b=function(){!function(t,e){if("function"!=typeof e&&null!==e)throw new TypeError("Super expression must either be null or a function");t.prototype=Object.create(e&&e.prototype,{constructor:{value:t,writable:!0,configurable:!0}}),e&&y(t,e)}(r,i());var t,e,n,o=h(r);function r(t,e){var n;return function(t){if(!(t instanceof r))throw new TypeError("Cannot call a class as a function")}(this),(n=o.call(this)).resolveOptions(e),n.listenClick(t),n}return t=r,n=[{key:"copy",value:function(t){var e=1<arguments.length&&void 0!==arguments[1]?arguments[1]:{container:document.body};return f(t,e)}},{key:"cut",value:function(t){return a(t)}},{key:"isSupported",value:function(){var t=0<arguments.length&&void 0!==arguments[0]?arguments[0]:["copy","cut"],t="string"==typeof t?[t]:t,e=!!document.queryCommandSupported;return t.forEach(function(t){e=e&&!!document.queryCommandSupported(t)}),e}}],(e=[{key:"resolveOptions",value:function(){var t=0<arguments.length&&void 0!==arguments[0]?arguments[0]:{};this.action="function"==typeof t.action?t.action:this.defaultAction,this.target="function"==typeof t.target?t.target:this.defaultTarget,this.text="function"==typeof t.text?t.text:this.defaultText,this.container="object"===p(t.container)?t.container:document.body}},{key:"listenClick",value:function(t){var e=this;this.listener=u()(t,"click",function(t){return e.onClick(t)})}},{key:"onClick",value:function(t){var e=t.delegateTarget||t.currentTarget,n=this.action(e)||"copy",t=s({action:n,container:this.container,target:this.target(e),text:this.text(e)});this.emit(t?"success":"error",{action:n,text:t,trigger:e,clearSelection:function(){e&&e.focus(),window.getSelection().removeAllRanges()}})}},{key:"defaultAction",value:function(t){return m("action",t)}},{key:"defaultTarget",value:function(t){t=m("target",t);if(t)return document.querySelector(t)}},{key:"defaultText",value:function(t){return m("text",t)}},{key:"destroy",value:function(){this.listener.destroy()}}])&&d(t.prototype,e),n&&d(t,n),r}()},828:function(t){var e;"undefined"==typeof Element||Element.prototype.matches||((e=Element.prototype).matches=e.matchesSelector||e.mozMatchesSelector||e.msMatchesSelector||e.oMatchesSelector||e.webkitMatchesSelector),t.exports=function(t,e){for(;t&&9!==t.nodeType;){if("function"==typeof t.matches&&t.matches(e))return t;t=t.parentNode}}},438:function(t,e,n){var u=n(828);function i(t,e,n,o,r){var i=function(e,n,t,o){return function(t){t.delegateTarget=u(t.target,n),t.delegateTarget&&o.call(e,t)}}.apply(this,arguments);return t.addEventListener(n,i,r),{destroy:function(){t.removeEventListener(n,i,r)}}}t.exports=function(t,e,n,o,r){return"function"==typeof t.addEventListener?i.apply(null,arguments):"function"==typeof n?i.bind(null,document).apply(null,arguments):("string"==typeof t&&(t=document.querySelectorAll(t)),Array.prototype.map.call(t,function(t){return i(t,e,n,o,r)}))}},879:function(t,n){n.node=function(t){return void 0!==t&&t instanceof HTMLElement&&1===t.nodeType},n.nodeList=function(t){var e=Object.prototype.toString.call(t);return void 0!==t&&("[object NodeList]"===e||"[object HTMLCollection]"===e)&&"length"in t&&(0===t.length||n.node(t[0]))},n.string=function(t){return"string"==typeof t||t instanceof String},n.fn=function(t){return"[object Function]"===Object.prototype.toString.call(t)}},370:function(t,e,n){var f=n(879),l=n(438);t.exports=function(t,e,n){if(!t&&!e&&!n)throw new Error("Missing required arguments");if(!f.string(e))throw new TypeError("Second argument must be a String");if(!f.fn(n))throw new TypeError("Third argument must be a Function");if(f.node(t))return c=e,a=n,(u=t).addEventListener(c,a),{destroy:function(){u.removeEventListener(c,a)}};if(f.nodeList(t))return o=t,r=e,i=n,Array.prototype.forEach.call(o,function(t){t.addEventListener(r,i)}),{destroy:function(){Array.prototype.forEach.call(o,function(t){t.removeEventListener(r,i)})}};if(f.string(t))return t=t,e=e,n=n,l(document.body,t,e,n);throw new TypeError("First argument must be a String, HTMLElement, HTMLCollection, or NodeList");var o,r,i,u,c,a}},817:function(t){t.exports=function(t){var e,n="SELECT"===t.nodeName?(t.focus(),t.value):"INPUT"===t.nodeName||"TEXTAREA"===t.nodeName?((e=t.hasAttribute("readonly"))||t.setAttribute("readonly",""),t.select(),t.setSelectionRange(0,t.value.length),e||t.removeAttribute("readonly"),t.value):(t.hasAttribute("contenteditable")&&t.focus(),n=window.getSelection(),(e=document.createRange()).selectNodeContents(t),n.removeAllRanges(),n.addRange(e),n.toString());return n}},279:function(t){function e(){}e.prototype={on:function(t,e,n){var o=this.e||(this.e={});return(o[t]||(o[t]=[])).push({fn:e,ctx:n}),this},once:function(t,e,n){var o=this;function r(){o.off(t,r),e.apply(n,arguments)}return r._=e,this.on(t,r,n)},emit:function(t){for(var e=[].slice.call(arguments,1),n=((this.e||(this.e={}))[t]||[]).slice(),o=0,r=n.length;o<r;o++)n[o].fn.apply(n[o].ctx,e);return this},off:function(t,e){var n=this.e||(this.e={}),o=n[t],r=[];if(o&&e)for(var i=0,u=o.length;i<u;i++)o[i].fn!==e&&o[i].fn._!==e&&r.push(o[i]);return r.length?n[t]=r:delete n[t],this}},t.exports=e,t.exports.TinyEmitter=e}},r={},o.n=function(t){var e=t&&t.__esModule?function(){return t.default}:function(){return t};return o.d(e,{a:e}),e},o.d=function(t,e){for(var n in e)o.o(e,n)&&!o.o(t,n)&&Object.defineProperty(t,n,{enumerable:!0,get:e[n]})},o.o=function(t,e){return Object.prototype.hasOwnProperty.call(t,e)},o(686).default;function o(t){if(r[t])return r[t].exports;var e=r[t]={exports:{}};return n[t](e,e.exports,o),e.exports}var n,r});
\ No newline at end of file
diff --git a/_quarto.yml b/_quarto.yml
index b8fa2e1..06f5df7 100644
--- a/_quarto.yml
+++ b/_quarto.yml
@@ -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)!"
@@ -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
 
@@ -46,6 +49,7 @@ website:
       style: "docked"
       contents:
         - start.qmd
+        - download.qmd
         - extensions.qmd
 
     - title: "Guides"
@@ -66,5 +70,5 @@ website:
       contents:
         - troubleshooting.qmd
         - feedback.qmd
-        - faqs.qmd                    
-  
+        - faqs.qmd
+
diff --git a/download.qmd b/download.qmd
new file mode 100644
index 0000000..a1a099c
--- /dev/null
+++ b/download.qmd
@@ -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).
\ No newline at end of file
diff --git a/index.qmd b/index.qmd
index 9595ae2..8f9e756 100644
--- a/index.qmd
+++ b/index.qmd
@@ -2,7 +2,7 @@
 pagetitle: "Positron"
 toc: false
 editor: source
-description: | 
+description: |
   A next-generation data science IDE
 hide-description: true
 ---
@@ -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
 
diff --git a/start.qmd b/start.qmd
index 4e8a330..d40e648 100644
--- a/start.qmd
+++ b/start.qmd
@@ -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
 
@@ -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)