Crear formato TeX personalizado
Componer un archivo TeX en formato personalizado a través de C# .NET
TeX es un lenguaje de programación utilizado para escribir programas para un sistema de preparación de documentos informáticos que también se llama TeX (el motor TeX). Su propósito principal es ayudar en la escritura de artículos científicos o técnicos. El lenguaje TeX incluye comandos para controlar el proceso de composición tipográfica, ya sea activando algunas acciones o ajustando algunos parámetros internos del motor. El uso de la sintaxis del lenguaje TeX puede ser más productivo si define macros y valores de parámetros para su conveniencia. Puede colocar esas definiciones en un archivo TeX, que incluirá al principio de cada otro archivo TeX que contenga datos reales del documento. O puede evitar esto volcando el estado interno del motor después de cargar las definiciones. Dicho volcado binario se llama archivo de formato. Entonces solo necesitará especificar el nombre del formato (el nombre del archivo de formato TeX) antes de componer cualquier archivo de documento. El motor TeX cargará dicho archivo de formato mucho más rápido que un formato en sintaxis TeX, ya que los archivos de formato no necesitan ser procesados.
Hoy en día, el formato más común utilizado es LaTeX. Es muy poco probable que necesite su formato ya que LaTeX cubre una gama muy amplia de propósitos. Pero si alguna vez lo necesita, la solución API de Aspose.TeX le permite crear su propio formato TeX. Aquí encontrará información que explica cómo crear archivos de formato personalizado y cómo componer documentos utilizando un formato personalizado. Para esto necesitamos:
La API Aspose.TeX para .NET, que es una API de manipulación y conversión de documentos rica en funciones, potente y fácil de usar para la plataforma C#.
Abra el administrador de paquetes NuGet, busque Aspose.TeX e instálelo. También puede usar el siguiente comando desde la Consola del Administrador de Paquetes
Package Manager Console Command
PM> Install-Package Aspose.TeX
Pasos para crear un archivo TeX personalizado en C#.
- Usando el método ConsoleAppOptions() de la clase TeXOptions , instancie las opciones del motor TeX para la extensión del motor Object TeX en su estado inicial (sin ningún formato).
- Usando la clase InputFileSystemDirectory , especifique un directorio de trabajo del sistema de archivos para la entrada.
- Utilice la clase OutputFileSystemDirectory para especificar un directorio de trabajo del sistema de archivos para la salida.
- Cree el archivo de formato llamando al método TeXJob.CreateFormat() . El nombre que proporcione como argumento debe ser el nombre de su archivo TeX que contiene el formato. El archivo de formato binario tendrá el mismo nombre.
Ejemplo de código C#: creación de un archivo de formato personalizado
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);Pasos para componer un archivo TeX en un formato personalizado en C#.
- Cree el proveedor de formato utilizando la clase InputFileSystemDirectory .
- Cree opciones de conversión para su formato personalizado sobre la extensión del motor Object TeX utilizando el método ConsoleAppOptions() de la clase TeXOptions .
- Especifique el directorio de trabajo de entrada si la entrada principal no se proporciona como un flujo. Utilice la clase InputFileSystemDirectory para hacer esto.
- Especifique un directorio de trabajo del sistema de archivos para la salida utilizando la clase OutputFileSystemDirectory .
- Cree un objeto de la clase TeXJob con una instancia de XpsDevice y ejecute el trabajo llamando al método Run(). Aquí también mostramos cómo pasar el archivo de entrada TeX principal como un flujo.
Ejemplo de código C#: composición tipográfica de un archivo TeX en un formato personalizado
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();
}Preguntas más frecuentes
1. ¿Qué es una plantilla LaTeX?
Una plantilla es un conjunto guardado de propiedades, configuraciones o estructura que se puede aplicar a un documento recién creado para ahorrar tiempo. Para LaTeX, puede ser un archivo que contenga información sobre el formato de página, fuentes, clase de documento, paquetes incluidos, etc.
2. ¿Cómo uso las plantillas LaTeX?
Si no está utilizando ningún software adicional y la plantilla es solo un archivo TeX, simplemente ábralo y comience a trabajar. Solo tenga en cuenta que no guarda los cambios directamente en este documento, sino que utiliza la opción “Guardar como”.
3. ¿Cómo configurar el tipo de un documento LaTeX?
Para especificar el tipo de un documento en LaTeX, como un artículo, libro o presentación, use el comando \documentclass{...} con uno de los nombres de clase admitidos entre llaves.
4. ¿Cómo crear un formato TeX personalizado?
Para crear un formato TeX personalizado utilizando la solución API Aspose.TeX, primero cree las opciones adecuadas del motor TeX. Luego, especifica un directorio de trabajo del sistema de archivos para la entrada y salida. Y finalmente, crea el formato llamando al método TeXJob.CreateFormat().
TeX What is TeX File Format
TeX es un sistema de composición tipográfica y un lenguaje de programación que permite crear documentos de alta calidad, especialmente con fórmulas matemáticas. Los archivos .tex son texto plano que procesan motores como pdfTeX, XeTeX o LuaTeX para generar salidas como PDF o DVI.