Deploy v11.4.0

.github/ISSUE_TEMPLATE/suggest_video.yaml

@@ -0,0 +1,110 @@
+name: Suggest a video
+description: Suggest a video to add to the ethereum.org video gallery
+title: Suggest a video
+labels: ["feature ✨", "content 🖋️"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Before suggesting a video, please review [our video listing policy](https://ethereum.org/contributing/adding-videos/) to ensure your suggestion meets the criteria.
+  - type: markdown
+    id: video_info
+    attributes:
+      value: "## Video info"
+  - type: input
+    id: video_title
+    attributes:
+      label: Video title
+      description: What is the title of the video?
+    validations:
+      required: true
+  - type: input
+    id: video_url
+    attributes:
+      label: YouTube URL
+      description: Please provide the full YouTube URL (e.g. https://www.youtube.com/watch?v=...)
+    validations:
+      required: true
+  - type: textarea
+    id: video_description
+    attributes:
+      label: Video description
+      description: Provide a brief 1–3 sentence summary of what the video covers
+    validations:
+      required: true
+  - type: input
+    id: video_author
+    attributes:
+      label: Creator / Channel
+      description: Who created the video? (e.g. "Ethereum Foundation", "Finematics")
+    validations:
+      required: true
+  - type: input
+    id: video_duration
+    attributes:
+      label: Duration
+      description: "Video length in H:MM:SS or M:SS format (e.g. 1:08:42 or 12:30)"
+    validations:
+      required: true
+  - type: dropdown
+    id: video_education_level
+    attributes:
+      label: Education level
+      description: What level of Ethereum knowledge does this video assume?
+      options:
+        - "Beginner"
+        - "Intermediate"
+        - "Advanced"
+    validations:
+      required: true
+  - type: dropdown
+    id: video_format
+    attributes:
+      label: Format
+      description: What best describes the format of this video?
+      options:
+        - "Explainer"
+        - "Presentation"
+        - "Interview"
+        - "Tutorial"
+        - "Panel"
+    validations:
+      required: true
+  - type: input
+    id: video_topics
+    attributes:
+      label: Topics
+      description: "Comma-separated topic tags (e.g. scaling, layer-2, rollups). See existing tags at https://ethereum.org/videos/"
+    validations:
+      required: true
+  - type: input
+    id: video_upload_date
+    attributes:
+      label: Original upload date
+      description: "When was the video originally published? (YYYY-MM-DD format)"
+    validations:
+      required: true
+  - type: textarea
+    id: video_transcript
+    attributes:
+      label: Transcript (optional)
+      description: |
+        If you have a transcript, paste it here. Otherwise the team will generate one.
+        Transcripts should use markdown formatting with section headings and timestamps.
+  - type: textarea
+    id: video_justification
+    attributes:
+      label: Why should this video be listed?
+      description: Briefly explain how this video helps ethereum.org users learn about Ethereum
+  - type: checkboxes
+    id: video_work_on
+    attributes:
+      label: Would you like to work on this issue?
+      description: If yes, you can open a PR to add the video yourself following our contributing guide
+      options:
+        - label: "Yes"
+          required: false
+        - label: "No"
+          required: false
+    validations:
+      required: true

.github/workflows/deploy-data-layer.yml

@@ -32,4 +32,4 @@ jobs:
       - name: Deploy to Trigger.dev
         run: pnpm exec trigger deploy
         env:
-          TRIGGER_SECRET_KEY: ${{ secrets.TRIGGER_SECRET_KEY }}
+          TRIGGER_ACCESS_TOKEN: ${{ secrets.TRIGGER_ACCESS_TOKEN }}

.github/workflows/gemini-translations.yml → .github/workflows/intl-pipeline.yml

@@ -1,4 +1,4 @@
-name: Gemini Translations
+name: Intl Pipeline
 
 on:
   workflow_dispatch:
@@ -7,6 +7,10 @@ on:
         description: "Path(s) to translate (comma-separated files, single directory, or blank for all)"
         required: false
         type: string
+      exclude_path:
+        description: "Path(s) to exclude (comma-separated files or directories)"
+        required: false
+        type: string
       target_languages:
         description: "Comma-separated language codes (blank for all locales)"
         required: false
@@ -16,15 +20,20 @@ on:
         required: false
         default: "dev"
         type: string
+      target_branch:
+        description: "Override target branch (default: intl/pending)"
+        required: false
+        type: string
       concurrency:
         description: "Max parallel Gemini requests per language"
         required: false
-        default: "3"
+        default: "16"
         type: string
-      resume_run_id:
-        description: "Resume an interrupted run by its ID"
+      stamp_only:
+        description: "Update manifests only, no translations"
         required: false
-        type: string
+        default: false
+        type: boolean
       skip_pr:
         description: "Skip PR creation?"
         required: false
@@ -35,6 +44,18 @@ on:
         required: false
         default: "false"
         type: boolean
+      mode:
+        description: "Translation mode: 'auto' (full for new files, incremental for existing) or 'full' (retranslate everything)"
+        required: false
+        default: "auto"
+        type: choice
+        options:
+          - auto
+          - full
+
+concurrency:
+  group: i18n-translation
+  cancel-in-progress: false
 
 jobs:
   translate:
@@ -43,30 +64,36 @@ jobs:
     steps:
       - name: Check out code
         uses: actions/checkout@v6
+        with:
+          ref: ${{ github.event.inputs.base_branch || 'dev' }}
+          fetch-depth: 0
 
       - name: Setup pnpm
-        uses: pnpm/action-setup@v4
+        uses: pnpm/action-setup@v5
 
       - name: Set up Node.js
         uses: actions/setup-node@v6
         with:
-          node-version: 20
+          node-version-file: ".nvmrc"
           cache: "pnpm"
 
       - name: Install dependencies
         run: pnpm install
 
-      - name: Run Gemini translation
-        run: npx ts-node -O '{"module":"commonjs"}' ./src/scripts/i18n/main-gemini.ts
+      - name: Run translation pipeline
+        run: npx ts-node -O '{"module":"commonjs"}' ./src/scripts/intl-pipeline/main.ts
         env:
           GEMINI_API_KEY: ${{ secrets.GEMINI_API_KEY }}
-          I18N_GITHUB_API_KEY: ${{ secrets.I18N_GITHUB_TOKEN }}
+          GITHUB_API_TOKEN: ${{ secrets.I18N_GITHUB_TOKEN }}
           TARGET_PATH: ${{ github.event.inputs.target_path }}
+          EXCLUDE_PATH: ${{ github.event.inputs.exclude_path }}
           TARGET_LANGUAGES: ${{ github.event.inputs.target_languages }}
           BASE_BRANCH: ${{ github.event.inputs.base_branch }}
           GEMINI_CONCURRENCY: ${{ github.event.inputs.concurrency }}
-          RESUME_RUN_ID: ${{ github.event.inputs.resume_run_id }}
           SKIP_PR_CREATION: ${{ github.event.inputs.skip_pr }}
           VERBOSE: ${{ github.event.inputs.verbose }}
+          MODE: ${{ github.event.inputs.mode }}
           GITHUB_REPOSITORY: ${{ github.repository }}
-          TRANSLATION_PIPELINE: Gemini
+          TARGET_BRANCH: ${{ github.event.inputs.target_branch }}
+          STAMP_ONLY: ${{ github.event.inputs.stamp_only }}
+          DRY_RUN: "false"

AGENTS.md

@@ -54,6 +54,7 @@ This is the official Ethereum.org website - a Next.js application that serves as
   - **content/** - Markdown content files
   - **images/** - Image assets
 - **docs/** - Development documentation
+  - **solutions/** - Documented solutions to past problems, organized by category with YAML frontmatter (module, tags, problem_type)
 
 ## Code Conventions
 

app/[locale]/[...slug]/page.tsx

@@ -10,6 +10,7 @@ import type { GHIssue, SlugPageParams } from "@/lib/types"
 
 import I18nProvider from "@/components/I18nProvider"
 import mdComponents from "@/components/MdComponents"
+import VideoWatch from "@/components/Videos/VideoWatch"
 
 import { dateToString } from "@/lib/utils/date"
 import { getLayoutFromSlug } from "@/lib/utils/layout"
@@ -57,7 +58,7 @@ export default async function Page(props: { params: Promise<SlugPageParams> }) {
   } = await getPageData({
     locale,
     slug,
-    baseComponents: mdComponents,
+    baseComponents: { ...mdComponents, VideoWatch },
     componentsMapping,
     scope: {
       gfissues,

app/[locale]/videos/[slug]/page-jsonld.tsx

@@ -0,0 +1,57 @@
+import type { VideoFrontmatter } from "@/lib/interfaces"
+
+import PageJsonLD from "@/components/PageJsonLD"
+
+import { ethereumFoundationOrganization } from "@/lib/utils/jsonld"
+import { stripMarkdown } from "@/lib/utils/md"
+import { toIsoDuration } from "@/lib/utils/time"
+import { normalizeUrlForJsonLd } from "@/lib/utils/url"
+import { getDefaultThumbnailUrl } from "@/lib/utils/videos"
+
+export default function VideoPageJsonLD({
+  locale,
+  slug,
+  frontmatter,
+  transcript,
+}: {
+  locale: string
+  slug: string
+  frontmatter: VideoFrontmatter
+  transcript: string | null
+}) {
+  const url = normalizeUrlForJsonLd(locale, `/videos/${slug}/`)
+
+  const jsonLd: Record<string, unknown> = {
+    "@context": "https://schema.org",
+    "@type": "VideoObject",
+    "@id": `${url}#video`,
+    name: frontmatter.title,
+    description: frontmatter.description,
+    uploadDate: `${frontmatter.uploadDate}T00:00:00+00:00`,
+    duration: toIsoDuration(frontmatter.duration),
+    thumbnailUrl:
+      frontmatter.customThumbnailUrl ||
+      getDefaultThumbnailUrl(frontmatter.youtubeId),
+    embedUrl: `https://www.youtube.com/embed/${frontmatter.youtubeId}`,
+    contentUrl: `https://www.youtube.com/watch?v=${frontmatter.youtubeId}`,
+    educationalLevel: frontmatter.educationLevel,
+    inLanguage: frontmatter.lang,
+    creator: {
+      "@type": "Person",
+      name: frontmatter.author,
+    },
+    publisher: ethereumFoundationOrganization,
+    isAccessibleForFree: true,
+    isFamilyFriendly: true,
+  }
+
+  // Add transcript as plain text if available
+  if (transcript) {
+    // Escape < and / to prevent script injection (XSS protection)
+    jsonLd.transcript = stripMarkdown(transcript, true)
+      .replace(/</g, "\\u003c")
+      .replace(/\//g, "\\u002f")
+  }
+
+  return <PageJsonLD structuredData={jsonLd} />
+}