[5/?] Add ability to run code examples in the playground: Run code samples inline

.github/linters/.markdown-lint.yml

@@ -1,5 +1,6 @@
 {
   "MD007": { "indent": 4 },
   "MD013": false,
-  "MD026": false
+  "MD026": false,
+  "MD042": false
 }

.spelling-wordlist.txt

@@ -28,6 +28,7 @@ FFI
 filesystem
 finaliser
 finalisers
+fontawesome
 forgeable
 GC
 GDB

docs/assets/snippets.js

@@ -0,0 +1,32 @@
+/**
+ * @param {MouseEvent} evt 
+ */
+async function runSnippetInline(evt) {
+    evt.preventDefault();
+    const snippetRes = await fetch(`https://raw.githubusercontent.com/ponylang/pony-tutorial/main/code-samples/${evt.target.dataset.snippet}`)
+    const snippetCode = await snippetRes.text()
+    const evaluateRes = await fetch('https://playground.ponylang.io/evaluate.json', {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+            "code": snippetCode,
+            "separate_output": true,
+            "color": true,
+            "branch": "release"
+        })
+    })
+    const json = await evaluateRes.json()
+    evt.target.previousElementSibling.querySelector('pre').append(Object.assign(document.create('pre'), {
+        innerHTML: json.success ? json.stdout : json.compiler,
+    }))
+}
+
+document$.subscribe(function() {
+    const inlineRunButtons = document.querySelectorAll('.md-button[data-snippet]')
+
+    for (const button of inlineRunButtons) {
+        button.addEventListener('click', runSnippetInline)
+    }
+})

docs/generics/generics-and-reference-capabilities.md

@@ -50,7 +50,13 @@ That compiles and runs, so `ref` is valid now. The real test though is `iso`. Le
 This fails to compile. The first error is:
 
 ```error
---8<-- "generics-and-reference-capabilities-foo-iso-error-message.txt"
+main.pony:5:8: right side must be a subtype of left side
+    _c = c
+       ^
+    Info:
+    main.pony:4:17: String iso! is not a subtype of String iso: iso! is not a subtype of iso
+      new create(c: String iso) =>
+                ^
 ```
 
 The error is telling us that we are aliasing the `String iso` - The `!` in `iso!` means it is an alias of an existing `iso`. Looking at the code shows the problem:

docs/getting-started/hello-world.md

@@ -21,6 +21,8 @@ In your file, put the following code:
 --8<-- "hello-world-main.pony"
 ```
 
+[:fontawesome-solid-play: Run inline](#){ .md-button .md-button--primary data-snippet="hello-world-main.pony" }
+
 ## Compiling the program
 
 Now compile it:

mkdocs.yml

@@ -6,6 +6,9 @@ repo_url: https://github.com/ponylang/pony-tutorial/
 site_url: https://tutorial.ponylang.io/
 use_directory_urls: false
 
+extra_javascript:
+  - assets/snippets.js
+
 extra:
   generator: false
   social:
@@ -25,6 +28,10 @@ markdown_extensions:
   - pymdownx.snippets:
       base_path: ['code-samples']
       check_paths: true
+  - pymdownx.emoji:
+      emoji_index: !!python/name:material.extensions.emoji.twemoji
+      emoji_generator: !!python/name:material.extensions.emoji.to_svg
+  - attr_list
   - smarty
   - toc:
       permalink: true