Crea un formato TeX personalizzato

Componi un file TeX in un formato personalizzato tramite C# .NET

 

TeX è un linguaggio di programmazione utilizzato per scrivere programmi per un sistema di preparazione dei documenti per computer chiamato anche TeX (il motore TeX). Il loro obiettivo principale è aiutare a scrivere articoli matematici o tecnici. Il linguaggio TeX include comandi per controllare il processo di composizione, sia attivando determinate azioni che regolando determinati parametri interni del motore. L’uso della sintassi del linguaggio TeX può essere più produttivo se definisci macro e valori dei parametri per tua comodità. Puoi inserire queste definizioni in un file TeX, che includi all’inizio di qualsiasi altro file TeX contenente dati effettivi del documento. Oppure puoi evitarlo scaricando lo stato interno del motore dopo aver caricato le definizioni. Tale dump binario è chiamato file di formato. Quindi, dovrai solo specificare il nome del formato (il nome del file in formato TeX) prima di comporre un file di documento. Il motore TeX caricherà un file di formato di questo tipo molto più velocemente di un formato con sintassi TeX poiché i file di formato non necessitano di essere elaborati.

Al giorno d'oggi, il formato più comunemente usato è LaTeX. È molto improbabile che tu abbia bisogno del tuo formato poiché LaTeX copre una gamma molto ampia di applicazioni. Ma se mai ne avessi bisogno, la soluzione API Aspose.TeX ti consente di creare il tuo formato TeX. Qui troverai informazioni su come creare file in formato personalizzato e su come comporre documenti utilizzando un formato personalizzato. Per questo abbiamo bisogno di:

  • L'API Aspose.TeX per .NET, un'API di manipolazione e conversione di documenti ricca di funzionalità, potente e facile da usare per la piattaforma C#.

  • Apri il gestore pacchetti NuGet, cerca Aspose.TeX e installalo. Puoi anche utilizzare il comando seguente dalla console di Gestione pacchetti

Package Manager Console Command

PM> Install-Package Aspose.TeX

Passaggi per creare un file TeX C# personalizzato.

  1. Utilizzando il metodo ConsoleAppOptions() di TeXOptions , istanzia le opzioni del motore TeX per estendere il motore TeX dell’oggetto nel suo stato iniziale (senza alcun formato).
  2. Utilizzando la classe InputFileSystemDirectory , specificare una directory di lavoro del file system per l’input .
  3. Utilizzare la classe OutputFileSystemDirectory per specificare una directory di lavoro del file system per l’output.
  4. Crea il file di formato chiamando il metodo TeXJob.CreateFormat() . Il nome che fornisci come argomento deve essere il nome del tuo file TeX contenente il formato. Il file in formato binario avrà lo stesso nome.

Esempio di codice C#: creazione di un file di formato personalizzato

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);

Passaggi per comporre un file TeX in un formato C# personalizzato.

  1. Creare il provider del formato utilizzando la classe InputFileSystemDirectory .
  2. Crea opzioni di conversione per il tuo formato personalizzato sull’estensione del motore Object TeX utilizzando il metodo ConsoleAppOptions() di TeXOptions Classe .
  3. Specificare la directory di lavoro dell’input se l’input primario non viene fornito come flusso. Utilizzare la classe InputFileSystemDirectory per eseguire questa operazione.
  4. Specificare una directory di lavoro del file system per l’output utilizzando la classe OutputFileSystemDirectory .
  5. Crea un oggetto della classe TeXJob con un’istanza di XpsDevice ed eseguire il lavoro chiamando il metodo Run(). Qui mostriamo anche come passare il file di input TeX principale come flusso.

Esempio di codice C#: composizione di un file TeX in un formato personalizzato

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();
}



Domande frequenti

1. Cos’è un modello LaTeX?

Il modello è un insieme salvato di proprietà, impostazioni o struttura che può essere applicato a un documento appena creato per risparmiare tempo. Per LaTeX, può essere un file contenente informazioni sul formato della pagina, sui caratteri, sulla classe del documento, sui pacchetti inclusi, ecc.

2. Come utilizzare i modelli LaTeX?

Se non stai utilizzando alcun software aggiuntivo e il modello è solo un file .tex, aprilo semplicemente e inizia a lavorare. Ricorda che non stai salvando le modifiche direttamente in questo documento, ma piuttosto utilizzando l’opzione Salva con nome.

3. Come impostare il tipo di documento LaTeX?

Per specificare il tipo di documento in LaTeX come un articolo, un libro o una presentazione, usa il comando \documentclass{...}.

4. Come creare un formato TeX personalizzato?

Per creare un formato TeX personalizzato utilizzando la soluzione API Aspose.TeX, è necessario creare le opzioni del motore TeX. Quindi specifica una directory di lavoro del file system per input e output e crea il formato utilizzando il metodo TeXJob.CreateFormat().

TeX Cos'è il formato file TeX

TeX non è in realtà un formato. È allo stesso tempo un linguaggio di programmazione e anche un motore di interprete che comprende questo linguaggio. Un file TeX è un documento creato in LaTeX. Questo documento può includere grafici, tabelle, simboli, elenchi, formule ed equazioni.