Crear formato TeX personalizado

Componga 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 informático de preparación de documentos que también se llama TeX (el motor TeX ). Su objetivo principal es ayudar en la redacción de artículos matemáticos 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. Usar 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 todos los demás archivos TeX que contengan datos reales del documento. O puede evitar esto desechando el estado interno del motor después de cargar las definiciones. Este volcado binario se denomina archivo de formato. Entonces sólo necesitará especificar el nombre del formato (el nombre del archivo en 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 no es necesario procesar los archivos de formato.

Hoy en día, el formato más utilizado es LaTeX. Es muy poco probable que necesite su formato ya que LaTeX cubre una amplia gama de propósitos. Pero si alguna vez lo necesita, la solución API Aspose.TeX le permite crear su propio formato TeX. Aquí encontrará información que explica cómo crear archivos con 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 conversión y manipulació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 utilizar 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 C#.

  1. Usando el método ConsoleAppOptions() de TeXOptions , crea una instancia de las opciones del motor TeX para la extensión del motor Object TeX en su estado inicial (sin formato alguno).
  2. Usando la clase InputFileSystemDirectory , especifique un directorio de trabajo del sistema de archivos para la entrada.
  3. Utilice la clase OutputFileSystemDirectory para especificar un directorio de trabajo del sistema de archivos para la salida.
  4. 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 en 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 C#.

  1. Cree el proveedor de formato utilizando la clase InputFileSystemDirectory .
  2. Cree opciones de conversión para su formato personalizado en la extensión del motor Object TeX usando el método ConsoleAppOptions() de TeXOptions clase.
  3. Especifique el directorio de trabajo de entrada si la entrada principal no se proporciona como una secuencia. Utilice la clase InputFileSystemDirectory para hacer esto.
  4. Especifique un directorio de trabajo del sistema de archivos para la salida utilizando la clase OutputFileSystemDirectory .
  5. 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 una secuencia.

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 Qué es TeX Formato de archivo

TeX no es en realidad un formato. Es a la vez un lenguaje de programación y también un motor de interpretación que entiende este lenguaje. Un archivo TeX es un documento creado en LaTeX. Este documento puede incluir gráficos, tablas, símbolos, listas, fórmulas y ecuaciones.