Crea formato TeX personalizzato
Impagina un file TeX in formato personalizzato tramite C# .NET
TeX è un linguaggio di programmazione utilizzato per scrivere programmi per un sistema di preparazione di documenti informatici denominato anch’esso TeX (il motore TeX). Il loro scopo principale è aiutare nella stesura di articoli matematici o tecnici. Il linguaggio TeX include comandi per controllare il processo di impaginazione, attivando alcune azioni o regolando alcuni parametri interni del motore. L’uso della sintassi del linguaggio TeX può essere più produttivo se definisci macro e valori di parametri per tua comodità. Puoi inserire tali definizioni in un file TeX, che includerai all’inizio di ogni altro file TeX che contiene i dati effettivi del documento. Oppure puoi evitare ciò effettuando il dump dello 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 di formato TeX) prima di impaginare qualsiasi file di documento. Il motore TeX caricherà tale file di formato molto più velocemente di un formato in sintassi TeX poiché i file di formato non devono essere elaborati.
Al giorno d'oggi, il formato più comune utilizzato è LaTeX. È molto improbabile che tu abbia bisogno del tuo formato poiché LaTeX copre una gamma molto ampia di scopi. Ma se mai ne avessi bisogno, la soluzione API Aspose.TeX ti consente di creare il tuo formato TeX. Qui troverai informazioni che spiegano come creare file di formato personalizzato e come impaginare documenti utilizzando un formato personalizzato. Per questo abbiamo bisogno di:
L'API Aspose.TeX per .NET che è 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 seguente comando dalla Package Manager Console
Package Manager Console Command
PM> Install-Package Aspose.TeX
Passaggi per creare un file TeX personalizzato in C#.
- Utilizzando il metodo ConsoleAppOptions() della classe TeXOptions , crea un’istanza delle opzioni del motore TeX per l’estensione del motore Object TeX nel suo stato iniziale (senza alcun formato).
- Utilizzando la classe InputFileSystemDirectory , specifica una directory di lavoro del file system per l’input.
- Utilizza la classe OutputFileSystemDirectory per specificare una directory di lavoro del file system per l’output.
- Crea il file di formato chiamando il metodo TeXJob.CreateFormat() . Il nome fornito come argomento deve essere il nome del file TeX contenente il formato. Il file di 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 impaginare un file TeX in un formato personalizzato in C#.
- Crea il provider di formato utilizzando la classe InputFileSystemDirectory .
- Crea opzioni di conversione per il tuo formato personalizzato sull’estensione del motore Object TeX utilizzando il metodo ConsoleAppOptions() della classe TeXOptions .
- Specifica la directory di lavoro di input se l’input principale non è fornito come flusso. Utilizza la classe InputFileSystemDirectory per farlo.
- Specifica una directory di lavoro del file system per l’output utilizzando la classe OutputFileSystemDirectory .
- Crea un oggetto della classe TeXJob con un’istanza di XpsDevice e esegui il lavoro chiamando il metodo Run(). Qui mostriamo anche come passare il file di input TeX principale come flusso.
Esempio di codice C#: impaginazione 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 What is TeX File Format
TeX è un sistema di composizione tipografica e un linguaggio di programmazione che consente di creare documenti di alta qualità, in particolare con formule matematiche. I file .tex sono testo semplice elaborato da motori TeX (pdfTeX, XeTeX, LuaTeX) per produrre PDF o DVI.