La création d'une solution ne s'arrête pas une fois le développement terminé. Pour de nombreuses organisations, le défi suivant consiste à mettre cette solution à la disposition de différentes équipes, de différents clients ou de différents marchés, souvent dans plusieurs langues.
La documentation technique, les manuels, les guides d'utilisation et autres contenus au format Markdown font partie intégrante de cette expérience. Cependant, la traduction de ce type de documents à l'aide d'outils classiques ou de processus manuels comporte un risque important : celui d'altérer des éléments structurels qui doivent rester intacts.
Une modification involontaire dans un tableau, un lien, une balise HTML, un bloc de code ou même une balise de mise en forme peut compromettre l'intégrité du document et entraîner des problèmes lors de l'utilisation ou de la maintenance de la solution.
Internationaliser des solutions sans compromettre leur intégrité
Avec l'arrivée de Markdown Translate, MasterBase® Automation Studio Build offre une nouvelle fonctionnalité aux concepteurs de solutions qui ont besoin d'adapter leurs projets à différentes langues sans compromettre la structure technique de la documentation.
Cet outil a été spécialement conçu pour analyser la structure complète d'un document Markdown avant de lancer la traduction.
Au lieu de traiter le fichier comme du texte brut, Markdown Translate convertit le document en une représentation basée sur AST (arbre de syntaxe abstraite). À partir de cette structure, il identifie les éléments qui relèvent du langage naturel et ceux qui font partie de la définition technique du document, en ne traduisant que le contenu qui doit être adapté à une autre langue.
Traduction intelligente pour la documentation technique
Cette approche permet d'éviter l'un des problèmes les plus courants des traductions automatiques traditionnelles : la modification d'informations qui ne devraient pas être modifiées.
Au cours du processus de traduction, Markdown Translate préserve :
- titres et en-têtes Markdown ;
- listes et tableaux ;
- liens ;
- blocs de code ;
- code inline ;
- HTML intégré ;
- les balises et autres éléments structurels du document.
La version traduite conserve donc la même structure que le document d'origine
original, car son intégrité a été préservée et le risque d'erreurs découlant de
de modifications involontaires.
Plus de capacités pour ceux qui conçoivent des solutions
Cette nouvelle fonctionnalité s'avère particulièrement utile pour les organisations et les équipes qui développent des solutions avec MasterBase® Automation Studio Build et qui doivent les déployer dans différentes langues.
Les concepteurs de solutions peuvent conserver une base documentaire unique et générer des versions adaptées à différents marchés, clients ou utilisateurs, sans avoir à reconstituer manuellement chaque document ni à corriger les modifications structurelles apportées par des outils de traduction génériques.
Cela facilite la publication de solutions accompagnées d'une documentation cohérente, améliore la maintenabilité et réduit l'effort lié à l'internationalisation des projets.
Une nouvelle fonctionnalité pour Automation Studio Build
Automation Studio Build continue d'élargir les fonctionnalités mises à la disposition des concepteurs de solutions utilisant Configware.
Avec Markdown Translate, l'internationalisation de la documentation technique n'est plus une tâche manuelle présentant un risque élevé d'altérer la structure du contenu, mais devient un processus fiable qui préserve l'intégrité du document d'origine tout en adaptant la langue à chaque besoin de publication.
Ainsi, les concepteurs de solutions peuvent se concentrer sur l'élargissement de la portée de leurs développements, en proposant des expériences cohérentes aux utilisateurs de différentes langues sans compromettre la qualité technique de la documentation.
Découvrez comment Markdown Translate vous aide à créer, adapter et publier des solutions multilingues tout en préservant l'intégrité de votre documentation technique.
