Skip to content

fResult/docs.scala-lang

This branch is 2 commits ahead of, 156 commits behind scala/docs.scala-lang:main.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e9a8f43 · Nov 1, 2024
Mar 1, 2024
Oct 26, 2024
Oct 31, 2023
May 18, 2023
Oct 31, 2024
Sep 20, 2022
Oct 26, 2024
Oct 26, 2024
Oct 18, 2022
Oct 1, 2024
Feb 12, 2024
Oct 26, 2024
Oct 26, 2024
Jun 24, 2024
Oct 26, 2024
Oct 26, 2024
May 12, 2023
Oct 26, 2024
Oct 26, 2024
Mar 5, 2024
Oct 29, 2024
Aug 14, 2024
Nov 1, 2024
Oct 26, 2024
Oct 19, 2024
Oct 26, 2024
Sep 20, 2022
Oct 22, 2024
Jan 25, 2023
Jul 17, 2024
Mar 1, 2024
Sep 25, 2024
Jul 7, 2022
Apr 23, 2019
Oct 31, 2023
Feb 23, 2023
Nov 1, 2024
Oct 20, 2024
Oct 22, 2024
Oct 31, 2023
Jul 19, 2017
Mar 22, 2022
Aug 22, 2024
Feb 23, 2023
Jul 17, 2024
Nov 20, 2023
Nov 20, 2023
Nov 17, 2022

Repository files navigation

Scala Documentation

Build Status

This repository contains the source for the Scala documentation website, as well as the source for "Scala Improvement Process" (SIP) documents.

Dependencies

This site uses a Jekyll, a Ruby framework. You'll need Ruby and Bundler installed; see Jekyll installation instructions for the details.

Quickstart

To build and view the site locally:

bundle install
bundle exec jekyll serve -I

(Trouble on MacOS?)

For more details, read on.

Quickstart with Docker Compose

You need to have Docker Engine and Docker Compose installed on your machine. Under macOS (Intel or Apple silicon), instead of installing Docker Desktop you can also use HomeBrew with Colima: brew install colima docker docker-compose.
UID and GID environment variables are needed to avoid docker from writing files as root in your directory. By default, docker-compose will use the file docker-compose.yml which will build the website and serve it on 0.0.0.0:4000 . If you just need to build the website, add -f docker-compose_build-only.yml

env UID="$(id -u)" GID="$(id -g)" docker-compose up

The generated site is available at http://localhost:4000.

When the website dependencies change (the content of the Gemfile), you have to re-build the Docker image:

env UID="$(id -u)" GID="$(id -g)" docker-compose up --build

If you have problems with the Docker image or want to force the rebuild of the Docker image:

env UID="$(id -u)" GID="$(id -g)" docker-compose build --no-cache

For more details on the Docker option, see also this issue.

Contributing

Please have a look at Add New Guides/Tutorials before making a contribution. This document gives an overview of the type of documentation contained within the Scala Documentation repository and the repository's structure.

Small changes, or corrected typos will generally be pulled in right away. Large changes, like the addition of new documents, or the rewriting of existing documents will be thoroughly reviewed-- please keep in mind that, generally, new documents must be very well-polished, complete, and maintained in order to be accepted.

Building & Viewing

cd into the directory where you cloned this repository, then install the required gems with bundle install. This will automatically put the gems into ./vendor/bundle.

Start the server in the context of the bundle (use -I for incremental builds):

bundle exec jekyll serve -I

It might take around 5 minutes at first but incremental compilations will be fast.

The generated site is available at http://localhost:4000

If you add --watch at the end of the command line above, Jekyll will automatically watch for changes on the filesystem, and regenerate the site.

If you get incompatible encoding errors when generating the site under Windows, then ensure that the console in which you are running jekyll can work with UTF-8 characters. As described in the blog Solving UTF problem with Jekyll on Windows you have to execute chcp 65001. This command is best added to the jekyll.bat-script.

Markdown

The markdown used in this site uses kramdown extensions.

Markdown Editor for OSX

There's a free markdown editor for OSX called MacDown. It's quite convenient to work with, and it generates the translated Markdown in real-time alongside of your editor window, as can be seen here:

MacDown Screen Shot

License

All documentation contained in this repository is licensed by EPFL under a Creative Commons Attribution-Share Alike 3.0 Unported license ("CC-BY-SA"), unless otherwise noted. By submitting a "pull request," or otherwise contributing to this repository, you implicitly agree to license your contribution under the above CC-BY-SA license. The source code of this website is licensed to EPFL under the Scala License, unless otherwise noted.

About

The Scala Documentation website

Resources

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 38.4%
  • SCSS 31.7%
  • JavaScript 24.5%
  • Ruby 2.8%
  • CSS 2.2%
  • Makefile 0.2%
  • Other 0.2%