Traduzione dei Jupyter Notebook (.ipynb): il codice resta eseguibile, ma il Markdown è leggibile?

Diagnosi dello stato attuale

I report di analisi dei dati di solito combinano codice eseguibile, risultati dell’esecuzione e testo esplicativo in Markdown; una traduzione totale può compromettere il funzionamento del codice o alterare i risultati prodotti.

Analisi delle cause principali

1

Smistamento intelligente dei tipi di cella

L’AI di Shangyi effettua lo smistamento in base al campo `cell_type` nella struttura JSON: le celle di tipo `markdown` vengono tradotte, mentre quelle di tipo `code` sono rigorosamente bloccate. Per quanto riguarda le celle di tipo `raw`, l’utente può scegliere se tradurle o meno in base alle proprie necessità.

2

Protezione delle formule incorporate nel Markdown

Nei blocchi Markdown si trovano spesso formule matematiche in formato LaTeX (come `$E=mc^2$`). Il motore AI riconosce i delimitatori `$`, trattando il loro contenuto come ‘token immutabili’ e traducendo solo il testo esplicativo attorno alle formule.

3

Pulizia dei dati di output

Per impostazione predefinita, si consiglia agli utenti di rimuovere l'output prima del caricamento, ma se sono presenti output testuali (come log di errore o risultati di stampa), l’AI può anche, in base alla configurazione, tradurre solo le parti in linguaggio naturale, mantenendo la struttura del Traceback.

Riepilogo soluzione finale

Risponde perfettamente alle esigenze di localizzazione per la condivisione di competizioni su Kaggle o per il materiale didattico, garantendo la sincronizzazione tra la logica del codice e la documentazione esplicativa.