Merge branch 'website-v2' into adopt-tutor-docs

Author: jurgenvinju

.github/workflows/base-jobs.yml

@@ -3,6 +3,9 @@ name: Base Website builder
 on:
     workflow_call:
 
+env:
+  MAVEN_OPTS: "-Xmx4G -Dorg.slf4j.simpleLogger.log.org.apache.maven.cli.transfer.Slf4jMavenTransferListener=warn -Dorg.slf4j.simpleLogger.showDateTime=true -Djava.awt.headless=true"
+
 jobs:
     prepare-sources:
       name: Prepare the website sources
@@ -37,7 +40,7 @@ jobs:
 
         # Copy docs from dependent projects, run tutor on local courses folder and copy results into docs and static/assets
         - name: Run rascal-tutor and reuse libraries
-          run: MAVEN_OPTIONS="-Xss256m -Xmx3G" mvn -B clean package -Dwebdriver.chrome.driver=/usr/local/bin/chromedriver -Dwebdriver.chrome.browser=`which chrome`
+          run: MAVEN_OPTIONS="-Xss256m -Xmx3G" mvn -B clean package -Dwebdriver.chrome.driver=/usr/local/bin/chromedriver -Dwebdriver.chrome.browser=`which chrome` | grep -v "\[INFO\] Downloading"
 
         - uses: actions/upload-artifact@v4
           with:
@@ -48,4 +51,4 @@ jobs:
               !.git
               !.github
               !.vscode
-              !META-INF
+              !META-INF

.github/workflows/pr-builder.yml

@@ -20,6 +20,11 @@ jobs:
         with:
           name: sources
 
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: yarn
+
       # Do a dummy build to see if there are errors
       - name: Install dependencies
         run: yarn install --frozen-lockfile

courses/Bibliography/Bibliography.md

@@ -78,7 +78,7 @@ This literature is about the meta systems themselves, their design and their eva
 * Mauricio Verano Merino, Tom Beckmann, Tijs van der Storm, Robert Hirschfeld, and Jurgen J. Vinju. Getting Grammars into Shape for Block-based. (2021)  International Conference on Software Language Engineering.
    > We can generate block-based syntax editors from context-free grammars. The paper bridges between the grammarware and blockware technological spaces. A collaboration with TU Eindhoven en Canon Production Printing.
 * Jurgen J. Vinju and Tijs van der Storm. Bacatá: Notebooks for DSLs, Almost for Free. (2020) <Programming> Journal and DSLDI 2020
-   > We can generate Jupyter Notebook interfaces for language descriptions in Rascal, similar to the way we can generate Eclipse plugins and VScode extensions,
+   > We can generate Jupyter Notebook interfaces for language descriptions in Rascal, similar to the way we can generate Eclipse plugins and VS Code extensions,
    > but with a very different user experience.
 
 ### 2010's

courses/GettingHelp/Browsing/Browsing.md

@@ -30,7 +30,7 @@ been checked before publication.
 
 Every Rascal library project also represents one _course_. Each module produces
 one _concept_ and encapsulates what is defined and documented within. In particular
-the [standard library]((Library)) is interesting to browse. The package hierarchy
+the [standard library]((Library:Index)) is interesting to browse. The package hierarchy
 of the library is mapped one-to-one to the concept hierarchy of the corresponding course.
 
 #### Code examples
@@ -44,5 +44,5 @@ Most pages are indexed carefully, for example using the appropriate keywords and
 
 Nevertheless the search box on the website will produce
 results in all courses, like [Help]((GettingHelp)) (this course)
-and [Recipes]((Recipes)) or ((Library)). 
+and [Recipes]((Recipes)) or ((Library:Index)). 
 

courses/GettingHelp/FurtherReading/FurtherReading.md

@@ -14,12 +14,12 @@ keywords:
 1. To understand the terminology used in Rascal and by Rascal programmers ((Rascalopedia)) is a focused encyclopedia of meta programming.
 1. To understand error messages produced by Rascal, there is information on all ((RunTimeErrors)) and ((CompileTimeErrors)).
 1. To know everything about every detail of Rascal syntax and semantics, the [Rascal reference manual]((course:Rascal)) applies.
-1. The full standard ((Library)) is documented [here]((Library)).
+1. The full standard ((Library:Index)) is documented [here]((Library:Index)).
 
 #### Packages
 
-Rascal can be extended by loading different (third-party) packages. For example:
+Rascal can be extended by loading different (third-party) [packages](/docs/Packages). For example:
 
-* ((flybytes)) enables JVM bytecode analysis, transformation and generation in Rascal.
-* ((typepal)) is a generic name and type analysis framework for programming languages and textual DSLs.
+* [flybytes](/docs/Packages/org.rascalmpl.flybytes) enables JVM bytecode analysis, transformation and generation in Rascal.
+* [typepal](/docs/Packages/org.rascalmpl.typepal) is a generic name and type analysis framework for programming languages and textual DSLs.
 

courses/GettingHelp/GettingHelp.md

@@ -31,7 +31,7 @@ details:
 * Directly in the Rascal IDE there is help available:
    1. On the commandline, type `:help`
    2. In Eclipse there is the `Tutor View` which opens all the documentation pages inside Eclipse.
-   3. In VScode use the command palette and search for `Rascal` for more commands.
+   3. In VS Code use the command palette and search for `Rascal` for more commands.
 * For specific application topics, "Howto" kind of information, etc. please go to ((FurtherReading)).
 * There is a lot of documentation on Rascal and its libraries. Read the ((Browsing)) page on how to navigate it.
 

courses/GettingStarted/CreateNewProject/CreateNewProject.md

@@ -8,9 +8,8 @@ import IO;
 remove(|home:///my-project-name|, recursive=true);
 ```
 
-Rascal projects, generally, work the same in all three IDE contexts:
-* Eclipse
-* VScode
+Rascal projects, generally, work the same in all contexts:
+* VS Code
 * Commandline
 
 To create an empty project to get started, follow these instructions:
@@ -24,7 +23,7 @@ newRascalProject(|home:///my-project-name|)
 
 The Eclipse plugin has a "New Project Wizard" you can use as well.
 
-The next step is to import the new project into VScode or Eclipse, or
+The next step is to import the new project into VS Code or Eclipse, or
 to `cd` to the project's root directory. From there on ((RunningRascal))
 with the new project's source and library settings is trivial.
 
@@ -52,7 +51,7 @@ The `pom.xml` file is the basic setup that names the project and defines its dep
 ```
 
 Next to that `RASCAL.MF` is required to configure the development environment for the project. Some
-information from the `pom.xml` is repeated here, because this file is common between Eclipse, VScode and empty commandline projects,
+information from the `pom.xml` is repeated here, because this file is common between Eclipse, VS Code and empty commandline projects,
 and such projects could work with a `pom.xml`:
 
 ```MF

courses/GettingStarted/DownloadAndInstallation/DownloadAndInstallation.md

@@ -6,7 +6,7 @@ sidebar_position: 1
 Rascal is deployed as one of four easy-to-use packages:
 
 1. **A standalone "jar" file**, which can be downloaded [here](https://update.rascal-mpl.org/console/rascal-shell-stable.jar)
-2. A **Visual Studio Code extension**, which can be found [here](https://marketplace.visualstudio.com/items?itemName=usethesource.rascalmpl) or search for "Rascal" in the "Extension" view in VScode itself.
+2. A **Visual Studio Code extension**, which can be found [here](https://marketplace.visualstudio.com/items?itemName=usethesource.rascalmpl) or search for "Rascal" in the "Extension" view in VS Code itself.
 3. An **Eclipse plugin**, for which the update site is <https://update.rascal-mpl.org/stable/>.
 4. A set of **Maven MOJOs**, for which the plugin repository is <https://releases.usethesource.io/maven/>
 

courses/GettingStarted/RascalShell/Commands/Edit/Edit.md

@@ -17,4 +17,4 @@ mean different things:
 
 * On the Unix commandline the `${EDITOR}` environment variable will be used to open a file. If that file is present in the local file system, it is opened by running `${EDITOR} /absolute/path/to/module.rsc`, but if the file is hidden behind an opaque ((Values-Location)) scheme, then it is first copied to a temporary file on the local file system, and then opened.
 * In Eclipse, the eclipse editor framework is used to open an editor for the file. If it is a so called "resource" in the eclipse file system, and editable file is opened with all the Rascal language support. If the file is from an embedded library (inside a jar) then the contents of the file are shown in a similar editor, but read-only.
-* In VScode a similar experience is provided as in Eclipse, but the editor for library files does not know it is read-only.
+* In VS Code a similar experience is provided as in Eclipse, but the editor for library files does not know it is read-only.