Genstrings et HeaderDoc ne font pas bon ménage!
Greensource
Membre
Bonjour! Il y a quelques chose qui me chagrine, j'utilise HeaderDoc pour la Doc et genstring pour la localisation.
Seulement HeaderDoc me refuse l'encodage UTF8 alors que genstring la réclame!
Vous êtes confronter à ce souci? Vous avez trouvé une parade?
Seulement HeaderDoc me refuse l'encodage UTF8 alors que genstring la réclame!
Vous êtes confronter à ce souci? Vous avez trouvé une parade?
Connectez-vous ou Inscrivez-vous pour répondre.
Réponses
C'est aussi pour ça que c'est plus simple et plus propre d'écrire même tes commentaires en anglais.
Dans un projet récent, j'avais laissé des chaà®nes en français avec accent le temps de les traduire... Bah les accents m'ont bien souvent embêtés dans mon code source : que ce soit les diff (avec FileMerge) etre les différentes versions SVN du code source (où dès qu'il y avait une différence entre 2 fichiers, FileMerge m'affichait aussi les caractères accentués comme différents, car il connaissait l'encodage du fichier local mais interprétait celui de l'ancienne version différemment...) ou pour d'autres trucs comme la doc.
Je te suggère donc deux solutions :
- Tout mettre en anglais et donc sans accents dans ton code source, y compris les commentaires. Les textes avec des accents sont à mettre dans les fichiers Localizable.strings (dont Apple conseille de les mettre en UTF-16, au passage)
- Si tu veux écrire une doc en français et non en anglais, et mettre donc cette doc dans ton code source pour l'autogénération ensuite... je crains que HeaderDoc te pose des soucis. Dans ce cas utilise Doxygen à la place (il y a même une doc sur le site d'Apple pour générer des docsets avec doxygen et ainsi voir tes docs dans l'aide Apple intégrée à Xcode ensuite, à côté de l'aide du iPhone SDK et du Mac SDK)
J'avais déjà ouvert un sujet sur ces forums aussi, sur la génération de doc automatique en utilisant doxygen et son intégration avec Xcode, s'il peut t'être utile...
En tout cas HeaderDoc c'est bien, mais ça m'a toujours donné l'impression d'un truc finalement pas totalement abouti, contrairement à Doxygen...
En même temps ça va être galère aussi si je veut tout mettre en Anglais.
Bon ce qui est sur c'est que le prochain coup je fait tout en Anglais ça évitera des souci. Je vais voir avec mes collègues ce qu'on décide, merci pour les infos!
Doxygen sait mettre des warnings quand y'a des tags de doc inconnus, etc... Donc après à mon avis ça va principalement consister à faire un rechercher/remplacer de @abstract en @brief ou des mots clés du genre, et vérifier les liens automatiques entre les pages de documentation (quand il rencontre un nom de méthode ou de classe dans la doc, ...).
Certes, pas super réjouissant à faire, mais bon, si HeaderDoc refuse l'UTF-8, de toute façon vous avez dû vous en apercevoir assez tôt du coup si votre doc est en fr, non ?
Ceci dit, avant de tout bousculer, ça vaut peut-être le coup de creuser un peu avec HeaderDoc si vous ne comptez pas forcément profiter de tous les avantages de Doxygen. Par exemple à regarder dans la doc et la section troubleshooting, ils parlent du tag @encoding à mettre dans le tag @header... ça peut peut-être contourner le pb ?
C'est pas faux pour Doxygen, j'avoue ne pas trop aimé le style de cette documentation mais pourquoi pas.
Hein ? quoi ?
Mais j'y suis pour rien moi :-\\
Bon courage dans ta conversion de doc vers Doxygène
Merci,
J'ai eu peur ::)