docs: refine template engine guides and validation

scripts/check-docs.sh

@@ -25,4 +25,21 @@ while IFS= read -r -d '' markdown; do
     done < <(sed -nE 's/.*\]\(([^ )]+)( "[^"]*")?\).*/\1/p' "$markdown")
 done < <(find "$root" -path "$root/.git" -prune -o -path '*/.pio' -prune -o -name '*.md' -type f -print0)
 
+while IFS= read -r example; do
+    for required in README.md platformio.ini; do
+        [[ -f "$example/$required" ]] || { echo "Incomplete example: ${example#$root/} is missing $required" >&2; exit 1; }
+    done
+    find "$example/src" -type f \( -name '*.ino' -o -name '*.cpp' \) -print -quit | grep -q . || {
+        echo "Incomplete example: ${example#$root/} has no source" >&2
+        exit 1
+    }
+done < <(find "$root/examples" -mindepth 2 -maxdepth 2 -type f -name platformio.ini -printf '%h\n' | sort)
+
+while IFS= read -r markdown; do
+    (( $(grep -Ec '^[[:space:]]*```' "$markdown") % 2 == 0 )) || {
+        echo "Unclosed code fence in ${markdown#$root/}" >&2
+        exit 1
+    }
+done < <(find "$root" -path "$root/.git" -prune -o -path '*/.pio' -prune -o -name '*.md' -type f -print)
+
 echo "Documentation links and required files passed"

scripts/test.sh

@@ -2,18 +2,36 @@
 set -euo pipefail
 
 usage() {
-    echo "Usage: $0 compile --platform esp8266|esp32" >&2
+    echo "Usage: $0 compile|examples --platform esp8266|esp32" >&2
     exit 2
 }
 
-[[ "${1:-}" == "compile" && "${2:-}" == "--platform" && $# -eq 3 ]] || usage
-
+[[ $# -eq 3 && ( "${1:-}" == "compile" || "${1:-}" == "examples" ) && "${2:-}" == "--platform" ]] || usage
 case "${3:-}" in
-    esp8266) environment="test_template_engine_8266" ;;
-    esp32) environment="test_template_engine_esp32" ;;
+    esp8266|esp32) platform="$3" ;;
     *) usage ;;
 esac
 
 root="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
-pio test -d "$root" -e "$environment" --without-uploading --without-testing
-echo "DFTE compile check passed for ${3}"
+if [[ "$1" == "compile" ]]; then
+    case "$platform" in
+        esp8266) test_environment="test_template_engine_8266" ;;
+        esp32) test_environment="test_template_engine_esp32" ;;
+    esac
+    pio test -d "$root" -e "$test_environment" --without-uploading --without-testing
+    echo "DFTE compile check passed for $platform"
+    exit 0
+fi
+
+suffix="$platform"
+mapfile -t examples < <(find "$root/examples" -mindepth 2 -maxdepth 2 -type f -name platformio.ini -printf '%h\n' | sort)
+if (( ${#examples[@]} == 0 )); then
+    echo "No example projects found" >&2
+    exit 1
+fi
+for example in "${examples[@]}"; do
+    env_name="example_$suffix"
+    [[ "$(basename "$example")" == "AsyncDashboardDemo" ]] && env_name="dashboard_$suffix"
+    pio run -d "$example" -e "$env_name" </dev/null
+done
+echo "DFTE examples compile check passed for $platform"