Javadoc en UTF-8

Version imprimable

04/04/2007, 10h09
barbiche

Javadoc en UTF-8

Je veux générer une Javadoc d'un programme que j'ai développé, mais lors de la visualisation de la Javadoc, les caractères avec des accents (ex : é è à ...) n'apparaissent pas comme il faut.
Il faut donc que j'utilise des caractères en UTF-8, mais je ne sais pas comment faire sous Netbeans.

PS : j'utilise Linux (je ne sais pas si ça a son importance).

Merci par avance.
06/04/2007, 04h11
mhamedbj

Citation:

Envoyé par barbiche

PS : j'utilise Linux (je ne sais pas si ça a son importance).

Merci par avance.

malheureusement oui :cry: :cry: :cry:
j'avais (et j'ai toujours) le même problème que toi, leproblème ne vien pas de netbean mais du jeu de caractère de linux, j'avais écris ma java doc sous linux, et n'apparaissé pas comme il faut sur windows donc je l'ai réecrite sous windows de coup elle n'apparait plus comme il faut sous linux !!!! :cry: :cry:

une solution serait que tu utilise le formatage web :
par exemple pour ecrire 'é' tu ecris '&eacute'... (je ne l'ai pas essayé, mais vue que la javadoc est formaté en html j'imagine que ça marche)

mais je voudrais bien savoir si il ya une solution a ce problème de jeu de caractère windows-linux !!
06/04/2007, 09h12
®om

Dans la ligne de commande de "javadoc", il suffit de rajouter -charset utf8 (j'ai rajouté ça aussi sous eclipse).

Alors que UTF8 devrait s'imposer, eclipse crée encore des projets en cp1252 au lieu d'utf8 sous windows (par contre il crée bien de l'utf8 sous linux), et la commande javadoc n'utilise pas utf8 par défaut :(
06/04/2007, 13h02
n!co

Moi ce que j'ai remarqué avec linux configuré en utf8 et netbeans configurer en utf8, c'est que les page sont bien généré au format utf8, mais sans la balise META indiquant a Firefox dans changer son format de décodage.

Comme la dit ®om, oblige la prise en compte de utf8 en rajoutant l'option -charset, via les propriétés du projet.

n!co
06/04/2007, 13h10
mhamedbj

Citation:

Envoyé par n!co

Moi ce que j'ai remarqué avec linux configuré en utf8 et netbeans configurer en utf8

comment t'as fais pour configurer netbeans et linux en utf8. je sort du topic mais stp stp stp comment t'as fais c'est hyper important !!!
06/04/2007, 13h19
n!co

Linux c'est pas moi qui l'ai fait, pour netbeans :

Citation:

Tools - Advanced Options - Java Sources - Default Encoding

Il y a juste à rentrer utf8 ;)
06/04/2007, 13h25
mhamedbj

comme c'est juste la moitié de le réponse, tu as droit a un demi merci !! ;)

trop cool merci bcp !
07/04/2007, 09h01
gifffftane

Si jamais ça vous intéresse, pour régler ce genre de problèmes je me suis fabriqué un petit script beanshell capable de transformer facilement un ensemble de fichiers vers un codage déterminé.

Dans l'esprit des pipes unix, il prend en entrée la sortie de la commande "file", qui donne automatiquement l'encodage du fichier origine, puis il transforme le fichier dans l'encodage voulu, et précisé sur la ligne de commande.

Comme vous pouvez l'imaginer en lisant mes explications, le script est assez bidouillesque, mais il m'a rendu de grands services, et je peux toujours l'améliorer... Comme il est pas très long, il se comprend facilement.

Comme la commande "file" ne fonctionne pas sous windows, le script est moins pratique sous windows. Il faudra donner aussi l'encodage d'entrée sur la ligne de commande, fichier par fichier.
07/04/2007, 12h01
®om

Citation:

Envoyé par gifffftane

Si jamais ça vous intéresse, pour régler ce genre de problèmes je me suis fabriqué un petit script beanshell capable de transformer facilement un ensemble de fichiers vers un codage déterminé.

Dans l'esprit des pipes unix, il prend en entrée la sortie de la commande "file", qui donne automatiquement l'encodage du fichier origine, puis il transforme le fichier dans l'encodage voulu, et précisé sur la ligne de commande.

Comme vous pouvez l'imaginer en lisant mes explications, le script est assez bidouillesque, mais il m'a rendu de grands services, et je peux toujours l'améliorer... Comme il est pas très long, il se comprend facilement.

Comme la commande "file" ne fonctionne pas sous windows, le script est moins pratique sous windows. Il faudra donner aussi l'encodage d'entrée sur la ligne de commande, fichier par fichier.

Tu peux en faire un copier coller ici? :)

Ah. J'en ai déjà fait un en privé... Heureusement que public dépasse private, hein ?

Mêmes remarques générales : c'est de la bidouille perso, qui probablement ne fonctionne que par hasard, et probablement détruira absolument tout ce qu'elle touchera, et que je serais absolument enchanté d'améliorer si-cela-peut-servir-à-quelque-chose.

J'ajoute pour la bonne forme je me suis aventuré à montrer ce code sur un forum linux, je ne sais plus du tout à la suite de quoi, et tout le monde s'est mis à hurler de rire, car, disent-ils, C'est bien plus facile avec awk, conv, grep, ls, pwd, tar, find, cd, etc. Dont acte. Merci.

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
#! /bin/bash 
//bin/bash -c "exec java bsh.Interpreter $0 $1 $2";exit 
 
import java.nio.*;
import java.nio.channels.*;
import java.nio.charset.*;
import java.util.regex.*;
 
String nomDuCodage(String demande)
{
	but = demande;
	switch (demande)
	{
		case "ISO-8859":
			but = "ISO-8859-1";
			break;
		case "Perl5":
			but = "UTF-8"; // je suppose
			break;
		case "empty":
			but = null;
			break;
	}
	return but;
}
 
 
nompourencodageentree = null;
nompourencodagesortie = null;
if (bsh.args.length == 0)
{
	print("codeconv.bsh encodageEntree encodageSortie");
	print("-> lecture du nom du fichier sur l'entree standard \n    (s'adpate au resultat de la commande file)");
	print("*");
	print("utitilisation avec 'file', pour designer automatiquement l'encodage d'entree : ");
	print("file `find ...options...` | codeconv.bsh UTF-8\n");
	System.exit(0);
}
if (bsh.args.length > 1)
{
	nompourencodageentree = bsh.args[0];
	nompourencodagesortie = bsh.args[1];
	print("encodage d'entree (ou par defaut) : "+nompourencodageentree);
	print("encodage de sortie : "+nompourencodagesortie);
}
else
{
	nompourencodagesortie = bsh.args[0];
	print("encodage d'entree donne par la sortie de la commande 'file'");	
	print("encodage de sortie : "+nompourencodagesortie);
}
 
pattfile = Pattern.compile("(.*?):\\s+(\\S*) ?.*");
 
scan = new Scanner(System.in);
tmp = File.createTempFile("codeconv", "tmp");
tmp.deleteOnExit(); 
while (scan.hasNextLine())
{
	// lecture et transformation du fichier vers un temporaire
	ligne = scan.nextLine();
	match = pattfile.matcher(ligne);
	nomfichier = ligne;
	if (match.matches())
	{
		nomfichier = match.group(1);
		nompourencodageentree = nomDuCodage(match.group(2));
	}
	if (nompourencodageentree != null)
	{
		if (!nompourencodageentree.equals(nompourencodagesortie))
		{
			in = new File(nomfichier);
			inlength = in.length();
			inf = new FileInputStream(in);
			ouf = new FileOutputStream(tmp);
			inc = inf.getChannel();
			ouc = ouf.getChannel();
			inmap = inc.map(FileChannel.MapMode.READ_ONLY, 0, inlength);
			codein = Charset.forName(nompourencodageentree).newDecoder();
			cbin = codein.decode(inmap);
			codeout = Charset.forName(nompourencodagesortie).newEncoder();
			cout = codeout.encode(cbin);
			ouc.write(cout);
			inc.close();
			ouc.close();
 
			// remplacement de l'original par le nouveau
			tmp = new File(tmp.getCanonicalPath());
			oufori = new FileOutputStream(in);
			inftmp = new FileInputStream(tmp);
			oucori = oufori.getChannel();
			inctmp = inftmp.getChannel();
			oucori.transferFrom(inctmp, 0, tmp.length());
			oucori.close();
			inctmp.close(); 
			print("+ "+nomfichier+" ("+nompourencodageentree+" -> "+nompourencodagesortie+") FAIT.");
		}
		else
			print("+ "+nomfichier+" ("+nompourencodageentree+") PASSE.");
	}
	else
		print("+ "+nomfichier+" VIDE.");
}