feat: add SharePanel component for social sharing with QR code support

- Implemented SharePanel component in `SharePanel.astro` for sharing content on social media platforms. - Integrated QR code generation for WeChat sharing using the `qrcode` library. - Added localization support for English and Chinese languages. - Created utility functions in `seo.ts` for building article summaries and FAQs. - Introduced API routes for serving IndexNow key and generating full LLM catalog and summaries. - Enhanced SEO capabilities with structured data for articles and pages.
2026-04-02 14:15:21 +08:00
parent a516be2e91
commit 3628a46ed1
53 changed files with 4390 additions and 91 deletions
--- a/.gitea/workflows/backend-docker.yml
+++ b/.gitea/workflows/backend-docker.yml
@@ -18,25 +18,130 @@ permissions:
  packages: write

 jobs:
+  resolve-build-targets:
+    runs-on: ubuntu-latest
+    outputs:
+      matrix: ${{ steps.targets.outputs.matrix }}
+      count: ${{ steps.targets.outputs.count }}
+      frontend_changed: ${{ steps.targets.outputs.frontend_changed }}
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Resolve build targets
+        id: targets
+        shell: bash
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          BEFORE_SHA: ${{ github.event.before }}
+          CURRENT_SHA: ${{ github.sha }}
+        run: |
+          set -euo pipefail
+
+          declare -A SELECTED=()
+          BUILD_ALL=0
+
+          if [ "${EVENT_NAME}" = "workflow_dispatch" ]; then
+            BUILD_ALL=1
+          fi
+
+          BEFORE="${BEFORE_SHA:-}"
+          if [ "${BUILD_ALL}" -ne 1 ] && { [ -z "${BEFORE}" ] || printf '%s' "${BEFORE}" | grep -Eq '^0+$'; }; then
+            if git rev-parse --verify HEAD^ >/dev/null 2>&1; then
+              BEFORE="$(git rev-parse HEAD^)"
+            else
+              BUILD_ALL=1
+            fi
+          fi
+
+          CHANGED_FILES=""
+          if [ "${BUILD_ALL}" -ne 1 ]; then
+            CHANGED_FILES="$(git diff --name-only "${BEFORE}" "${CURRENT_SHA}" || true)"
+          fi
+
+          while IFS= read -r path; do
+            [ -n "${path}" ] || continue
+
+            case "${path}" in
+              backend/*)
+                SELECTED[backend]=1
+                ;;
+              frontend/*)
+                SELECTED[frontend]=1
+                ;;
+              admin/*)
+                SELECTED[admin]=1
+                ;;
+              deploy/docker/*|.gitea/workflows/backend-docker.yml)
+                BUILD_ALL=1
+                ;;
+            esac
+          done <<< "${CHANGED_FILES}"
+
+          if [ "${BUILD_ALL}" -eq 1 ] || [ "${#SELECTED[@]}" -eq 0 ]; then
+            SELECTED[backend]=1
+            SELECTED[frontend]=1
+            SELECTED[admin]=1
+          fi
+
+          COMPONENTS=()
+          [ -n "${SELECTED[backend]:-}" ] && COMPONENTS+=(backend)
+          [ -n "${SELECTED[frontend]:-}" ] && COMPONENTS+=(frontend)
+          [ -n "${SELECTED[admin]:-}" ] && COMPONENTS+=(admin)
+
+          COMPONENTS_CSV="$(IFS=,; echo "${COMPONENTS[*]}")"
+          export COMPONENTS_CSV
+
+          python <<'PY' >> "$GITHUB_OUTPUT"
+          import json
+          import os
+
+          mapping = {
+              "backend": {
+                  "component": "backend",
+                  "dockerfile": "backend/Dockerfile",
+                  "context": "backend",
+                  "default_image_name": "termi-astro-backend",
+              },
+              "frontend": {
+                  "component": "frontend",
+                  "dockerfile": "frontend/Dockerfile",
+                  "context": "frontend",
+                  "default_image_name": "termi-astro-frontend",
+              },
+              "admin": {
+                  "component": "admin",
+                  "dockerfile": "admin/Dockerfile",
+                  "context": "admin",
+                  "default_image_name": "termi-astro-admin",
+              },
+          }
+
+          components = [item for item in os.environ.get("COMPONENTS_CSV", "").split(",") if item]
+          matrix = {"include": [mapping[item] for item in components]}
+
+          print(f"matrix={json.dumps(matrix, separators=(',', ':'))}")
+          print(f"count={len(components)}")
+          print(f"frontend_changed={'true' if 'frontend' in components else 'false'}")
+          PY
+
+          echo "Selected components: ${COMPONENTS_CSV}"
+          if [ -n "${CHANGED_FILES}" ]; then
+            echo "Changed files:"
+            printf '%s\n' "${CHANGED_FILES}"
+          else
+            echo "Changed files: <build all>"
+          fi
+
  build-and-push:
+    needs: resolve-build-targets
+    if: needs.resolve-build-targets.outputs.count != '0'
    runs-on: ubuntu-latest
    strategy:
      fail-fast: false
      max-parallel: 1
-      matrix:
-        include:
-          - component: backend
-            dockerfile: backend/Dockerfile
-            context: backend
-            default_image_name: termi-astro-backend
-          - component: frontend
-            dockerfile: frontend/Dockerfile
-            context: frontend
-            default_image_name: termi-astro-frontend
-          - component: admin
-            dockerfile: admin/Dockerfile
-            context: admin
-            default_image_name: termi-astro-admin
+      matrix: ${{ fromJson(needs.resolve-build-targets.outputs.matrix) }}

    steps:
      - name: Checkout
@@ -103,6 +208,8 @@ jobs:
            echo "tag_latest=latest"
            echo "tag_branch=${SAFE_REF}"
            echo "tag_sha=${SHORT_SHA}"
+            echo "cache_ref_branch=${IMAGE_BASE}:buildcache-${SAFE_REF}"
+            echo "cache_ref_shared=${IMAGE_BASE}:buildcache"
            echo "frontend_public_api_base_url=${FRONTEND_PUBLIC_API_BASE_URL}"
            echo "admin_vite_api_base=${ADMIN_VITE_API_BASE}"
            echo "admin_vite_frontend_base_url=${ADMIN_VITE_FRONTEND_BASE_URL}"
@@ -200,6 +307,8 @@ jobs:
          TAG_LATEST: ${{ steps.meta.outputs.tag_latest }}
          TAG_BRANCH: ${{ steps.meta.outputs.tag_branch }}
          TAG_SHA: ${{ steps.meta.outputs.tag_sha }}
+          CACHE_REF_BRANCH: ${{ steps.meta.outputs.cache_ref_branch }}
+          CACHE_REF_SHARED: ${{ steps.meta.outputs.cache_ref_shared }}
          FRONTEND_PUBLIC_API_BASE_URL: ${{ steps.meta.outputs.frontend_public_api_base_url }}
          ADMIN_VITE_API_BASE: ${{ steps.meta.outputs.admin_vite_api_base }}
          ADMIN_VITE_FRONTEND_BASE_URL: ${{ steps.meta.outputs.admin_vite_frontend_base_url }}
@@ -222,8 +331,12 @@ jobs:
            --file "${DOCKERFILE}" \
            "${BUILD_ARGS[@]}" \
            --build-arg BUILDKIT_INLINE_CACHE=1 \
+            --cache-from "type=registry,ref=${CACHE_REF_BRANCH}" \
+            --cache-from "type=registry,ref=${CACHE_REF_SHARED}" \
            --cache-from "type=registry,ref=${IMAGE_BASE}:${TAG_BRANCH}" \
            --cache-from "type=registry,ref=${IMAGE_BASE}:${TAG_LATEST}" \
+            --cache-to "type=registry,ref=${CACHE_REF_BRANCH},mode=max" \
+            --cache-to "type=registry,ref=${CACHE_REF_SHARED},mode=max" \
            --cache-to "type=inline" \
            --tag "${IMAGE_BASE}:${TAG_LATEST}" \
            --tag "${IMAGE_BASE}:${TAG_BRANCH}" \
@@ -244,3 +357,57 @@ jobs:
          echo "- ${IMAGE_BASE}:${TAG_LATEST}"
          echo "- ${IMAGE_BASE}:${TAG_BRANCH}"
          echo "- ${IMAGE_BASE}:${TAG_SHA}"
+
+  submit-indexnow:
+    needs:
+      - resolve-build-targets
+      - build-and-push
+    if: needs.resolve-build-targets.outputs.frontend_changed == 'true'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Submit IndexNow (optional)
+        shell: bash
+        env:
+          INDEXNOW_KEY: ${{ secrets.INDEXNOW_KEY }}
+          SITE_URL: ${{ vars.INDEXNOW_SITE_URL }}
+          PUBLIC_API_BASE_URL: ${{ vars.INDEXNOW_PUBLIC_API_BASE_URL }}
+          GITHUB_REF_NAME_VALUE: ${{ github.ref_name }}
+        run: |
+          set -euo pipefail
+
+          REF_NAME="${GITHUB_REF_NAME_VALUE:-${GITHUB_REF_NAME:-${GITEA_REF_NAME:-}}}"
+          if [ "${GITHUB_EVENT_NAME:-${GITEA_EVENT_NAME:-}}" != "push" ]; then
+            echo "Current event is not push, skip IndexNow submission."
+            exit 0
+          fi
+
+          if [ "${REF_NAME}" != "main" ] && [ "${REF_NAME}" != "master" ]; then
+            echo "Current ref '${REF_NAME}' is not main/master, skip IndexNow submission."
+            exit 0
+          fi
+
+          if [ -z "${INDEXNOW_KEY:-}" ]; then
+            echo "Missing INDEXNOW_KEY secret, skip IndexNow submission."
+            exit 0
+          fi
+
+          if [ -z "${SITE_URL:-}" ]; then
+            echo "Missing INDEXNOW_SITE_URL variable, skip IndexNow submission."
+            exit 0
+          fi
+
+          pnpm --dir frontend run indexnow:submit