translation

name: Translation description: Guidelines for translating content between English, German, and French, ensuring parallel structure and metadata synchronization.

Translation Skill

This skill provides instructions for translating content in the critical-ai-literacy-for-historians repository.

1. Scenarios

A. New Exercise Translation (1 to 2)

• Input: One complete exercise file (e.g., de/exercises/ex1.qmd) and two stubs/missing files.
• Goal: Create full translations in the other two languages.
• Process:
  1. Read the distinct source file.
  2. Translate Title, Description, and Tags (map categories strict).
  3. Translate body content (Sections, text).
  4. Resource Localization: Check if referenced resources (books, websites, datasets) are available in the target language.
     • If not available, flag them (e.g., (GERMAN only)).
     • Propose/Search for localized alternatives if possible.
  5. Preserve: YAML keys (lang, date), Code blocks, Citation keys [@ref].
  6. Internal Link Structure: When encountering internal links like [Label](file.qmd), ensure they point to the correct translated filename (e.g., [Label](translated-file.qmd)).
  7. Translation Disclaimer: Add a standard disclaimer at the beginning of the content (after YAML) with the correct relative path to the original source.

     • Template (EN target):

       ::: callout-warning
       
       ## Automated Translation
       
       This exercise was automatically translated from the [German original](../../de/exercises/source-file.qmd) and may contain errors. Please consult the original version when in doubt.
       :::
       

B. Sync Update

• Input: Source file has changed, target files are outdated.
• Goal: Update targets to match source changes, including ensuring resource localization consistency.

2. Metadata Translation Guide

• Categories: Map strictly.
  • AI Literacy <-> KI-Kompetenz <-> Littératie IA
  • Source Criticism <-> Quellenkritik <-> Critique des sources
  • Ethics <-> Ethik <-> Éthique
  • Methods <-> Methoden <-> Méthodes
  • Public History (Keep as is)
• Tags: Translate descriptive tags.
  • e.g., Prompting (keep), Bias -> Biais, Privacy -> Datenschutz.

3. Workflow Steps

1. Read Source: Read the full content of the source file.
2. Generate Translation: Create the target file content.
   • Ensure lang: xx is correct in YAML.
   • Do not translate date or id.
   • Keep structure (Section levels ##) identical.
3. Write/Update: Overwrite the stub or outdated file.

4. Quality Check

• Do all three files have the same number of sections?
• Are citations identical?
• Is the YAML valid?