src/help/fr/CustomImports.html

   1 <html xmlns="http://www.w3.org/1999/xhtml">
   2
   3 <body text="#275856">
   4     <basefont size="4"
   5           color="#2F4958"
   6           face="arial" />
   7
   8     <h1>Filtres d'importation personnalis&eacute;s</h1>
   9
  10     <p>JabRef vous permet de d&eacute;finir et d'utiliser vos
  11     propres formats d'importation, d'une fa&ccedil;on tr&egrave;s
  12     similaire aux filtres d'importation standard qui sont
  13     d&eacute;finis. Un filtre d'importation est d&eacute;fini par
  14     une ou plusieurs <i>classes</i> Java qui analyse le contenu
  15     d'un fichier &agrave; partir d'un flux d'entr&eacute;e et
  16     cr&eacute;e des entr&eacute;es BibTeX. Ainsi, avec un peu de
  17     programmation de base en Java, vous pouvez ajouter un format
  18     d'importation correspondant &agrave; votre source de
  19     r&eacute;f&eacute;rences favorite ou enregistrer une version
  20     am&eacute;lior&eacute;e d'un format d'importation existant. De
  21     plus, cela vous permet d'ajouter des formats d'importation
  22     personnalis&eacute;s compil&eacute;s que vous pourriez obtenir
  23     &agrave; partir de SourceForge (par exemple) sans avoir
  24     &agrave; recompiler JabRef (voir plus bas "Partager votre
  25     travail").</p>
  26
  27     <p>Les formats d'importation personnalis&eacute;s sont
  28     prioritaires sur les formats d'importation standard. De cette
  29     fa&ccedil;on, vous pouvez remplacer les formats d'importations
  30     existants pour les fonctions d'auto-d&eacute;tection et de
  31     ligne de commande de JabRef. Les formats d'importation
  32     personnalis&eacute;s sont class&eacute;s par nom.</p>
  33
  34     <h2>Ajouter un filtre d'importation personnalis&eacute;</h2>
  35
  36     <p>Assurez-vous que vous avez un filtre d'importation
  37     personnalis&eacute; compil&eacute; (un ou plusieurs fichiers
  38     <code>.class</code> sont d&eacute;crits ci-dessous) et que les
  39     fichiers de classe soient dans la structure des
  40     r&eacute;pertoires selon la structure de leur paquetage. Pour
  41     ajouter un nouveau filtre d'importation personnalis&eacute;,
  42     ouvrez la bo&icirc;te de dialogue <b>Options -&gt; G&eacute;rer
  43     les importations personnalis&eacute;es</b>, et cliquez&nbsp;
  44     <b>Ajouter &agrave; partir du r&eacute;pertoire</b>. Une
  45     fen&ecirc;tre de s&eacute;lection de fichier appara&icirc;tra,
  46     vous permettant de s&eacute;lectionner le chemin de classe de
  47     votre filtre d'importation, c'est &agrave; dire le
  48     r&eacute;pertoire o&ugrave; se trouve le r&eacute;pertoire
  49     sup&eacute;rieur de votre structure de paquetage. Vous ouvrirez
  50     autant de&nbsp; fen&ecirc;tres que n&eacute;cessaire pour
  51     s&eacute;lectionner votre fichier de classe de filtre
  52     d'importation, lequel doit d&eacute;river de
  53     <code>ImportFormat</code>. Cela permettra ainsi d'indiquer le
  54     chemin complet d'acc&egrave;s au fichier de classe. En cliquant
  55     sur <b>S&eacute;lectionner une nouvelle sous-classe de format
  56     d'importation</b>, votre nouveau filtre d'importation
  57     appara&icirc;tra dans la liste des filtres d'importation
  58     personnalis&eacute;s. Tous les filtres d'importations
  59     personnalis&eacute;s appara&icirc;tront dans le menu <b>Fichier
  60     -&gt; Importer -&gt; Filtres d'importation
  61     personnalis&eacute;s</b> et <b>Fichier -&gt; Importer et
  62     joindre -&gt; Filtres d'importation personnalis&eacute;s</b> de
  63     la fen&ecirc;tre de JabRef.</p>
  64
  65     <p>S'il vous pla&icirc;t, notez que si vous d&eacute;placez la
  66     classe vers un autre r&eacute;pertoire, vous aurez &agrave;
  67     supprimer et &agrave; r&eacute;-ajouter le filtre
  68     d'importation. Si vous ajoutez un filtre d'importation
  69     personnalis&eacute; sous un nom qui existe d&eacute;j&agrave;,
  70     le filtre d'importation existant sera remplac&eacute;. De plus,
  71     dans certains cas, il est possible de mettre &agrave; jour un
  72     filtre d'importation personnali s&eacute; existant sans
  73     red&eacute;marrer JabRef (lorsque le filtre d'importation n'est
  74     pas dans le chemin de classe). Cependant, nous recommandons de
  75     red&eacute;marrer JabRef apr&egrave;s la mise &agrave; jour
  76     d'un filtre d'importation personnalis&eacute;. Vous pouvez
  77     aussi ajouter des filtres d'importation contenu dans un fichier
  78     ZIP ou JAR&nbsp;; s&eacute;lectionnez simplement l'archive Zip
  79     ou Jar, puis l'entr&eacute;e (fichier de classe) qui correspond
  80     au nouveau filtre d'importation.</p>
  81
  82     <h2>Cr&eacute;er un filtre d'importation</h2>
  83
  84     <p>Pour des exemples
  85     et quelques fichiers utiles sur la fa&ccedil;on de construire
  86     vos propres filtres d'importation, consultez s'il vous
  87     pla&icirc;t la page de t&eacute;l&eacute;chargement.</p>
  88
  89     <h3>Un exemple simple</h3>
  90
  91     <p>Supposons que vous vouliez importer des fichiers de la forme
  92     suivante&nbsp;:</p>
  93     <pre>
  94 1936;John Maynard Keynes;The General Theory of Employment, Interest and Money
  95 2003;Boldrin &amp; Levine;Case Against Intellectual Monopoly
  96 2004;ROBERT HUNT AND JAMES BESSEN;The Software Patent Experiment
  97 </pre>
  98
  99     <p>Dans votre outil de d&eacute;veloppement ou &eacute;diteur
 100     de texte pr&eacute;f&eacute;r&eacute;, cr&eacute;ez une classe
 101     d&eacute;riv&eacute;e de <code>ImportFormat</code> qui
 102     impl&eacute;mente les m&eacute;thodes
 103     <code>getFormatName()</code>, <code>isRecognizedFormat</code>
 104     and <code>importEntries()</code>. En voici un
 105     exemple&nbsp;:</p>
 106     <pre>
 107 import java.io.*;
 108 import java.util.*;
 109 import net.sf.jabref.*;
 110 import net.sf.jabref.imports.ImportFormat;
 111 import net.sf.jabref.imports.ImportFormatReader;
 112
 113 public class SimpleCsvImporter extends ImportFormat {
 114
 115   public String getFormatName() {
 116     return "Simple CSV Importer";
 117   }
 118
 119   public boolean isRecognizedFormat(InputStream stream) throws IOException {
 120     return true; // ceci est d&eacute;conseill&eacute; sauf pour les besoins de la d&eacute;monstration
 121   }
 122
 123   public List importEntries(InputStream stream) throws IOException {
 124         ArrayList bibitems = new ArrayList();
 125     BufferedReader in = new BufferedReader(ImportFormatReader.getReaderDefaultEncoding(stream));
 126
 127     String line = in.readLine();
 128     while (line != null) {
 129       if (!"".equals(line.trim())) {
 130         String[] fields = line.split(";");
 131         BibtexEntry be = new BibtexEntry(Util.createNeutralId());
 132         be.setType(BibtexEntryType.getType("techreport"));
 133         be.setField("year", fields[0]);
 134         be.setField("author", fields[1]);
 135         be.setField("title", fields[2]);
 136         bibitems.add(be);
 137         line = in.readLine();
 138       }
 139     }
 140         return bibitems;
 141   }
 142 }
 143 </pre>
 144
 145     <p>Notez que l'exemple est dans le paquetage par d&eacute;faut.
 146     Supposez que vous l'avez sauv&eacute; sous
 147     <code>/mypath/SimpleCsvImporter.java</code>. Supposez aussi que
 148     JabRef-2.0.jar est dans le m&ecirc;me r&eacute;pertoire que
 149     <code>SimpleCsvImporter.java</code> et que Java est dans votre
 150     chemin d'ex&eacute;cutables. Compilez-le en utilisant par
 151     exemple JSDK 1.4 avec</p>
 152     <pre>
 153 javac -classpath JabRef-2.0.jar SimpleCsvImporter.java
 154 </pre>A pr&eacute;sent il doit y avoir un fichier
 155 <code>/mypath/SimpleCsvImporter.class</code>.
 156
 157     <p>Dans JabRef, ouvrez <b>Options -&gt; G&eacute;rer les
 158     importations personnalis&eacute;es</b>, et cliquez sur
 159     <b>Ajouter &agrave; partir du r&eacute;pertoire</b>. Allez dans
 160     <code>/mypath</code> et cliquez le bouton
 161     <b>S&eacute;lectionner...</b>. S&eacute;lectionnez
 162     <code>SimpleCsvImporter.class</code> et cliquez sur le bouton
 163     <b>S&eacute;lectionner...</b>. Votre filtre d'importation
 164     devrait maintenant appara&icirc;tre dans la liste des filtres
 165     d'importation personnalis&eacute;s sous le nom "Simple CSV
 166     Importer" et, apr&egrave;s avoir cliqu&eacute; sur
 167     <b>Fermer</b>, aussi dans les menus <b>Fichier -&gt; Importer
 168     -&gt; Filtres d'importation personnalis&eacute;s</b> et
 169     <b>Fichier -&gt; Importer et joindre -&gt; Filtres
 170     d'importation personnalis&eacute;s</b> de la fen&ecirc;tre de
 171     JabRef.</p>
 172
 173     <h2>Partager votre travail</h2>
 174
 175     <p>Avec des fichiers de filtres d'importation
 176     personnalis&eacute;s, il est vraiment simple de partager des
 177     formats d'importation personnalis&eacute;s entre utilisateurs.
 178     Si vous &eacute;crivez un filtre d'importation pour un format
 179     non support&eacute; par JabRef, ou l'am&eacute;lioration d'un
 180     filtre existant, nous vous encourageons &agrave; soumettre
 181     votre travail sur notre page SourceForge.net. Nous serons
 182     heureux de distribuer la collection des fichiers d'importation
 183     soumis, ou d'en ajouter &agrave; la s&eacute;lection de filtres
 184     d'importation standard.</p>
 185 </body>
 186 </html>