Skip to content

re-submission: One click install by default #1162

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.

Sign up for GitHub

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

Closed
wants to merge 1 commit into from
Closed

re-submission: One click install by default #1162

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
29 changes: 0 additions & 29 deletions _data/downloads.yml
View file
Open in desktop

This file was deleted.

10 changes: 0 additions & 10 deletions _data/tutorials.yml
View file
Open in desktop

This file was deleted.

7 changes: 0 additions & 7 deletions _includes/tutorial-list.html
View file
Open in desktop

This file was deleted.

62 changes: 38 additions & 24 deletions _layouts/downloadpage.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,23 +16,24 @@
</ul>
</div>
<div class="main-download">
<h2>The most popular way to get Scala is either using Scala through sbt, the Scala build tool, or to use Scala through an IDE.</h2>
<h2>The easiest way to install Scala is through coursier.</h2>
<div class="install-steps">
<div class="step">
<img src="/resources/img/download/arrow-asset.png" alt="">
<div class="number-step">1</div>
<div class="text-step">
<h3>First, make sure you have the Java 8 JDK (or Java 11 JDK) installed.</h3>
<p>To check, open the terminal and type:</p>
<p><code>java -version</code><span>(Make sure you have version 1.8 or 11.)</span></p>
<p><i>(If you don't have it installed, download Java from <a href="https://www.oracle.com/java/technologies/javase-jdk8-downloads.html">Oracle Java 8</a>, <a href="https://www.oracle.com/java/technologies/javase-jdk11-downloads.html">Oracle Java 11</a>, or <a href="https://adoptopenjdk.net/">AdoptOpenJDK 8/11</a>. Refer <a href="https://docs.scala-lang.org/overviews/jdk-compatibility/overview.html">JDK Compatibility</a> for Scala/Java compatiblity detail.</i></p>
<h3>First, install Java, Scala, and all related command-line tools.</h3>
Copy link
Member

Choose a reason for hiding this comment

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

This doesn't convey clearly that Coursier is going to handle all of that for me.

Suggested replacement: "Install Coursier, which will install everything else for you: Java, Scala, and related command-line tools."

<div id="download-step-one">
<p>Download <a href="https://get-coursier.io/docs/cli-overview.html#install-native-launcher">the native launcher of coursier</a> then install everything with:</p>
<p><code>$ ./cs setup</code><span> (Adapt to your operating system)</span></p>
</div>
<p>(See <a href="https://get-coursier.io/docs/cli-overview.html#install-native-launcher">the instructions for other operating systems</a>.)
</div>
</div>
<div class="step">
<div class="number-step">2</div>
<div class="text-step">
<h3>Then, install Scala:</h3>
<p>...either by installing an IDE such as IntelliJ, or sbt, Scala's build tool.</p>
<h3>Then, install an IDE, or get started with sbt</h3>
</div>
</div>
<div class="download-options">
Expand All @@ -42,34 +43,36 @@ <h3>Then, install Scala:</h3>
<img src="/resources/img/download/arrow-left.png" alt="">
<p>Best if you prefer a full-featured IDE (recommended for beginners)</p>
</div>
<a href="" class="btn-download" id="download-intellij-link">
<a href="https://www.jetbrains.com/idea/download/" class="btn-download">
<i class="fa fa-download"></i>
<span>Download intellij</span>
<span>Download IntelliJ</span>
</a>
<ul>
{% include tutorial-list.html column=1 %}
<li><a href="/documentation/getting-started-intellij-track/getting-started-with-scala-in-intellij.html"><i class="fa fa-file-text-o"></i>Getting Started with Scala in IntelliJ</a></li>
<li><a href="/documentation/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.html"><i class="fa fa-file-text-o"></i>Building a Scala Project with IntelliJ and sbt</a></li>
<li><a href="/documentation/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.html"><i class="fa fa-file-text-o"></i>Testing Scala in IntelliJ with ScalaTest</a></li>
</ul>
</div>
<div class="download-sbt">
<div class="description">
<img src="/resources/img/download/arrow-right.png" alt="">
<p>Best if you are familiar with the command line</p>
</div>
<a href="" class="btn-download" id="download-sbt-link">
<a href="/documentation/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html" class="btn-download" id="download-sbt-link">
<i class="fa fa-download"></i>
<span>Download Sbt</span>
<span>Get started with sbt</span>
</a>
<ul>
{% include tutorial-list.html column=0 %}
<li><a href="/documentation/getting-started-sbt-track/getting-started-with-scala-and-sbt-on-the-command-line.html"><i class="fa fa-file-text-o"></i>Getting Started with Scala and sbt on the Command Line</a></li>
<li><a href="/documentation/getting-started-sbt-track/testing-scala-with-sbt-on-the-command-line.html"><i class="fa fa-file-text-o"></i>Testing Scala with sbt and ScalaTest on the Command Line</a></li>
</ul>
</div>
</div>

<p class="bottom-lead">
Compared to other programming languages, installing Scala is a bit unusual. Scala is unusual because it is usually installed for each of your Scala projects rather than being installed system-wide. Both of the above options manage (via sbt) a specific Scala version per Scala project you create.
<br><br>
But it's also possible to "install" Scala in numerous other ways; e.g., grab Scala binaries and use Scala from the command line or use Scala in your browser!
<br><br>
Compared to other programming languages, installing Scala is a bit unusual.
In addition to the system-wide installation mentioned above, build tools such as sbt will automatically manage a specific Scala version per Scala project you create.
This makes sure that there are no version conflicts between different Scala projects on your computer.
Copy link
Member

Choose a reason for hiding this comment

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

This makes sure that there are no version conflicts between different Scala projects on your computer

Perhaps: "This allows each Scala project on your computer to use any version of Scala it wants, without interfering with each other."

</p>

<!-- <p class="bottom-lead"><h2>Other</h2></p> -->
Expand Down Expand Up @@ -108,11 +111,22 @@ <h3>License</h3>
</div>
</div>

{% for step in site.data.downloads.stepOne %}
<div style="display:none" id="stepOne-{{step.os}}">{{step.text}}</div>
{% endfor %} {% for intellijUrl in site.data.downloads.intellijUrls %}
<div style="display:none" id="intellij-{{intellijUrl.os}}">{{intellijUrl.url}}</div>
{% endfor %} {% for sbtUrl in site.data.downloads.sbtUrls %}
<div style="display:none" id="sbt-{{sbtUrl.os}}">{{sbtUrl.url}}</div>
{% endfor %}
<!-- Hidden elements whose content are used to provide OS-specific download instructions.
-- This is handled in `resources/js/functions.js`.
-->

<div style="display:none" id="stepOne-linux">
<p><code>$ curl -Lo cs https://git.io/coursier-cli-linux && chmod +x cs && ./cs setup</code></p>
</div>
<div style="display:none" id="stepOne-unix">
<p>Follow <a href="https://get-coursier.io/docs/cli-overview.html#install-native-launcher" target="_blank">the instructions to install the <code>cs</code> launcher</a> then run:</p>
<p><code>$ ./cs setup</code></p>
</div>
<div style="display:none" id="stepOne-macos">
<p><code>$ curl -Lo cs https://git.io/coursier-cli-macos && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup</code></p>
<p><span>Alternatively you can use Homebrew: </span><code>$ brew install coursier/formulas/coursier && cs setup</code></p>
</div>
<div style="display:none" id="stepOne-windows">
<p>Download and execute <a href="https://git.io/coursier-cli-windows-exe">the Scala installer for Windows</a> based on coursier</p>
</div>
</section>
4 changes: 0 additions & 4 deletions resources/js/functions.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -260,11 +260,7 @@ function getOS() {
$(document).ready(function() {
if ($(".main-download").length) {
var os = getOS();
var intelliJlink = $("#intellij-" + os).text();
var sbtLink = $("#sbt-" + os).text();
var stepOneContent = $("#stepOne-" + os).html()
$("#download-intellij-link").attr("href", intelliJlink);
$("#download-sbt-link").attr("href", sbtLink);
$("#download-step-one").html(stepOneContent);
}
});
Expand Down