[PhpDocumentor] Gestion des commentaires avec accents

Nullos Oracle · 18/07/2007, 20h47

Bonjour à tous !

Petit soucis dans l'utilisation de PhpDocumentor pour la génération de doc : en effet, c'est une doc française donc les commentaires de mon code source sont bien souvent remplis de mots avec des accents. Problème : PhpDocumentor affiche les données en UTF-8 avec le package d'interface HTML:Smarty:default.

Ok facile, suffit de remplacer les accents par leur code avec des "&"... seulement là ce sont mes sources qui deviennent illisibles. Comment avoir la gestion des accents pour la génération de doc sans avoir à changer les accents (ou les virer

) ? J'aimerais éviter de modifier à la main la doc générée histoire d'automatiser un peu...

Merci de vos éclaircissements.

fafe80 · 07/08/2007, 11h56

Salut,

J'ai eu le même soucis et en farfouillant sur le net j'ai trouvé une solutions qui fonctionne pour moi.

A prioris tu utilises le package d'interface : HTML:Smarty:default

Alors il te suffit d'aller dans le dossier :
racine/phpDocumentor/Converters/HTML/Smarty/templates/default/templates

Tu rajoutes entre les balises <head> une balise meta avec le bon charset
(ex :<meta http-equiv="Content-type" content="text/html; charset=utf-8" />)

Normalement lorsque tu régénéres la doc tu ne devrais plus avoir de soucis d'accents. (en plus tu ne touches pas à tes codes sources)

@+

1emach · 10/08/2007, 11h59

est-il egalement d'utiliser ta methode si j'utilise PhpDocumentor a partir de l'interface web?

Parce-que j'ai effectué la manip que tu a decrite mais je n'ai pas obtenu de resultat positif. Est-ce bien le fichier header.tpl qu'il faut modifier dans le dossier racine/phpDocumentor/Converters/HTML/Smarty/templates/default/templates?

rolandcire · 18/09/2007, 11h24

Bonjour,

Je confirme, cela fonctionne via l'interface web en indiquant "charset=utf-8".

Attention, toutefois, à bien modifier ton template (ex phpdoc.de) et le template par défaut (default).

Bonne continuation

18/07/2007, 20h47	#1
Nullos Oracle Invité régulier Inscription : mars 2005 Messages : 58 Détails du profil Informations forums : Inscription : mars 2005 Messages : 58 Points : 9 Points : 9	[PhpDocumentor] Gestion des commentaires avec accents Bonjour à tous ! Petit soucis dans l'utilisation de PhpDocumentor pour la génération de doc : en effet, c'est une doc française donc les commentaires de mon code source sont bien souvent remplis de mots avec des accents. Problème : PhpDocumentor affiche les données en UTF-8 avec le package d'interface HTML:Smarty:default. Ok facile, suffit de remplacer les accents par leur code avec des "&"... seulement là ce sont mes sources qui deviennent illisibles. Comment avoir la gestion des accents pour la génération de doc sans avoir à changer les accents (ou les virer ) ? J'aimerais éviter de modifier à la main la doc générée histoire d'automatiser un peu... Merci de vos éclaircissements.
	00

07/08/2007, 11h56	#2
fafe80 Invité de passage Inscription : août 2007 Messages : 1 Détails du profil Informations personnelles : Âge : 32 Informations forums : Inscription : août 2007 Messages : 1 Points : 1 Points : 1	Salut, J'ai eu le même soucis et en farfouillant sur le net j'ai trouvé une solutions qui fonctionne pour moi. A prioris tu utilises le package d'interface : HTML:Smarty:default Alors il te suffit d'aller dans le dossier : racine/phpDocumentor/Converters/HTML/Smarty/templates/default/templates Tu rajoutes entre les balises <head> une balise meta avec le bon charset (ex :<meta http-equiv="Content-type" content="text/html; charset=utf-8" />) Normalement lorsque tu régénéres la doc tu ne devrais plus avoir de soucis d'accents. (en plus tu ne touches pas à tes codes sources) @+
	00

10/08/2007, 11h59	#3
1emach Invité de passage Inscription : août 2007 Messages : 1 Détails du profil Informations forums : Inscription : août 2007 Messages : 1 Points : 1 Points : 1	est-il egalement d'utiliser ta methode si j'utilise PhpDocumentor a partir de l'interface web? Parce-que j'ai effectué la manip que tu a decrite mais je n'ai pas obtenu de resultat positif. Est-ce bien le fichier header.tpl qu'il faut modifier dans le dossier racine/phpDocumentor/Converters/HTML/Smarty/templates/default/templates?
	00

18/09/2007, 11h24	#4
rolandcire Candidat au titre de Membre du Club Inscription : septembre 2006 Messages : 43 Détails du profil Informations forums : Inscription : septembre 2006 Messages : 43 Points : 11 Points : 11	Bonjour, Je confirme, cela fonctionne via l'interface web en indiquant "charset=utf-8". Attention, toutefois, à bien modifier ton template (ex phpdoc.de) et le template par défaut (default). Bonne continuation
	00

Outils de la discussion
Afficher une version imprimable Envoyer un lien vers cette page par email