feat(comments): add Giscus integration for comments in the book

book/_addons/giscus.html

@@ -0,0 +1,16 @@
+<script src="https://giscus.app/client.js"
+        data-repo="entelecheia/nlp4ss"
+        data-repo-id="R_kgDOMTcakg"
+        data-category="Q&A"
+        data-category-id="DIC_kwDOMTcaks4Cgwzd"
+        data-mapping="pathname"
+        data-strict="1"
+        data-reactions-enabled="1"
+        data-emit-metadata="1"
+        data-input-position="bottom"
+        data-theme="preferred_color_scheme"
+        data-lang="__CURRENT_LANGUAGE__"
+        data-loading="lazy"
+        crossorigin="anonymous"
+        async>
+</script>

book/_scripts/postprocessing.sh

@@ -12,6 +12,7 @@ FINAL_BUILD_DIR="book/_build/html"
 LANGUAGE_SELECTOR_FILE="book/_addons/language_selector.html"
 REDIRECT_INDEX_FILE="book/_addons/language_redirect.html"
 FINAL_INDEX_FILE="$FINAL_BUILD_DIR/index.html"
+GISCUS_SCRIPT_FILE="book/_addons/giscus.html"
 
 # Function to copy and modify HTML files
 copy_and_modify_html() {
@@ -44,10 +45,16 @@ copy_and_modify_html() {
     # Replace language options
     selector_content="${selector_content/__LANGUAGE_OPTIONS__/$options}"
 
+    # Define the Giscus script
+    local giscus_script
+    giscus_script=$(cat "$GISCUS_SCRIPT_FILE")
+    giscus_script="${giscus_script//$'\n'/}"
+    giscus_script="${giscus_script/__CURRENT_LANGUAGE__/$lang}"
+
     # Modify HTML files
     find "$dest_dir" -name "*.html" -print0 | while IFS= read -r -d '' html_file; do
         # Add language selector and script
-        awk -v selector="$selector_content" '
+        awk -v selector="$selector_content" -v giscus="$giscus_script" '
         /<\/head>/ {
             print "    <script src=\"/_static/language_switcher.js\"></script>"
             print $0
@@ -58,6 +65,12 @@ copy_and_modify_html() {
             print selector
             next
         }
+        /<footer class="prev-next-footer d-print-none">/ {
+            print "    <div class=\"giscus\"></div>"
+            print giscus
+            print $0
+            next
+        }
         {print}
         ' "$html_file" >"${html_file}.tmp" && mv "${html_file}.tmp" "$html_file"
     done