Autres options de gestion de TeX | .NET

Comment définir le mode d’interaction

Comme nous l’avons mentionné ici, Aspose.TeX for .NET nous permet de définir le mode d’interaction initial dans lequel le moteur démarre. Voici comment nous procédons :

// How to set the interaction mode

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Set the interaction mode.
options.Interaction = Interaction.NonstopMode;

Comment définir le nom du travail

Lorsque nous transmettons le fichier d’entrée principal comme nom de fichier, nous obtenons des fichiers de sortie portant le même nom, mais avec d’autres extensions. Le moteur TeX appelle le nom du fichier d’entrée nom du travail et l’utilise pour les fichiers de sortie, sauf dans les cas où des fichiers auxiliaires avec d’autres noms explicitement spécifiés sont écrits. Lorsque nous transmettons le fichier d’entrée principal en tant que stream, le moteur TeX utilise le nom de travail par défaut, qui est texput. Dans les deux cas, nous pouvons remplacer le nom du travail en attribuant l’option de conversion appropriée.

// How to set the job name

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Set the job name.
options.JobName = "my-job-name";

Comment “arrêter le temps”

LaTeX dispose d’une fonctionnalité permettant de générer automatiquement un titre à partir de certaines définitions du préambule. Ce titre contient normalement la date actuelle. Nous souhaiterons peut-être geler la date dans une valeur souhaitée. Voici comment procéder :

// How to "stop time"

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Force the TeX engine to output the specified date in the title.
options.DateTime = new System.DateTime(2022, 12, 18);

Comment ignorer les paquets manquants

Nous souhaiterons peut-être convertir un fichier LaTeX faisant référence à certains packages qui ne sont pas pris en charge par la bibliothèque Aspose.TeX pour .NET. Dans ce cas, le moteur TeX s’arrêtera avec une erreur lors de la tentative de chargement d’un tel package. Pour éviter cela, nous pouvons utiliser l’option suivante :

// How to ignore missing packages

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Set to true to make the engine skip missing packages (when your file references one) without errors.
options.IgnoreMissingPackages = true;

Comment éviter de construire des ligatures

Normalement, le moteur TeX crée des ligatures pour certaines paires de caractères si la police fournit les données requises pour ce faire. Nous pouvons demander au moteur d’ignorer la construction de ligatures avec le code suivant :

// How to avoid building ligatures

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Set to true to make the engine not construct ligatures where normally it would.
options.NoLigatures = true;

Comment répéter le travail

Comme nous l’avons mentionné ci-dessus concernant les étiquettes et les références, il existe des cas où nous souhaiterions exécuter deux fois le même travail. Voici comment procéder :

// How to repeat the job

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Ask the engine to repeat the job.
options.Repeat = true;

Comment transformer des formules mathématiques en images raster

Parfois, nous pouvons avoir besoin d’avoir des formules mathématiques sous forme d’images raster plutôt que de les saisir dans des polices. L’option suivante peut servir à cet effet :

// How to turn math formulas to raster images

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Create and assign saving options instance if needed.
options.SaveOptions = new PdfSaveOptions();
// ...
// Set to true if you want math formulas to be converted to raster images.
options.SaveOptions.RasterizeFormulas = true;

Comment transformer des graphiques en images raster

Le moteur ObjectTeX nous permet d’inclure des fichiers graphiques aux formats raster (PNG et JPG) ainsi qu’aux formats PS(EPS) et XPS(OXPS). Les deux derniers formats contiennent généralement des éléments vectoriels et des textes. Pour les pixelliser et les inclure sous forme d’images solides, nous pouvons utiliser l’option suivante :

// How to turn graphics to raster images

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Create and assign saving options instance if needed.
options.SaveOptions = new PdfSaveOptions();
// ...
// Set to true if you want included graphics (if it contains vector elements) to be converted to raster images.
options.SaveOptions.RasterizeIncludedGraphics = true;

Comment sous-ensembler des polices

Si nous souhaitons réduire la taille du fichier de sortie, nous pouvons recourir au sous-réglage des polices, ce qui signifie que les polices du document de sortie ne contiendront que des données sur les glyphes utilisés dans le document. Voici comment nous pouvons résoudre ce problème :

// How to subset fonts

// Create conversion options instance.
TeXOptions options = TeXOptions.ConsoleAppOptions(TeXConfig.ObjectTeX());
// ...
// Create and assign saving options instance if needed.
options.SaveOptions = new PdfSaveOptions();
// ...
// Set to true to make the device subset fonts used in the document.
options.SaveOptions.SubsetFonts = true;