Sono felice di presentarvi il mio progetto AI-Powered Markdown Translator, uno script Python open-source che rivoluziona la traduzione automatica di tutti i file Markdown del mio blog e dei miei repository GitLab. Integrando modelli di intelligenza artificiale all’avanguardia come OpenAI, Mistral AI, Anthropic (Claude) e Google Gemini, questo strumento traduce i miei articoli, i README e le documentazioni tecniche in molte lingue (inglese, spagnolo, cinese, ecc.), mantenendone struttura e formattazione. Questo progetto mette in luce le mie competenze in automazione, integrazione di IA e sviluppo Python, oltre alla mia passione per rendere i contenuti tecnici accessibili a tutti.
Non è solo uno script: è una prova della mia esperienza e della mia visione per un mondo digitale più inclusivo.
Perché questo progetto ?
I file Markdown sono essenziali per il mio ecosistema digitale: contengono i miei articoli del blog, tutorial e documentazioni open-source. Automatizzandone la traduzione, rendo i miei contenuti accessibili a un pubblico mondiale. Per esempio, il mio blog è ora disponibile in 14 lingue grazie a questo script, il che ne amplifica l’impatto. Ecco alcuni esempi concreti dello script in azione:
Questo progetto mostra come l’IA possa risolvere problemi pratici favorendo al contempo l’accessibilità.
Le mie competenze in evidenza
Questo script è una vetrina delle mie competenze tecniche. Ecco cosa mette in risalto:
- Integrazione di API di IA multiple: Ho collegato modelli come
gpt-5,mistral-large-latest,claude-sonnet-4-5egemini-3-pro, adattando il codice alle loro specificità. - Progettazione intelligente: Lo script preserva i blocchi di codice, i link e i metadati grazie a tecniche avanzate di gestione dei placeholders.
- Risoluzione di problemi complessi: Ho superato sfide come la gestione dei limiti di token e la fedeltà del formato Markdown.
- Spirito open-source: Disponibile su GitLab, questo progetto invita la comunità a collaborare e a migliorarlo.
Questi aspetti testimoniano la mia capacità di creare strumenti potenti e pratici.
Funzionalità principali
Ecco cosa offre lo script:
- Multi-Provider: Supporto di 4 API (OpenAI, Mistral AI, Claude, Gemini)
- Modelli 2026: GPT-5, Claude Sonnet 4.5, Gemini 3 Pro per impostazione predefinita
- Modalità Economica (
--eco): modelli più veloci e meno costosi (gpt-5-mini, claude-haiku, gemini-flash) - File Singolo (
--file): Tradurre un singolo file invece di un’intera directory - Conservazione del nome (
--keep_filename): Mantiene il nome e l’estensione originali (ideale per Astro, Hugo, ecc.) - Supporto
.env: caricamento automatico delle chiavi API da un file.env - Supporto file
.mdx: oltre ai classici file.md - Nota di traduzione (
--add_translation_note): aggiunge una nota alla fine del documento indicando il modello usato - Preservazione del formato: blocchi di codice e link rimangono intatti
- Gestione del front matter: traduce
titleedescription, aggiornalocale, preserva le altre metadate
| Fornitore | Qualità (predefinita) | Economico (--eco) |
|---|---|---|
| OpenAI | gpt-5 | gpt-5-mini |
| Claude | claude-sonnet-4-5 | claude-haiku-4-5 |
| Mistral | mistral-large-latest | mistral-small-latest |
| Gemini | gemini-3-pro-preview | gemini-3-flash-preview |
È il frutto del mio lavoro e della mia passione per l’automazione.
Impatto e prospettive
Questo script rende il mio blog e i miei progetti open-source accessibili a un pubblico senza confini linguistici. Non traduce solo parole: democratizza la conoscenza tecnica.
Provalo tu stesso
Scopri il progetto su GitLab, provalo con i tuoi file Markdown e condividi il tuo feedback. Le tue idee mi aiutano a perfezionarlo!
Contatto: contact@jls42.org
Questo documento è stato tradotto dalla versione fr alla lingua it utilizzando il modello gpt-5-mini. Per maggiori informazioni sul processo di traduzione, consultare https://gitlab.com/jls42/ai-powered-markdown-translator