Comment g�n�rer une documentation multilingue avec doxygen?
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
Code:
1 2 3 4
|
\\@ref_trad toto
\\\ \brief Documentation de la fonction toto dans l'en-tête exemple.h
void Toto(); |
- Dans un fichier exemple_es.trad ajouter le texte traduit.
Code:
1 2 3 4 5
|
toto
{
\\\ \brief Documentación de la fonción toto en el fichero toto.h
} |
- 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
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.