2.1 Généralités

2.1.1 Formats de fichier

jPicEdt a été créé pour produire des dessins au format LaTeX de façon que ceux-ci puissent être directement inclus dans un document LaTeX. Il est également possible de faire en sorte que le dessin soit un document maître LaTeX — voir Pro/épilogue utilsateur.

Plus généralement, on distingue un format de fichier que jPicEdt peut manipuler comme il suit :

• un format propre : c’est le format JPIC-XML qui est spécifique à jPicEdt (JPIC-XML est un format XML ; il ressemble fortement au format bien connnu SVG, à ceci près qu’il a des étiquettes de balise en plus dédiées aux primitives graphiques propres à jPicEdt que SVG ne saurait connaître).
• un format d’import : un dessin est seulement lu à partir du fichier, il peut y avoir une perte d’information depuis le contenu du fichier, vers la représentation en mémoire du dessin, jPicEdt après importation du dessin ne garde pas le même fichier, mais demande à l’utilisateur de désigner un nouveau fichier pour la sauvegarde,
• un format d’export : un dessin est seulement écrit dans le fichier, il peut y avoir une perte d’information depuis la représentation en mémoire du dessin vers le contenu du fichier, pour l’exportation jPicEdt demande à l’utilisateur de désigner un nouveau fichier distinct de celui dans lequel le dessin peut être sauvegardé,
• un format de sauvegarde: un dessin peut être lu ou écrit dans ce format sans perte d’informations avec des commandes du type "Ouvrir" "Enregistrer" et "Enregistrer sous". Lorsque vous sauvegardez un dessin, jPicEdt utilise toujours un format de sauvegarde. Dans un format de sauvegarde le dessin est représenté deux fois:
  • tout d’abord une partie JPIC-XML en JPIC-XML enfoui,
  • puis une partie exportée dans un format d’export de votre choix (par ex. LaTeX), selon une variante de votre choix (pour LaTeX il y a trois variantes: LaTeX de base utilisant l’environnement picture, epic, et pstricks)

  la partie JPIC-XML est en code JPIC-XML enfoui, c’est à dire que le JPIC-XML apparaît inséré sous la forme de commentaires conformes au format d’export sélectionné.

• un format convertible, c’est grosso modo la même chose qu’un format d’import, sauf qu’il existe un format de sauvegarde correspondant. Aussi, lorsque on ouvre un fichier dans un format convertible, jPicEdt ne demande pas à l’utilisateur de désigner un nouveau fichier pour la sauvegarde, mais utilise le même fichier. Toutefois si le dessin est modifié puis sauvegardé, jPicEdt change le format convertible dans le format de sauvegarde correspondant.

Un même format de sauvegarde peut avoir plusieurs variantes, et on désigne par type de contenu l’ensemble format de sauvegarde + variante.

jPicEdt ne produit pas directement de fichier en format propre, ce format est produit en hackant sous Emacs un fichier qui est dans un format de sauvegarde grâce au paquetage d’extension jpicedt.el pour Emacs. Lors de cette opération le fichier est débarrassé de la partie en format d’exportation, et il ne reste que la partie en JPIC-XML qui est mise dans un format variante du JPIC-XML pour faciliter le hackage.

Il est à noter que du point de vue de l’importation d’un dessin venant d’un autre logiciel il faut que le format un format d’import ou un format convertible, ainsi la différence entre format d’import et format convertible n’est qu’une question de créer ou pas un nouveau fichier pour jPicEdt.

Réciproquement du point de vue de l’exportation d’un dessin vers un autre logiciel, il faut que format employé soit un format d’export ou un format de sauvegarde. De même, la différence entre un format d’export ou un format de sauvegarde, n’est qu’une question de créer ou pas un nouveau fichier pour l’autre logiciel.

Voici les formats que jPicEdt 1.6-pre1 connaît :

Il est à noter qu’il n’y a pas de relation forte entre le nom du fichier et son format, toutefois il est conseillé d’observer les conventions suivantes :

2.1.2 Formats de sauvegarde et types de contenu

On désigne par type de contenu l’ensemble format de sauvegarde + variante. À la création d’un nouveau dessin le type de contenu par defaut est celui défini dans les préférences utilisateur. Mais vous pouvez changer à volonté le type de contenu par la suite avec le menu Éditer / Format… ailleurs le type de contenu courant d’un dessin est affiché entre crochets juste après le nom du dessin dans le bandeau de la planche correspondante (par exemple "[pstricks]" si le type de contenu est LaTeX + pstricks).

Il est à noter qu’il se peut que le "type de contenu" ne définisse pas à lui seul tous les paramètres de formattage, et qu’une partie de ceux-ci soient accessibles dans les préférences utilisateur.

Dans un format de sauvegarde la partie JPIC-XML aparaît comme des commentaires, par exemple si le format de sauvegarde est LaTeX le code JPIC-XML est commenté avec un symbole pourcent en début de chaque ligne. Ceci permet à un programme connaissant le format d’export de lire un fichier au format de sauvegarde sans être perturbé par la présence du code JPIC-XML. Par exemple si le format de sauvegarde est LaTeX le fichier peut être correctement compilé par LaTeX.

Inversement, la partie JPIC-XML permet à jPicEdt de recharger le dessin sans la moindre perte d’information, ce que ne permet par une importation même avec le format LaTeX sous sa variante PSTricks (et a fortiori en LaTeX sous eepic).

2.1.3 Ouverture d’un fichier

Réciproquement, à l’ouverture d’un fichier, jPicEdt analyse le fichier ouvert de la façon suivante:

1. Tout d’abort jPicEdt essaie de voir si le fichier est dans un format de sauvegarde en cherchant la partie en JPIC-XML enfouie, et si elle y est, alors le dessin est reconstruit seulement en se basant sur le JPIC-XML enfoui (ce qui signifie non seulement que tous changements effectués sur la partie en format d’export seront ignorés, mais encore que si vous modifiez le dessin avec jPicEdt et puis le sauvegardez, ces changements seront perdus , car jPicEdt les écrasera sans pitié lors de formattage de la partie en format d’export).
2. Dans le cas où il n’y a pas de code JPIC-XML enfoui (ce qui est par exemple le cas si vous chargez une image écrite à la main ou par un autre logiciel capable de produire du code LaTeX comme GnuPlot, ou encore si vous avez détruit la partie en JPIC-XML), jPicEdt essaie de voir si le fichier est dans un format convertible en soumettant le fichier à un analyseur syntaxique.

Il est à noter que jPicEdt n’utilise aucunement le nom du fichier, et notamment son extension pour détecter le type de contenu.

jPicEdt supporte actuellement trois formats convertibles, qui sont en fait trois variantes du format LaTeX, nommément l’environnement picture standard, le paquetage eepic, et le paquetage pstricks.

2.1.4 Type de contenu et WYSIWYG-ité

jPicEdt n’est pas vraiment WYSIWYG notamment car il ne comprend pas de compilateur LaTeX. Toutefois il est capable de présenter le dessin en fonction du type de contenu. Vous pouvez visionner le dessin à l’aide d’outils externe appelable directement depuis jPicEdt via le menu Commandes.

L’ensemble des attributs d’un objet graphique reste toutefois configurable, ceci peut être surprenant pour les débutants : si par exemple le type de contenu est "LaTeX" (c’est à dire le format de sauvegarde LaTeX dans sa variante environement picture de base), et que vous changez l’angle d’orientation alors le texte reste horizontal à l’écran, conformément à la façon dont il est exporté en picture de base. Dès lors que vous changer le type de contenu pour prendre par exemple pstricks, il apparaîtra avec l’orientation choisie.