Merge remote-tracking branch 'origin/main' into dependabot/bundler/gi…

…thub-pages-232
scala · Nov 6, 2024 · 53dd001 · 53dd001
2 parents 14d9d35 + ec9081c
commit 53dd001
Show file tree

Hide file tree

Showing 94 changed files with 1,917 additions and 896 deletions.
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -281,7 +281,7 @@ GEM
       concurrent-ruby (~> 1.0)
     unicode-display_width (1.8.0)
     uri (0.13.0)
-    webrick (1.8.1)
+    webrick (1.8.2)
     yell (2.2.2)
     zeitwerk (2.6.7)
 

diff --git a/README.md b/README.md
@@ -1,6 +1,6 @@
 # Scala Documentation #
 
-[![Build Status](https://ci.scala-lang.org/api/badges/scala/docs.scala-lang/status.svg)](https://platform-ci.scala-lang.org/scala/docs.scala-lang)
+[![Build Status](https://github.com/scala/docs.scala-lang/actions/workflows/build.yml/badge.svg)](https://github.com/scala/docs.scala-lang/actions/workflows/build.yml?query=branch%3Amain)
 
 This repository contains the source for the Scala documentation website, as well as the source for "Scala Improvement Process" (SIP) documents.
 

diff --git a/_ba/tour/automatic-closures.md b/_ba/tour/automatic-closures.md
diff --git a/_config.yml b/_config.yml
@@ -15,9 +15,9 @@ keywords:
 - Document
 - Guide
 
-scala-version: 2.13.14
-scala-212-version: 2.12.19
-scala-3-version: 3.5.0
+scala-version: 2.13.15
+scala-212-version: 2.12.20
+scala-3-version: 3.5.2
 
 collections:
   style:

diff --git a/_data/doc-nav-header.yml b/_data/doc-nav-header.yml
@@ -1,5 +1,10 @@
 - title: Getting Started
-  url: "/getting-started/index.html"
+  url: "#"
+  submenu:
+    - title: Install Scala
+      url: "/getting-started/install-scala.html"
+    - title: Scala IDEs
+      url: "/getting-started/scala-ides.html"
 - title: Scala 3
   url: "#"
   submenu:

diff --git a/_data/footer.yml b/_data/footer.yml
@@ -21,13 +21,11 @@
   links:
     - title: Community
       url: "http://scala-lang.org/community/"
-    - title: Governance
-      url: "http://scala-lang.org/community/index.html#governance"
     - title: Scala Ambassadors
       url: "http://scala-lang.org/ambassadors/"
-    - title: Mailing Lists
-      url: "http://scala-lang.org/community/index.html#mailing-lists"
-    - title: Chat Rooms & More
+    - title: Forums
+      url: "http://scala-lang.org/community/index.html#forums"
+    - title: Chat
       url: "http://scala-lang.org/community/index.html#chat-rooms"
     - title: Libraries and Tools
       url: "http://scala-lang.org/community/index.html#community-libraries-and-tools"
@@ -43,16 +41,26 @@
 - title: Scala
   class: scala
   links:
+    - title: Governance
+      url: "http://scala-lang.org/governance/"
     - title: Blog
       url: "http://scala-lang.org/blog/"
     - title: Code of Conduct
       url: "http://scala-lang.org/conduct/"
     - title: License
       url: "http://scala-lang.org/license/"
+    - title: Security Policy
+      url: "http://scala-lang.org/security/"
 - title: Social
   class: social
   links:
     - title: GitHub
       url: "https://github.com/scala/scala"
+    - title: Mastodon
+      url: https://fosstodon.org/@scala_lang
     - title: Twitter
       url: "https://twitter.com/scala_lang"
+    - title: Discord
+      url: "https://discord.com/invite/scala"
+    - title: LinkedIn
+      url: "https://www.linkedin.com/company/scala-center/"
diff --git a/_data/nav-header.yml b/_data/nav-header.yml
@@ -8,5 +8,7 @@
   url: https://index.scala-lang.org
 - title: Community
   url: https://www.scala-lang.org/community/
+- title: Governance
+  url: https://www.scala-lang.org/governance/
 - title: Blog
   url: https://www.scala-lang.org/blog/
diff --git a/_data/overviews.yml b/_data/overviews.yml
@@ -161,6 +161,9 @@
       description: "A diverse and comprehensive set of libraries is important to any productive software ecosystem. While it is easy to develop and distribute Scala libraries, good library authorship goes beyond just writing code and publishing it. In this guide, we cover the important topic of Binary Compatibility."
       icon: puzzle-piece
       url: "core/binary-compatibility-for-library-authors.html"
+    - title: Nightly Versions of Scala
+      description: "We regularly publish 'nightlies' of both Scala 3 and Scala 2 so that users can preview and test the contents of upcoming releases. Here's how to find and use these versions."
+      url: "core/nightlies.html"
 
 - category: "Tools"
   description: "Reference material on core Scala tools like the Scala REPL and Scaladoc generation."

diff --git a/_data/setup-scala.yml b/_data/setup-scala.yml
@@ -2,5 +2,5 @@ linux-x86-64: curl -fL https://github.com/coursier/coursier/releases/latest/down
 linux-arm64: curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-pc-linux.gz | gzip -d > cs && chmod +x cs && ./cs setup
 macOS-x86-64: curl -fL https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup
 macOS-arm64: curl -fL https://github.com/VirtusLab/coursier-m1/releases/latest/download/cs-aarch64-apple-darwin.gz | gzip -d > cs && chmod +x cs && (xattr -d com.apple.quarantine cs || true) && ./cs setup
-macOS-brew: brew install coursier/formulas/coursier && cs setup
+macOS-brew: brew install coursier && coursier setup
 windows-link: https://github.com/coursier/coursier/releases/latest/download/cs-x86_64-pc-win32.zip
diff --git a/_es/tour/automatic-closures.md b/_es/tour/automatic-closures.md
diff --git a/_es/tour/multiple-parameter-lists.md b/_es/tour/multiple-parameter-lists.md
@@ -6,7 +6,7 @@ partof: scala-tour
 num: 15
 language: es
 
-next-page: automatic-closures
+next-page: operators
 previous-page: nested-functions
 ---
 

diff --git a/_es/tour/operators.md b/_es/tour/operators.md
@@ -7,7 +7,7 @@ num: 17
 language: es
 
 next-page: higher-order-functions
-previous-page: automatic-closures
+previous-page: multiple-parameter-lists
 ---
 
 En Scala, cualquier método el cual reciba un solo parámetro puede ser usado como un *operador de infijo (infix)*. Aquí se muestra la definición de la clase `MyBool`, la cual define tres métodos `and`, `or`, y `negate`.

diff --git a/_es/tour/tour-of-scala.md b/_es/tour/tour-of-scala.md
@@ -37,7 +37,6 @@ El [mecanismo de inferencia de tipos locales](type-inference.html) se encarga de
 
 En la práctica, el desarrollo de aplicaciones específicas para un dominio generalmente requiere de "Lenguajes de dominio específico" (DSL). Scala provee una única combinación de mecanismos del lenguaje que simplifican la creación de construcciones propias del lenguaje en forma de bibliotecas:
 * cualquier método puede ser usado como un operador de [infijo o postfijo](operators.html)
-* [las closures son construidas automáticamente dependiendo del tipo esperado](automatic-closures.html) (tipos objetivo).
 
 El uso conjunto de ambas características facilita la definición de nuevas sentencias sin tener que extender la sintaxis y sin usar facciones de meta-programación como tipo macros.
 

diff --git a/_fr/getting-started/index.md → _fr/getting-started/install-scala.md b/_fr/getting-started/index.md → _fr/getting-started/install-scala.md
diff --git a/_fr/tour/automatic-closures.md b/_fr/tour/automatic-closures.md
diff --git a/_includes/_markdown/install-cask.md b/_includes/_markdown/install-cask.md
@@ -0,0 +1,37 @@
+{% altDetails require-info-box 'Getting Cask' %}
+
+{% tabs cask-install class=tabs-build-tool %}
+
+{% tab 'Scala CLI' %}
+You can declare a dependency on Cask with the following `using` directive:
+```scala
+//> using dep "com.lihaoyi::cask::0.9.2"
+```
+{% endtab %}
+
+{% tab 'sbt' %}
+In your `build.sbt`, you can add a dependency on Cask:
+```scala
+lazy val example = project.in(file("example"))
+  .settings(
+    scalaVersion := "3.4.2",
+    libraryDependencies += "com.lihaoyi" %% "cask" % "0.9.2",
+    fork := true
+  )
+```
+{% endtab %}
+
+{% tab 'Mill' %}
+In your `build.sc`, you can add a dependency on Cask:
+```scala
+object example extends RootModule with ScalaModule {
+  def scalaVersion = "3.3.3"
+  def ivyDeps = Agg(
+    ivy"com.lihaoyi::cask::0.9.2"
+  )
+}
+```
+{% endtab %}
+
+{% endtabs %}
+{% endaltDetails %}
diff --git a/_ja/getting-started/index.md → _ja/getting-started/install-scala.md b/_ja/getting-started/index.md → _ja/getting-started/install-scala.md
diff --git a/_ja/index.md b/_ja/index.md
@@ -14,7 +14,7 @@ sections:
       - title: "入門"
         description: "あなたのコンピューターに Scala をインストールして、Scala コードを書きはじめよう！"
         icon: "fa fa-rocket"
-        link: /ja/getting-started/index.html
+        link: /ja/getting-started/install-scala.html
       - title: "Scala ツアー"
         description: "コア言語機能をひと口大で紹介"
         icon: "fa fa-flag"

diff --git a/_ja/overviews/macros/paradise.md b/_ja/overviews/macros/paradise.md
@@ -19,7 +19,7 @@ title: マクロパラダイス
 マクロパラダイス (Macro paradise) とは Scala の複数のバージョンをサポートするコンパイラプラグインで、一般向けにリリースされている <code>scalac</code> と共に正しく動作するように設計されている。
 これによって、将来の Scala に取り込まれるよりもいち早く最新のマクロ機能を使えるようになっている。
 [サポートされている機能とバージョンの一覧](/ja/overviews/macros/roadmap.html))に関してはロードマップページを、
-動作の保証に関しては[マクロパラダイスのアナウンスメント](https://scalamacros.org/news/2013/08/07/roadmap-for-macro-paradise.html)を参照してほしい。
+動作の保証に関しては[マクロパラダイスのアナウンスメント](hxxps://scalamacros.org/news/2013/08/07/roadmap-for-macro-paradise.html)を参照してほしい。
 
     ~/210x $ scalac -Xplugin:paradise_*.jar -Xshow-phases
         phase name  id  description

diff --git a/_ja/overviews/macros/typemacros.md b/_ja/overviews/macros/typemacros.md
@@ -9,7 +9,7 @@ title: 型マクロ
 **Eugene Yokota 訳**
 
 型マクロ (type macro) は[マクロパラダイス](/ja/overviews/macros/paradise.html)の以前のバージョンから利用可能だったが、マクロパラダイス 2.0 ではサポートされなくなった。
-[the paradise 2.0 announcement](https://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) に説明と移行のための戦略が書かれている。
+[the paradise 2.0 announcement](hxxps://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) に説明と移行のための戦略が書かれている。
 
 ## 直観
 

diff --git a/_ja/overviews/macros/untypedmacros.md b/_ja/overviews/macros/untypedmacros.md
@@ -9,7 +9,7 @@ title: 型指定の無いマクロ
 **Eugene Yokota 訳**
 
 型指定の無いマクロ (untyped macro) は[マクロパラダイス](/ja/overviews/macros/paradise.html)の以前のバージョンから利用可能だったが、マクロパラダイス 2.0 ではサポートされなくなった。
-[the paradise 2.0 announcement](https://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) に説明と移行のための戦略が書かれている。
+[the paradise 2.0 announcement](hxxps://scalamacros.org/news/2013/08/05/macro-paradise-2.0.0-snapshot.html) に説明と移行のための戦略が書かれている。
 
 ## 直観
 

diff --git a/_ja/overviews/macros/usecases.md b/_ja/overviews/macros/usecases.md
@@ -20,7 +20,7 @@ Scala の商用ユーザと研究ユーザの両方がマクロを利用して
 ここ EPFL においても我々はマクロを活用して研究を行っている。Lightbend 社もマクロを数々のプロジェクトに採用している。
 マクロはコミュニティー内でも人気があり、既にいくつかの興味深い応用が現れている。
 
-最近行われた講演の ["What Are Macros Good For?"](https://scalamacros.org/paperstalks/2014-02-04-WhatAreMacrosGoodFor.pdf) では Scala 2.10 ユーザのマクロの利用方法を説明し、システム化した。講演の大筋はマクロはコード生成、静的な検査、および DSL に有効であるということで、これを研究や産業からの例を交えながら説明した。
+最近行われた講演の ["What Are Macros Good For?"](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/paperstalks/2014-02-04-WhatAreMacrosGoodFor.pdf) では Scala 2.10 ユーザのマクロの利用方法を説明し、システム化した。講演の大筋はマクロはコード生成、静的な検査、および DSL に有効であるということで、これを研究や産業からの例を交えながら説明した。
 
-Scala'13 ワークショップにおいて ["Scala Macros: Let Our Powers Combine!"](https://scalamacros.org/paperstalks/2013-04-22-LetOurPowersCombine.pdf) という論文を発表した。これは Scala 2.10 における最先端のマクロ論をより学問的な視点から説明した。
+Scala'13 ワークショップにおいて ["Scala Macros: Let Our Powers Combine!"](https://github.com/scalamacros/scalamacros.github.com/blob/5904f7ef88a439c668204b4bf262835e89fb13cb/paperstalks/2013-04-22-LetOurPowersCombine.pdf) という論文を発表した。これは Scala 2.10 における最先端のマクロ論をより学問的な視点から説明した。
 この論文では Scala のリッチな構文と静的な型がマクロと相乗することを示し、また既存の言語機能をマクロによって新しい方法で活用できることを考察する。
diff --git a/_ja/overviews/reflection/overview.md b/_ja/overviews/reflection/overview.md
@@ -81,7 +81,7 @@ Scala コンパイラが持つ型情報を全ては入手できない可能性
 
 上の例では、まず `scala.reflect.runtime.universe` をインポートして
 (型タグを使うためには必ずインポートされる必要がある)、`l` という名前の `List[Int]` を作る。
-次に、context bound を持った型パラメータ `T` を持つ `getTypeTag` というメソッドは定義する
+次に、context bound を持った型パラメータ `T` を持つ `getTypeTag` というメソッドを定義する
 (REPL が示すとおり、これは暗黙の evidence パラメータを定義することに等価であり、コンパイラは `T` に対する型タグを生成する)。
 最後に、このメソッドに `l` を渡して呼び出し、`TypeTag` に格納される型を返す `tpe` を呼び出す。
 見ての通り、正しい完全な型 (つまり、`List` の具象型引数を含むということ) である `List[Int]` が返ってきた。

diff --git a/_ja/tour/automatic-closures.md b/_ja/tour/automatic-closures.md
diff --git a/_ko/tour/annotations.md b/_ko/tour/annotations.md
@@ -7,7 +7,7 @@ num: 31
 language: ko
 
 next-page: packages-and-imports
-previous-page: automatic-closures
+previous-page: operators
 ---
 
 어노테이션은 메타 정보와 정의 내용을 연결해준다.