Merge branch 'javascript'

Author: haraldschilly

examples.py

@@ -4,7 +4,7 @@
 #####################################################################################
 #              CoCalc Examples - Documentation Files Compiler                       #
 #                                                                                   #
-#                Copyright (C) 2015 -- 2018, SageMath, Inc.                         #
+#                Copyright (C) 2015 -- 2020, SageMath, Inc.                         #
 #                                                                                   #
 #  Distributed under the terms of the GNU General Public License (GPL), version 2+  #
 #                                                                                   #
@@ -125,6 +125,7 @@ def examples_data(input_dir, output_fn):
         "bash": recursive_dict(),
         "octave": recursive_dict(),
         "julia": recursive_dict(),
+        "javascript": recursive_dict(),
     }
 
     # This processes all yaml input files and fails when any assertion is violated.
@@ -246,6 +247,7 @@ def language_to_kernel(lang):
         "python": "python3",
         "r": "ir",
         "julia": "julia-1.1",
+        "javascript": "javascript",
     }
     return data.get(lang.lower(), lang)
 

src/javascript/advanced.yaml

@@ -0,0 +1,24 @@
+# CoCalc Snippets for Javascript
+# Copyright: SageMath Inc., 2020
+# License:   Creative Commons: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
+---
+language: javascript
+category: ["Advanced", "Async/Await"]
+---
+title: "Async/Await in ijavascript"
+descr: >
+  This is how you can run async code in `ijavascript`.
+  Notice, how there is a 1 second delay between the outputs and only then the execution halts (calling `$$.done()`)
+
+  See [ijavascript async output](http://n-riesco.github.io/ijavascript/doc/async.ipynb.html) for more information.
+code: |
+  $$.async();
+
+  console.log("Hello, World!");
+
+  function run() {
+      console.log("I'm done waiting a second.");
+      $$.done();
+  }
+
+  setTimeout(run, 1000);

src/javascript/tutorial.yaml

@@ -0,0 +1,74 @@
+# CoCalc Snippets for Javascript
+# Copyright: SageMath Inc., 2020
+# License:   Creative Commons: Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
+---
+language: javascript
+category: Tutorial / First Steps
+sortweight: -1
+---
+title: Introduction
+descr: >
+  This jupyter kernel runs JavaScript remotely in Node.js.
+
+  - [kernel ijavascript](https://github.com/n-riesco/ijavascript)
+  - [node.js](https://nodejs.org/en/)
+code:
+  - |
+    # a simple calculation
+    1+1
+  - |
+    # the version of Node.js
+    process.version
+---
+title: Variables
+descr: >
+  Use the equal sign to name an object to refer to it later.
+code:
+  - |
+    # define x
+    x = 20
+    x
+  - |
+    # now refer to x in a calculation
+    2 * x + 1
+---
+title: Print output
+descr: >
+  Use `console.log(...)` to show output – otherwise, only the last value in a cell will be displayed.
+code: |
+  console.log("Hello, World!");
+  console.log(9 * 9);
+  console.log("finished");
+---
+category: Tutorial / Arrays
+---
+title: Arrays
+descr: >
+  An array is an ordered collection of objects.
+code: |
+  [1, 2, 5, 10]
+---
+title: Array manipulations
+descr: >
+  This is how you can change an element in an array and extract an element at a specific location.
+
+  The first element is at *index position 0*!
+code:
+  - |
+    arr = ['foo', 'bar', 'baz']
+    arr[1] = 'apple'
+    arr
+  - |
+    arr[0]
+---
+category: Tutorial / Functions
+---
+title: Introduction
+descr: >
+  A JavaScript function is ...
+code:
+  - |
+    function foo(x) {
+      return 2*x+1;
+    }
+  - foo(20)