Automatically translate your markdown documentation using AI - powered by GitHub Actions and GitHub Models with built-in support for Astro Starlight!

• 🚀 Incremental Translation - Only translates changed content, saving time and API costs
• 🎯 Smart AST Parsing - Preserves markdown structure and formatting
• 🔄 Cache Management - Intelligent caching to avoid redundant translations
• 📚 Astro Starlight Ready - Built-in support for documentation sites
• 🌐 Multi-language Support - Translate to multiple languages simultaneously
• 🔍 Quality Validation - Automatic validation of translation quality
• ⚡ GitHub Actions Native - Seamless integration with your CI/CD pipeline
• 🤖 AI-Powered - Leverage GitHub Models for seamless high-quality translations

• 📖 Documentation - Complete setup guide and API reference (translated by this action too - see translation dashboard)
• ✍️ Blog Post - Deep dive into the technology
• 🌐 Translations: English | Français | Español | Portuguese (Brazil) | العربية

This action leverages GenAIScript to intelligently analyze and translate your markdown documents. Here's the magic behind the scenes:

1. 📄 Parse - Convert markdown to AST (Abstract Syntax Tree)
2. 🔍 Analyze - Identify content that needs translation vs. existing translations
3. 🤖 Translate - Use AI to generate high-quality translations
4. ✅ Validate - Ensure translation quality and inject into document
5. 💾 Cache - Save translations for future incremental updates
6. 📝 Commit - Automatically commit changes to your repository

See the Models documentation for more details.

Add this step to your GitHub Actions workflow to translate your README to French and Spanish:

uses: pelikhan/action-continuous-translation@v0
with:
  github_token: ${{ secrets.GITHUB_TOKEN }}
  lang: fr,es

Save this file in your .github/workflows/ directory as continuous-translation.yml:

name: Continuous Translation
on:
  workflow_dispatch:
  push:
    branches:
      - main
    paths:
      - "README.md"
      - "docs/src/content/docs/**"
permissions:
  contents: write
  models: read
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
jobs:
  continuous_translation:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/cache@v4
        with:
          path: .genaiscript/cache/**
          key: continuous-translation-${{ github.run_id }}
          restore-keys: |
            continuous-translation-
      - uses: pelikhan/action-continuous-translation@v0
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}
          lang: fr,es
      - uses: stefanzweifel/git-auto-commit-action@v5
        with:
          file_pattern: "**.md* translations/**"
          commit_message: "[cai] translated docs"
          commit_user_name: "genaiscript"