Skip to content

Commit 8fc278a

Browse files
authored
Merge pull request #1344 from scalacenter/getting-started/new-layout
Converge on one get-started instructions, recommend on landing page
2 parents ab70780 + 9fe8fe6 commit 8fc278a

24 files changed

+221
-359
lines changed

_data/scala-releases.yml

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
- category: current_version
2+
title: Current 3.1.x release
3+
version: 3.1.1
4+
release_date: February 1, 2022
5+
- category: current_version
6+
title: Current 2.13.x release
7+
version: 2.13.8
8+
release_date: January 12, 2022
9+
- category: maintenance_version
10+
title: Latest 2.12.x maintenance release
11+
version: 2.12.15
12+
release_date: September 14, 2021
13+
- category: maintenance_version
14+
title: Last 2.11.x maintenance release
15+
version: 2.11.12
16+
release_date: November 9, 2017
17+
- category: maintenance_version
18+
title: Last 2.10.x maintenance release
19+
version: 2.10.7
20+
release_date: November 9, 2017

_downloads/2019-08-05-2.12.9.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "August 05, 2019"
77
show_resources: "true"
88
permalink: /download/2.12.9.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.12.9.tgz", "https://downloads.lightbend.com/scala/2.12.9/scala-2.12.9.tgz", "Mac OS X, Unix, Cygwin", "19.69M"],
1213
["-main-windows", "scala-2.12.9.msi", "https://downloads.lightbend.com/scala/2.12.9/scala-2.12.9.msi", "Windows (msi installer)", "124.01M"],

_downloads/2019-09-10-2.12.10.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "September 10, 2019"
77
show_resources: "true"
88
permalink: /download/2.12.10.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.12.10.tgz", "https://downloads.lightbend.com/scala/2.12.10/scala-2.12.10.tgz", "Mac OS X, Unix, Cygwin", "19.71M"],
1213
["-main-windows", "scala-2.12.10.msi", "https://downloads.lightbend.com/scala/2.12.10/scala-2.12.10.msi", "Windows (msi installer)", "124M"],

_downloads/2020-03-16-2.12.11.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "March 16, 2020"
77
show_resources: "true"
88
permalink: /download/2.12.11.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.12.11.tgz", "https://downloads.lightbend.com/scala/2.12.11/scala-2.12.11.tgz", "Mac OS X, Unix, Cygwin", "19.83M"],
1213
["-main-windows", "scala-2.12.11.msi", "https://downloads.lightbend.com/scala/2.12.11/scala-2.12.11.msi", "Windows (msi installer)", "124.33M"],

_downloads/2020-07-13-2.12.12.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "July 13, 2020"
77
show_resources: "true"
88
permalink: /download/2.12.12.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.12.12.tgz", "https://downloads.lightbend.com/scala/2.12.12/scala-2.12.12.tgz", "Mac OS X, Unix, Cygwin", "19.87M"],
1213
["-main-windows", "scala-2.12.12.msi", "https://downloads.lightbend.com/scala/2.12.12/scala-2.12.12.msi", "Windows (msi installer)", "124.70M"],

_downloads/2021-01-12-2.12.13.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "January 12, 2021"
77
show_resources: "true"
88
permalink: /download/2.12.13.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.12.13.tgz", "https://downloads.lightbend.com/scala/2.12.13/scala-2.12.13.tgz", "Mac OS X, Unix, Cygwin", "20.03M"],
1213
["-main-windows", "scala-2.12.13.msi", "https://downloads.lightbend.com/scala/2.12.13/scala-2.12.13.msi", "Windows (msi installer)", "125.69M"],

_downloads/2021-02-22-2.13.5.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "February 22, 2021"
77
show_resources: "true"
88
permalink: /download/2.13.5.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.13.5.tgz", "https://downloads.lightbend.com/scala/2.13.5/scala-2.13.5.tgz", "Mac OS X, Unix, Cygwin", "21.98M"],
1213
["-main-windows", "scala-2.13.5.msi", "https://downloads.lightbend.com/scala/2.13.5/scala-2.13.5.msi", "Windows (msi installer)", "130.48M"],

_downloads/2021-05-28-2.12.14.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "May 28, 2021"
77
show_resources: "true"
88
permalink: /download/2.12.14.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.12.14.tgz", "https://downloads.lightbend.com/scala/2.12.14/scala-2.12.14.tgz", "Mac OS X, Unix, Cygwin", "20.11M"],
1213
["-main-windows", "scala-2.12.14.msi", "https://downloads.lightbend.com/scala/2.12.14/scala-2.12.14.msi", "Windows (msi installer)", "125.83M"],

_downloads/2021-09-14-2.12.15.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "September 14, 2021"
77
show_resources: "true"
88
permalink: /download/2.12.15.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.12.15.tgz", "https://downloads.lightbend.com/scala/2.12.15/scala-2.12.15.tgz", "Mac OS X, Unix, Cygwin", "20.11M"],
1213
["-main-windows", "scala-2.12.15.msi", "https://downloads.lightbend.com/scala/2.12.15/scala-2.12.15.msi", "Windows (msi installer)", "125.48M"],

_downloads/2021-11-01-2.13.7.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "November 01, 2021"
77
show_resources: "true"
88
permalink: /download/2.13.7.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.13.7.tgz", "https://downloads.lightbend.com/scala/2.13.7/scala-2.13.7.tgz", "Mac OS X, Unix, Cygwin", "22.64M"],
1213
["-main-windows", "scala-2.13.7.msi", "https://downloads.lightbend.com/scala/2.13.7/scala-2.13.7.msi", "Windows (msi installer)", "134.43M"],

_downloads/2022-01-12-2.13.8.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ release_date: "January 12, 2022"
77
show_resources: "true"
88
permalink: /download/2.13.8.html
99
requirements: "This Scala software distribution can be installed on any Unix-like or Windows system. It requires Java 8 or later, available <a href='https://www.java.com/'>here</a>."
10+
license: <a href="https://www.scala-lang.org/license/">Apache License, Version 2.0</a>
1011
resources: [
1112
["-main-unixsys", "scala-2.13.8.tgz", "https://downloads.lightbend.com/scala/2.13.8/scala-2.13.8.tgz", "Mac OS X, Unix, Cygwin", "22.65M"],
1213
["-main-windows", "scala-2.13.8.msi", "https://downloads.lightbend.com/scala/2.13.8/scala-2.13.8.msi", "Windows (msi installer)", "134.43M"],

_includes/download-resource-list.html

Lines changed: 41 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -1,51 +1,56 @@
1-
<div class="content-primary">
1+
<div class="text-step">
22

3-
<h3 id="other-releases">Other Releases</h3>
3+
{% if page.resources.size > 0 %}
4+
<h3>Other resources</h3>
5+
6+
<p>You can find the installer download links for other operating systems, as well as documentation and source code
7+
archives for Scala {{page.release_version}} below.</p>
8+
9+
<table>
10+
<thead>
11+
<tr>
12+
<th style="text-align: left">Archive</th>
13+
<th style="text-align: left">System</th>
14+
{% unless page.dont_show_sizes %}
15+
<th style="text-align: left">Size</th>
16+
{% endunless %}
17+
</tr>
18+
</thead>
19+
20+
<tbody>
21+
{% for resource in page.resources %}
22+
<tr>
23+
<td style="text-align: left">
24+
<a id="#link{{ resource[0] }}" href="{{ resource[2] }}">
25+
{{ resource[1] }}
26+
</a>
27+
</td>
28+
<td style="text-align: left">{{ resource[3] }}</td>
29+
{% unless page.dont_show_sizes %}
30+
<td style="text-align: left">{{ resource[4] }}</td>
31+
{% endunless %}
32+
</tr>
33+
{% endfor %}
34+
</tbody>
35+
</table>
36+
{% endif %}
37+
38+
<h2 id="other-releases">Other Releases</h2>
439

540
<p>You can find the links to prior versions or the latest development version below.
641
To see a detailed list of changes for each version of Scala please refer to the <a href="{{ site.baseurl }}/download/changelog.html">changelog</a>.</p>
742

843
<p>Note that different major releases of Scala (e.g. Scala 2.11.x and Scala 2.12.x) are not binary compatible with each other.</p>
944

1045
<ul>
11-
{% for release in page.other_releases %}
12-
<li>{{ release[1] }}:
46+
{% for release in site.data.scala-releases %}
47+
<li>{{ release.title }}:
1348
<ul>
14-
<li><a href="/download/{{ release[2] }}.html">Scala {{ release[2] }}</a> - Released on {{ release[3] }}</li>
49+
<li><a href="/download/{{ release.version }}.html">Scala {{ release.version }}</a> - Released on {{ release.release_date }}</li>
1550
</ul></li>
1651
{% endfor %}
1752
<li><a href="https://scala-lang.org/files/archive/nightly/">Nightly builds</a></li>
1853
<li><a href="/download/changelog.html">Changelog</a></li>
19-
<li><a href="/download/all.html">All previous releases</a></li>
54+
<li><a href="/download/all.html">All Scala releases</a></li>
2055
</ul>
21-
22-
<h3>Other resources</h3>
23-
24-
<p>You can find the installer download links for other operating systems, as well as documentation and source code archives for Scala {{page.release_version}} below.</p>
25-
26-
<table>
27-
<thead><tr>
28-
<th style="text-align: left">Archive</th>
29-
<th style="text-align: left">System</th>
30-
{% unless page.dont_show_sizes %}
31-
<th style="text-align: left">Size</th>
32-
{% endunless %}
33-
</tr></thead>
34-
35-
<tbody>
36-
{% for resource in page.resources %}
37-
<tr>
38-
<td style="text-align: left">
39-
<a id="#link{{ resource[0] }}" href="{{ resource[2] }}">
40-
{{ resource[1] }}
41-
</a>
42-
</td>
43-
<td style="text-align: left">{{ resource[3] }}</td>
44-
{% unless page.dont_show_sizes %}
45-
<td style="text-align: left">{{ resource[4] }}</td>
46-
{% endunless %}
47-
</tr>
48-
{% endfor %}
49-
</tbody>
50-
</table>
5156
</div>

_includes/downloads-scala2.html

Lines changed: 45 additions & 83 deletions
Original file line numberDiff line numberDiff line change
@@ -1,87 +1,49 @@
1-
<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>
2-
<div class="install-steps">
3-
<div class="step arrow">
4-
<img src="/resources/img/download/arrow-asset.png" alt="">
5-
<div class="number-step">1</div>
6-
<div class="text-step">
7-
<h3>First, make sure you have the Java 8 JDK (or Java 11 JDK) installed.</h3>
8-
<p>To check, open the terminal and type:</p>
9-
<p><code>java -version</code><span>(Make sure you have version 1.8 or 11.)</span></p>
10-
<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>
11-
</div>
12-
</div>
13-
<div class="step">
14-
<div class="number-step">2</div>
15-
<div class="text-step">
16-
<h3>Then, install Scala:</h3>
17-
<p>...either by installing an IDE such as IntelliJ, or sbt, Scala's build tool.</p>
18-
</div>
19-
</div>
20-
<div class="download-options">
21-
<div class="download-left">
22-
<span class="or">or</span>
23-
<div class="description">
24-
<img src="/resources/img/download/arrow-left.png" alt="">
25-
<p>Best if you prefer a full-featured IDE (recommended for beginners)</p>
26-
</div>
27-
<a href="https://www.jetbrains.com/idea" class="btn-download" id="download-intellij-link">
28-
<i class="fa fa-download"></i>
29-
<span>Download intellij</span>
30-
</a>
31-
<ul>
32-
{% include tutorial-list.html column=1 %}
33-
</ul>
34-
</div>
35-
<div class="download-right">
36-
<div class="description">
37-
<img src="/resources/img/download/arrow-right.png" alt="">
38-
<p>Best if you are familiar with the command line</p>
39-
</div>
40-
<a href="https://www.scala-sbt.org/download.html" class="btn-download" id="download-sbt-link">
41-
<i class="fa fa-download"></i>
42-
<span>Download Sbt</span>
43-
</a>
44-
<ul>
45-
{% include tutorial-list.html column=0 %}
46-
</ul>
47-
</div>
48-
</div>
49-
50-
<p class="bottom-lead">
51-
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.
52-
<br><br>
53-
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!
54-
<br><br>
55-
</p>
1+
<p>Are you looking for <a href="{{ site.baseurl }}/download/all.html">another release</a> of Scala?</p>
2+
<h3>Release Notes</h3>
3+
For a summary of important changes, see the <a href="https://github.com/scala/scala/releases">GitHub release notes</a>.
4+
<br/><small>(Or consult our archive of <a href="{{ site.baseurl }}/blog/announcements/">older release
5+
notes</a>.)</small>
566

57-
<!-- <p class="bottom-lead"><h2>Other</h2></p> -->
58-
59-
<div class="step other-ways-lead">
60-
<div class="number-step"><i class="fa fa-ellipsis-h" aria-hidden="true"></i></div>
61-
<div class="text-step">
62-
<h2>Other ways to install Scala</h2>
63-
<ul>
64-
<li>
65-
<a id="download-binaries">Download the Scala binaries for <span id="users-os"></span></a>
66-
<br/><span class="install"><a href="{{ site.baseurl }}/download/install.html">Need help running the binaries?</a></span>
67-
</li>
68-
<li>Using <a href="https://sdkman.io/">SDKMAN!</a>, you can easily <a href="https://sdkman.io/sdks#scala">install specific versions of Scala</a> on any platform with <code>sdk install scala {{ site.scalaversion }}</code></li>
69-
<li>On macOS you can also use <a href="https://brew.sh/">Homebrew</a> and existing <a href="https://formulae.brew.sh/formula/scala">Scala Formulae</a><br/><code>brew update</code><br/><code>brew install scala</code></li>
70-
<li>With <a href="https://www.macports.org/">MacPorts</a>, you can get Scala using <code>sudo port install scala2.x</code>command.<br/> For example to install Scala 2.12 simply use<code>sudo port install scala2.12</code></li>
71-
<li>Use <a href="https://scastie.scala-lang.org">Scastie</a> to run single-file Scala programs in your browser using multiple Scala compilers; the production Scala 2.x compilers, Scala.js, Dotty, and Typelevel Scala. Save and share executable Scala code snippets.</li>
72-
<li>Try Scala in the browser via <a href="https://scalafiddle.io/">ScalaFiddle</a>. This lets you run single-file Scala programs in your browser using Scala.js, including graphical/interactive examples such as <a href="https://scalafiddle.io/sf/KOsXSKv/0">Oscilloscope</a> or <a href="https://scalafiddle.io/sf/4beVrVc/1">Ray Tracer</a></li>
73-
<li><a href="https://ammonite.io/">Get Ammonite</a>, a popular Scala REPL</li>
74-
</ul>
75-
<p>Or are you looking for <a href="{{ site.baseurl }}/download/all.html">previous releases</a> of Scala?</p>
76-
</div>
7+
<div class="install-steps">
8+
<div class="text-step">
9+
<h2>Ways to Install This Release</h2>
10+
<ul>
11+
<li>
12+
Using <a
13+
href="https://docs.scala-lang.org/getting-started/index.html#using-the-scala-installer-recommended-way">Coursier
14+
CLI</a>, run:<br>
15+
<code>cs install scala:{{ page.release_version }} && cs install scalac:{{ page.release_version }}</code>.
16+
</li>
17+
<li>
18+
<a id="download-binaries">Download the Scala binaries for <span id="users-os"></span></a>
19+
<br /><span class="install"><a href="{{ site.baseurl }}/download/install.html">Need help running the
20+
binaries?</a></span>
21+
</li>
22+
<li><a href="/documentation/getting-started-intellij-track/getting-started-with-scala-in-intellij.html">Download and
23+
use Scala</a><span> with </span><a href="https://www.jetbrains.com/idea">IntelliJ</a><span> and then </span><a
24+
href="/documentation/getting-started-intellij-track/building-a-scala-project-with-intellij-and-sbt.html">build a
25+
project</a><span>, then </span><a
26+
href="/documentation/getting-started-intellij-track/testing-scala-in-intellij-with-scalatest.html">test it.</a>
27+
</li>
28+
<li>Using <a href="https://sdkman.io/">SDKMAN!</a>, you can easily <a href="https://sdkman.io/sdks#scala">install
29+
specific versions of Scala</a> on any platform with <code>sdk install scala {{ site.scalaversion }}</code></li>
30+
<li>On macOS you can also use <a href="https://brew.sh/">Homebrew</a> and existing <a
31+
href="https://formulae.brew.sh/formula/scala">Scala
32+
Formulae</a><br /><code>brew update</code><br /><code>brew install scala</code></li>
33+
<li>With <a href="https://www.macports.org/">MacPorts</a>, you can get Scala using
34+
<code>sudo port install scala2.x</code>command.<br /> For example to install Scala 2.12 simply
35+
use<code>sudo port install scala2.12</code></li>
36+
<li>Use <a href="https://scastie.scala-lang.org">Scastie</a> to run single-file Scala programs in your browser using
37+
multiple Scala compilers; the production Scala 2.x compilers, Scala.js, Dotty, and Typelevel Scala. Save and share
38+
executable Scala code snippets.</li>
39+
<li>Try Scala in the browser via <a href="https://scalafiddle.io/">ScalaFiddle</a>. This lets you run single-file
40+
Scala programs in your browser using Scala.js, including graphical/interactive examples such as <a
41+
href="https://scalafiddle.io/sf/KOsXSKv/0">Oscilloscope</a> or <a href="https://scalafiddle.io/sf/4beVrVc/1">Ray
42+
Tracer</a></li>
43+
<li><a href="https://ammonite.io/">Get Ammonite</a>, a popular Scala REPL</li>
44+
</ul>
7745
</div>
78-
79-
80-
<h3>Release Notes</h3>
81-
For a summary of important changes, see the <a href="https://github.com/scala/scala/releases">GitHub release notes</a>.
82-
<br/><small>(Or consult our archive of <a href="{{ site.baseurl }}/blog/announcements/">older release notes</a>.)</small>
83-
8446
{% include download-resource-list.html %}
85-
<h3>License</h3>
86-
<p>The Scala distribution is released under the {{page.license}}.</p>
8747
</div>
48+
<h3>License</h3>
49+
<p>The Scala {{ page.release_version }} distribution is released under the {{page.license}}.</p>

0 commit comments

Comments
 (0)