doc: add website live example

Author: yuchanns

.github/workflows/pages.yml

@@ -0,0 +1,70 @@
+name: GitHub Pages
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build Web Site
+    if: github.event_name == 'workflow_dispatch' || github.ref == 'refs/heads/master'
+    runs-on: ubuntu-22.04
+    concurrency:
+      group: ${{ github.workflow }}-${{ github.ref }}
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          submodules: recursive
+          fetch-depth: 0
+
+      - name: Build Soluna (WASM)
+        uses: ./.github/actions/soluna
+        id: build
+        with:
+          soluna_path: "."
+
+      - name: Install web build tools
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y lua5.4 zip
+
+      - name: Prepare web assets
+        run: |
+          lua5.4 script/build_web.lua \
+            --soluna . \
+            --site web \
+            --wasm "${{ steps.build.outputs.SOLUNA_WASM_PATH }}" \
+            --js "${{ steps.build.outputs.SOLUNA_JS_PATH }}"
+
+      - name: Setup Hugo
+        uses: peaceiris/actions-hugo@v3
+        with:
+          hugo-version: "0.119.0"
+
+      - name: Build
+        run: hugo --source web --minify
+
+      - name: Upload static files as artifact
+        id: deployment
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: web/public
+
+  deploy:
+    name: Deploy to GitHub Pages
+    if: github.event_name == 'workflow_dispatch' || github.ref == 'refs/heads/master'
+    needs: [build]
+    runs-on: ubuntu-22.04
+    permissions:
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -5,3 +5,7 @@ bin/macos
 bin/mingw
 bin/msvc
 bin/emcc
+web/public
+web/data
+web/static/runtime
+web/static/data

README.md

@@ -8,6 +8,8 @@ Sokol + Lua = Soluna
 
 [中文](./README.zh-CN.md)
 
+[Live Examples](https://cloudwu.github.io/soluna/)
+
 A framework you can use to make 2D games in Lua with multithreading, living on Windows, Linux, macOS and modern Browsers (via WebAssembly).
 
 It is built on top of [sokol](https://github.com/floooh/sokol) and leverages the power of ltask for multithreading.

README.zh-CN.md

@@ -8,6 +8,8 @@ Sokol + Lua = Soluna
 
 [English](./README.md)
 
+[在线演示](https://cloudwu.github.io/soluna/)
+
 一个基于 [sokol](https://github.com/floooh/sokol) 的 2D 游戏引擎。它以 Lua 为编程语言，整合了 ltask 作为多线程框架。sokol + lua 是其名字的由来。
 
 Soluna 可以运行在 Windows、Linux、macOS 和现代浏览器（通过 WebAssembly）上。