feat: comments, feedback, gh url

Author: faretek1

docs/.meta.yml

@@ -0,0 +1 @@
+comments: true

mkdocs.yml

@@ -9,6 +9,8 @@ repo_name: TimMcCool/scratchattach
 
 theme:
   name: material
+  custom_dir: overrides
+
   palette:
     # Palette toggle for light mode
     - scheme: default
@@ -43,6 +45,7 @@ plugins:
   - social
   - search
   - glightbox
+  - meta
 
 markdown_extensions:
   - admonition
@@ -85,6 +88,25 @@ extra:
   social:
     # Took this from the goboscript mkdocs yml file
     - icon: fontawesome/brands/github
-      link: https://github.com/scratch-api/docs
+      link: https://github.com/scratch-api/
     - icon: fontawesome/brands/discord
-      link: https://discord.gg/mgxyyfnfk8
+      link: https://discord.gg/mgxyyfnfk8
+
+  analytics:
+    provider: google
+    property: G-XXXXXXXXXX  # these are required fields, but unused
+
+    feedback:
+      title: Was this page helpful?
+      ratings:
+        - icon: material/emoticon-happy-outline
+          name: This page was helpful
+          data: 1
+          note: >-
+            Thanks for your feedback!
+        - icon: material/emoticon-sad-outline
+          name: This page could be improved
+          data: 0
+          note: >-
+            Thanks for your feedback! Help us improve this page by
+            using our <a href="https://github.com/scratch-api/scratch-api.github.io/issues/new/?title=[Feedback]+{title}+-+{url}" target="_blank" rel="noopener">feedback form</a>.

overrides/partials/comments.html

@@ -0,0 +1,56 @@
+{% if page.meta.comments %}
+  <h2 id="__comments">{{ lang.t("meta.comments") }}</h2>
+  <!-- Insert generated snippet here -->
+    <script src="https://giscus.app/client.js"
+        data-repo="scratch-api/scratch-api.github.io"
+        data-repo-id="R_kgDOPnOq5g"
+        data-category="Giscus"
+        data-category-id="DIC_kwDOPnOq5s4CvZsT"
+        data-mapping="pathname"
+        data-strict="1"
+        data-reactions-enabled="1"
+        data-emit-metadata="0"
+        data-input-position="top"
+        data-theme="preferred_color_scheme"
+        data-lang="en"
+        data-loading="lazy"
+        crossorigin="anonymous"
+        async>
+</script>
+
+  <!-- Synchronize Giscus theme with palette -->
+  <script>
+    var giscus = document.querySelector("script[src*=giscus]")
+
+    // Set palette on initial load
+    var palette = __md_get("__palette")
+    if (palette && typeof palette.color === "object") {
+      var theme = palette.color.scheme === "slate"
+        ? "transparent_dark"
+        : "light"
+
+      // Instruct Giscus to set theme
+      giscus.setAttribute("data-theme", theme) 
+    }
+
+    // Register event handlers after documented loaded
+    document.addEventListener("DOMContentLoaded", function() {
+      var ref = document.querySelector("[data-md-component=palette]")
+      ref.addEventListener("change", function() {
+        var palette = __md_get("__palette")
+        if (palette && typeof palette.color === "object") {
+          var theme = palette.color.scheme === "slate"
+            ? "transparent_dark"
+            : "light"
+
+          // Instruct Giscus to change theme
+          var frame = document.querySelector(".giscus-frame")
+          frame.contentWindow.postMessage(
+            { giscus: { setConfig: { theme } } },
+            "https://giscus.app"
+          )
+        }
+      })
+    })
+  </script>
+{% endif %}