Créer un format TeX personnalisé

Composer un fichier TeX dans un format personnalisé via C# .NET

 

Aspose.TeX for .NET Aspose.TeX for .NET

  Nuget   Pricing Buy
 

TeX est un langage de programmation utilisé pour écrire des programmes pour un système de préparation de documents informatiques également appelé TeX (le moteur TeX ). Leur objectif principal est d’aider à la rédaction d’articles mathématiques ou techniques. Le langage TeX comprend des commandes pour contrôler le processus de composition, que ce soit en déclenchant certaines actions ou en réglant certains paramètres internes du moteur. L’utilisation de la syntaxe du langage TeX peut être plus productive si vous définissez des macros et des valeurs de paramètres pour votre commodité. Vous pouvez placer ces définitions dans un fichier TeX, que vous inclurez au début de tout autre fichier TeX contenant des données réelles du document. Ou vous pouvez éviter cela en vidant l’état interne du moteur après avoir chargé les définitions. Un tel dump binaire est appelé un fichier de format. Ensuite, il vous suffira de spécifier le nom du format (le nom du fichier au format TeX) avant de composer un fichier de document. Le moteur TeX chargera un tel fichier de format beaucoup plus rapidement qu’un format en syntaxe TeX puisque les fichiers de format n’ont pas besoin d’être traités.

De nos jours, le format le plus couramment utilisé est LaTeX. Il est très peu probable que vous ayez besoin de votre format puisque LaTeX couvre un très large éventail d'applications. Mais si jamais vous en avez besoin, la solution API Aspose.TeX vous permet de créer votre propre format TeX. Vous trouverez ici des informations expliquant comment créer des fichiers au format personnalisé et comment composer des documents à l'aide d'un format personnalisé. Pour cela nous avons besoin de :

  • L'API Aspose.TeX pour .NET, qui est une API de manipulation et de conversion de documents riche en fonctionnalités, puissante et facile à utiliser pour la plate-forme C#.

  • Ouvrez le gestionnaire de packages NuGet, recherchez Aspose.TeX et installez-le. Vous pouvez également utiliser la commande suivante à partir de la console Package Manager

Package Manager Console Command

PM> Install-Package Aspose.TeX

Étapes pour créer un fichier TeX personnalisé C#.

  1. Utilisation de la méthode ConsoleAppOptions() de TeXOptions , instancie les options du moteur TeX pour l’extension du moteur Object TeX dans son état initial (sans aucun format).
  2. À l’aide de la classe InputFileSystemDirectory , spécifiez un répertoire de travail du système de fichiers pour l’entrée.
  3. Utilisez la classe OutputFileSystemDirectory pour spécifier un répertoire de travail du système de fichiers pour la sortie.
  4. Créez le fichier de format en appelant la méthode TeXJob.CreateFormat() . Le nom que vous fournissez en argument doit être le nom de votre fichier TeX contenant le format. Le fichier au format binaire portera le même nom.

Exemple de code C# : création d'un fichier au format personnalisé

using Aspose.TeX.IO;
using Aspose.TeX;
// Create the 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.InputWorkingDirectory = new InputFileSystemDirectory(RunExamples.InputDirectory);
// Specify a file system working directory for the output.
options.OutputWorkingDirectory = new OutputFileSystemDirectory(RunExamples.OutputDirectory);

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

Étapes pour composer un fichier TeX dans un format personnalisé C#.

  1. Créez le fournisseur de format à l’aide de la classe InputFileSystemDirectory .
  2. Créez des options de conversion pour votre format personnalisé sur l’extension du moteur Object TeX à l’aide de la méthode ConsoleAppOptions() de TeXOptions classe.
  3. Spécifiez le répertoire de travail d’entrée si l’entrée principale n’est pas fournie sous forme de flux. Utilisez la classe InputFileSystemDirectory pour ce faire.
  4. Spécifiez un répertoire de travail du système de fichiers pour la sortie à l’aide de la classe OutputFileSystemDirectory .
  5. Créez un objet de la classe TeXJob avec une instance de XpsDevice et exécutez le travail en appelant la méthode Run(). Ici, nous montrons également comment transmettre le fichier d’entrée TeX principal sous forme de flux.

Exemple de code C# : composition d'un fichier TeX dans un format personnalisé

using Aspose.TeX.IO;
using Aspose.TeX.Presentation.Xps;
using Aspose.TeX.ResourceProviders;
using System.IO;
using System.Text;
// 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.
using (FormatProvider formatProvider =
    new FormatProvider(new InputFileSystemDirectory(RunExamples.OutputDirectory), "customtex"))
{
    // Create conversion options for a custom format upon ObjectTeX engine extension.
    TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX(formatProvider));
    options.JobName = "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.InputWorkingDirectory = new InputFileSystemDirectory(RunExamples.InputDirectory);
    // Specify a file system working directory for the output.
    options.OutputWorkingDirectory = new OutputFileSystemDirectory(RunExamples.OutputDirectory);

    // Run the job.
    new TeXJob(new MemoryStream(Encoding.ASCII.GetBytes(
            "Congratulations! You have successfully typeset this text with your own TeX format!\\end")),
            new XpsDevice(), options).Run();
}



FAQ

1. Qu’est-ce qu’un modèle LaTeX ?

Le modèle est un ensemble enregistré de propriétés, de paramètres ou de structure qui peut être appliqué à un document nouvellement créé pour gagner du temps. Pour LaTeX, il peut s’agir d’un fichier contenant des informations sur le format de page, les polices, la classe de document, les packages inclus, etc.

2. Comment utiliser les modèles LaTeX ?

Si vous n’utilisez aucun logiciel supplémentaire et que le modèle n’est qu’un fichier .tex, ouvrez-le simplement et commencez à travailler. N’oubliez pas que vous n’enregistrez pas les modifications directement dans ce document, mais utilisez plutôt l’option Enregistrer sous.

3. Comment définir le type de document LaTeX ?

Pour spécifier le type de document dans LaTeX tel qu un article, un livre ou une présentation, utilisez la commande \documentclass{...}.

4. Comment créer un format TeX personnalisé ?

Pour créer un format TeX personnalisé à l’aide de la solution API Aspose.TeX, vous devez créer des options de moteur TeX. Spécifiez ensuite un répertoire de travail du système de fichiers pour l’entrée et la sortie et créez le format à l’aide de la méthode TeXJob.CreateFormat().

TeX Qu'est-ce que le format de fichier TeX

TeX n'est pas réellement un format. C'est à la fois un langage de programmation et aussi un moteur d'interprétation qui comprend ce langage. Un fichier TeX est un document créé en LaTeX. Ce document peut inclure des graphiques, des tableaux, des symboles, des listes, des formules et des équations.