Créer un format TeX personnalisé

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

TeX est un langage de programmation utilisé pour écrire des programmes pour un système de préparation de documents informatique qui est également appelé TeX (le moteur TeX). Son but principal est d’aider à la rédaction d’articles mathématiques ou techniques. Le langage TeX inclut 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 chaque autre fichier TeX contenant les données réelles du document. Ou vous pouvez éviter cela en vidant l’état interne du moteur après le chargement des définitions. Un tel dump binaire est appelé un fichier de format. Ensuite, vous n’aurez qu’à spécifier le nom du format (le nom du fichier de 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 car 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 propre format car LaTeX couvre un éventail très large d'objectifs. 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 plateforme C#.
Ouvrez le gestionnaire de paquets NuGet, recherchez Aspose.TeX et installez-le. Vous pouvez également utiliser la commande suivante à partir de la Console du gestionnaire de paquets

Package Manager Console Command

PM> Install-Package Aspose.TeX

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

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

Exemple de code C# : Création d'un fichier de 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é en C#.

Créez le fournisseur de format à l’aide de la classe InputFileSystemDirectory .
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 la classe TeXOptions .
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.
Spécifiez un répertoire de travail du système de fichiers pour la sortie à l’aide de la classe OutputFileSystemDirectory .
Créez un objet de la classe TeXJob avec une instance de XpsDevice et lancez la tâche en appelant la méthode Run(). Nous montrons également ici 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 What is TeX File Format

TeX est un système de composition typographique et un langage de programmation permettant de créer des documents de haute qualité, notamment avec des formules mathématiques. Les fichiers .tex sont du texte brut traité par des moteurs TeX (pdfTeX, XeTeX, LuaTeX) pour produire du PDF ou du DVI.