La creazione di una soluzione non termina con il completamento dello sviluppo. Per molte organizzazioni, la sfida successiva consiste nel rendere tale soluzione accessibile a diversi team, clienti o mercati, spesso in diverse lingue.
La documentazione tecnica, i manuali, le guide all’uso e altri contenuti in formato Markdown fanno parte di questa esperienza. Tuttavia, tradurre questo tipo di documenti utilizzando strumenti convenzionali o processi manuali comporta un rischio significativo: quello di alterare elementi strutturali che devono rimanere intatti.
Una modifica involontaria in una tabella, un link, un tag HTML, un blocco di codice o persino un'indicazione di formattazione può compromettere l'integrità del documento e causare problemi durante l'utilizzo o la manutenzione della soluzione.
Internazionalizzare le soluzioni senza comprometterne l'integrità
Con l'aggiunta di Markdown Traduci, MasterBase® Automation Studio Build offre una nuova funzionalità agli sviluppatori di soluzioni che hanno bisogno di adattare i propri progetti a diverse lingue senza compromettere la struttura tecnica della documentazione.
Lo strumento è stato progettato appositamente per riconoscere la struttura completa di un documento Markdown prima di avviare la traduzione.
Anziché elaborare il file come testo semplice, Markdown Translate converte il documento in una rappresentazione basata su AST (Albero di sintassi astratta). Partendo da tale struttura, identifica quali elementi corrispondono al linguaggio naturale e quali fanno parte della definizione tecnica del documento, traducendo solo il contenuto che deve essere tradotto in un’altra lingua.
Traduzione intelligente per la documentazione tecnica
Questo approccio consente di evitare uno dei problemi più frequenti delle traduzioni automatiche tradizionali: la modifica di informazioni che non dovrebbero essere alterate.
Durante il processo di traduzione, Markdown Translate protegge:
- titoli e intestazioni Markdown;
- elenchi e tabelle;
- link;
- blocchi di codice;
- codice inline;
- HTML incorporato;
- etichette e altri elementi strutturali del documento.
Di conseguenza, la versione tradotta mantiene la stessa struttura del documento
originale, poiché ne è stata preservata l'integrità e si è ridotto il rischio di errori derivanti da
di modifiche involontarie.
Maggiore capacità per chi sviluppa soluzioni
Questa nuova funzionalità risulta particolarmente utile per le organizzazioni e i team che sviluppano soluzioni con MasterBase® Automation Studio Build e hanno bisogno di distribuirle in diverse lingue.
I creatori di soluzioni possono mantenere un unico archivio documentale e generare versioni adattate a diversi mercati, clienti o utenti, senza dover ricostruire manualmente ogni documento né rivedere le modifiche strutturali apportate dagli strumenti di traduzione generici.
Ciò facilita la pubblicazione di soluzioni con una documentazione coerente, migliora la manutenibilità e riduce lo sforzo necessario per l'internazionalizzazione dei progetti.
Una nuova funzionalità per Automation Studio Build
Automation Studio Build continua ad ampliare le funzionalità a disposizione di chi progetta soluzioni utilizzando Configware.
Con Markdown Translate, l'internazionalizzazione della documentazione tecnica smette di essere un’attività manuale che comporta un elevato rischio di alterare la struttura dei contenuti e diventa invece un processo affidabile che preserva l’integrità del documento originale, adattando al contempo la lingua alle diverse esigenze di pubblicazione.
In questo modo, gli sviluppatori di soluzioni possono concentrarsi sull'ampliamento della portata dei propri progetti, offrendo esperienze coerenti agli utenti di diverse lingue senza compromettere la qualità tecnica della documentazione.
Scopri come Markdown Translate ti aiuta a creare, adattare e pubblicare soluzioni multilingue preservando l'integrità della tua documentazione tecnica.
