Crie um formato TeX personalizado

Componha um arquivo TeX em um formato personalizado via C# .NET

 

TeX é uma linguagem de programação usada para escrever programas para um sistema de preparação de documentos de computador também chamado TeX (o mecanismo TeX). Seu principal objetivo é ajudar a escrever artigos matemáticos ou técnicos. A linguagem TeX inclui comandos para controlar o processo de composição, seja acionando determinadas ações ou ajustando determinados parâmetros internos do motor. Usar a sintaxe da linguagem TeX pode ser mais produtivo se você definir macros e valores de parâmetros para sua conveniência. Você pode colocar essas definições em um arquivo TeX, que pode ser incluído no início de qualquer outro arquivo TeX que contenha dados reais do documento. Ou você pode evitar isso descartando o estado interno do mecanismo após carregar as definições. Esse dump binário é chamado de arquivo de formato. Depois, basta especificar o nome do formato (o nome do arquivo no formato TeX) antes de compor um arquivo de documento. O mecanismo TeX carregará esse arquivo de formato muito mais rápido do que um formato de sintaxe TeX, pois os arquivos de formato não precisam ser processados.

Atualmente, o formato mais utilizado é o LaTeX. É muito improvável que você precise do seu formato, pois o LaTeX cobre uma ampla gama de aplicações. Mas se você precisar, a solução API Aspose.TeX permite que você crie seu próprio formato TeX. Aqui você encontrará informações sobre como criar arquivos de formato personalizado e como redigir documentos usando um formato personalizado. Para isso precisamos:

  • A API Aspose.TeX para .NET, que é uma API de conversão e manipulação de documentos rica em recursos, poderosa e fácil de usar para a plataforma C#.

  • Abra o gerenciador de pacotes NuGet, procure Aspose.TeX e instale-o. Você também pode usar o seguinte comando no console do Gerenciador de Pacotes

Package Manager Console Command

PM> Install-Package Aspose.TeX

Etapas para criar um arquivo C# TeX personalizado.

  1. Usando o método ConsoleAppOptions() de TeXOptions , instancia as opções do mecanismo TeX para estender o mecanismo Object TeX em seu estado inicial (sem qualquer formato).
  2. Usando a classe InputFileSystemDirectory , especifique um diretório de trabalho do sistema de arquivos para o input .
  3. Use a classe OutputFileSystemDirectory para especificar um diretório de trabalho do sistema de arquivos para a saída.
  4. Crie o arquivo de formato chamando o método TeXJob.CreateFormat() . O nome que você fornece como argumento deve ser o nome do seu arquivo TeX que contém o formato. O arquivo de formato binário terá o mesmo nome.

Exemplo de código C#: criando um arquivo 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);

Etapas para compor um arquivo TeX em um formato C# personalizado.

  1. Crie o provedor de formato usando a classe InputFileSystemDirectory .
  2. Crie opções de conversão para seu formato personalizado na extensão do mecanismo Object TeX usando o método ConsoleAppOptions() texoptions/consoleappoptions) de TeXOptions classe.
  3. Especifique o diretório de trabalho de entrada se a entrada primária não for fornecida como um fluxo. Use a classe InputFileSystemDirectory para fazer isso.
  4. Especifique um diretório de trabalho do sistema de arquivos para saída usando a classe OutputFileSystemDirectory .
  5. Crie um objeto da classe TeXJob com uma instância de XpsDevice e execute o trabalho chamando o método Run(). Aqui também mostramos como passar o arquivo de entrada principal do TeX como um stream.

Exemplo de código C#: compondo um arquivo TeX em um 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();
}



Perguntas frequentes

1. O que é um modelo LaTeX?

Um modelo é um conjunto salvo de propriedades, configurações ou estrutura que pode ser aplicado a um documento recém-criado para economizar tempo. Para LaTeX, pode ser um arquivo que contém informações sobre formato de página, fontes, classe de documento, pacotes incluídos, etc.

2. Como faço para usar modelos LaTeX?

Se você não estiver usando nenhum software adicional e o modelo for apenas um arquivo TeX, basta abri-lo e começar a trabalhar. Lembre-se de que você não salva as alterações neste documento, mas use a opção ‘Salvar como’.

3. Como definir o tipo de um documento LaTeX?

Para especificar o tipo de um documento em LaTeX, como um artigo, livro ou apresentação, use o comando \documentclass{...} com um dos nomes de classe suportados entre colchetes.

4. Como criar um formato TeX personalizado?

Para criar um formato TeX personalizado usando a solução API Aspose.TeX, você primeiro cria as opções adequadas do mecanismo TeX. Em seguida, você especifica um diretório de trabalho do sistema de arquivos para entrada e saída. E finalmente, você cria o formato chamando o método TeXJob.CreateFormat().

TeX O que é TeX Formato de Arquivo

TeX não é realmente um formato. É ao mesmo tempo uma linguagem de programação e também um mecanismo de interpretação que entende essa linguagem. Um arquivo TeX é um documento criado em LaTeX. Este documento pode incluir gráficos, tabelas, símbolos, listas, fórmulas e equações.