Autres formats de sortie de conversion TeX | Java

Il est très peu probable que vous souhaitiez actuellement convertir un fichier TeX écrit dans un autre format que LaTeX. Mais cela est possible si vous étudiez le langage TeX et/ou ses composants internes pour une raison quelconque. Quoi qu’il en soit, Aspose.TeX for Java vous permet de convertir des fichiers écrits au format Plain TeX. Il vous permet également de créer des formats personnalisés et de composer des documents conçus dans ces formats.

Nous commencerons par créer un format personnalisé.

Création d’un format personnalisé

Rappelons que le fichier de format est un dump binaire de l’état interne du moteur TeX.

// Create TeX engine options for no format upon ObjectTeX engine extension.
TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectIniTeX());
// Specify a file system working directory for the input.
options.setInputWorkingDirectory(new InputFileSystemDirectory(Utils.getInputDirectory()));
// Specify a file system working directory for the output.
options.setOutputWorkingDirectory(new OutputFileSystemDirectory(Utils.getOutputDirectory()));

// Run format creation.
TeXJob.createFormat("customtex", options);

// For further output to look fine.
options.getTerminalOut().getWriter().newLine();

Comme vous pouvez le voir, le code est similaire au code de conversion d’un fichier TeX. Mais il existe quelques différences.

Tout d’abord, nous utilisons ici la configuration du travail TeXConfig.objectIniTeX(). Il s’agit d’une configuration spéciale qui laisse l’état du moteur « vierge », c’est-à-dire que les paramètres internes ont leurs valeurs par défaut et que l’ensemble des séquences de contrôle coïncide avec l’ensemble des primitives. Dans notre exemple, l’ensemble des primitives est étendu dans le sens mentionné ici.

Ensuite, nous configurons les répertoires de travail d’entrée et de sortie comme d’habitude. Le répertoire de travail d’entrée doit contenir le fichier source du format principal et toutes ses dépendances.

Et la deuxième différence clé réside dans la manière dont nous gérons le travail. Cette fois, nous utilisons la méthode statique createFormat() qui, avec les options, prend le nom du fichier source principal, qui doit être le même que le nom du format.

Composition d’un fichier TeX dans votre format personnalisé

Maintenant que nous avons notre propre format TeX, nous souhaitons composer un fichier TeX écrit dans ce format. Voici le code :

// Create the format provider using the file system input working directory.
// We use the project output directory as our custom format file is supposed to be located there.
final FormatProvider formatProvider = new FormatProvider(
    new InputFileSystemDirectory(Utils.getOutputDirectory()), "customtex");
try {
  // Create conversion options for a custom format upon ObjectTeX engine extension.
  TeXOptions options = TeXOptions.consoleAppOptions(TeXConfig.objectTeX(formatProvider));
  options.setJobName("typeset-with-custom-format");
  // Specify the input working directory. This is not required here as we are providing the main input as a stream.
  // But it is required when the main input has dependencies (e.g. images).
  options.setInputWorkingDirectory(new InputFileSystemDirectory(Utils.getInputDirectory()));
  // Specify a file system working directory for the output.
  options.setOutputWorkingDirectory(new OutputFileSystemDirectory(Utils.getOutputDirectory()));
  
  // Run the job.
  new TeXJob(new ByteArrayInputStream(
    "Congratulations! You have successfully typeset this text with your own TeX format!\\end".getBytes("ASCII")),
    new XpsDevice(), options).run();
  
  // For further output to look fine.
  options.getTerminalOut().getWriter().newLine();
} finally {
  formatProvider.close();
}

Évidemment, nous devons préciser le format d’une manière ou d’une autre. Tout d’abord, nous devons créer une instance de la classe FormatProvider. Ensuite, dans le constructeur d’options, nous utilisons la configuration TeXConfig.objectTeX(), qui prend notre fournisseur de format comme argument et charge le format au-dessus de l’état “vierge” du moteur.

Le reste du code devrait vous être familier. Il utilise les fonctionnalités évoquées plus haut dans ce guide.

Composition d’un fichier TeX au format Plain TeX

Si nous supprimons le fournisseur de format du code que nous venons de démontrer, le moteur chargera le format par défaut, qui est Object TeX dans son quatrième sens. Ainsi, si vous disposez d’un fichier TeX écrit au format Plain TeX, vous pouvez ainsi le convertir dans n’importe quel format cible pris en charge.