Bonjour � toutes et � tous,
Je souhaiterai avoir la documentation de mon API en plusieurs langues.
Actuellement je la g�n�re avec �Doxygen� tel qu'elle est dans le code, en Fran�ais (c'est mon choix, je pr�f�re que les gens s'expriment bien, plut�t qu'en globiche�moi le premier)
Pour g�n�rer les textes ajout� par Doxygen dans la langue que je souhaite c'est pas un soucis
https://www.doxygen.nl/manual/langhowto.html
Maintenant comment dire � Doxygen d'utiliser le texte en Espagnole ou en Russe� plut�t que celui en Fran�ais dans le code.
La solution (brutale) que j'imagine actuellement est la suivante:
- Ajouter une r�f�rence des textes � remplacer dans le code
- Dans un fichier exemple_es.trad ajouter le texte traduit.
Code : S�lectionner tout - Visualiser dans une fen�tre � part
1
2
3
4 \\@ref_trad toto \\\ \brief Documentation de la fonction toto dans l'en-tête exemple.h void Toto();
- Un script (en python :p) qui pour chaque langue hormis le Fran�ais copiera le code du projet et remplacera les textes et ex�cutera doxygen avec la bonne valeur assigner � OUTPUT_LANGUAGE
Code : S�lectionner tout - Visualiser dans une fen�tre � part
1
2
3
4
5 toto { \\\ \brief Documentación de la fonción toto en el fichero toto.h }
Je ne sais pas si il y a plus simple.
Je pense que la balise @ref_trad pourrait s'int�grer � la documentation de doxygen via un alias. Ce qui permettra de les masquer dans l'affichage des fichiers .h/.cpp dans les html g�n�r�s par Doxygen.
Qu'en pensez vous? Auriez vous des id�es � proposer?
Dans tout les cas merci.
Partager