Discussion:Javadoc

Bonjour,

Ma remarque concerne le passage "Toutefois, le concept ne permet de produire la doc de l'API que dans une unique langue."(Fin de page) Celui-ci me parait peu compréhensible... Je suggère une modification.

Votre avis ? -- sujet non signé posté le 6 août 2007 à 15:16‎ (CEST) par Gavors.

La formule est approprié car ce bloc de documentation n'indique pas explictement la langue utilisée, et ces blocs de commentaires sont généralement dans une seule langue, à mois d'utiliser dans le bloc un tag indiquant le langue utilisée dans la suite et d'en mentionner alors plusieurs succesivement, éventuellement en plusieurs sous-blocs traduits isolément et pas forcément en entier dans toutes les langues.

Ceci dit le code source Java n'est pas l'endroit le plus approprié pour effectuer ces traductions. Il est plus pratique d'utiliser un outil qui va extraire ces documentation dans leur langue source unique vers un fichier à traduire, et ensuite d'utiliser un outil externe (par exemple ceux basés sur la bibliothèque GNU pour getttext() et le format ".po") pour traduire ces éléments, puis générer un fichier formaté destiné à une interface utilisateur (par exemple en HTML/CSS/Javascript dans un navigateur web) qui permettra de consulter la documentation générée dans plusieurs langues et de naviguer dedans, sans que les traducteurs aient à modifier le code source ou le lire en entier. Verdy p (discuter) 24 octobre 2020 à 00:58 (CEST)