Benutzerdefiniertes TeX-Format erstellen

Eine TeX-Datei im benutzerdefinierten Format über C# .NET setzen

TeX ist eine Programmiersprache, die zum Schreiben von Programmen für ein Computersystem zur Dokumentenvorbereitung verwendet wird, das ebenfalls TeX (die TeX-Engine) genannt wird. Ihr Hauptzweck ist die Unterstützung beim Schreiben mathematischer oder technischer Arbeiten. Die TeX-Sprache umfasst Befehle zur Steuerung des Satzprozesses, sei es durch das Auslösen bestimmter Aktionen oder durch das Einstellen interner Parameter der Engine. Die Verwendung der TeX-Syntax kann produktiver sein, wenn Sie Makros und Parameterwerte für Ihren Komfort definieren. Sie können diese Definitionen in einer TeX-Datei ablegen, die Sie am Anfang jeder anderen TeX-Datei einfügen, die eigentliche Dokumentdaten enthält. Oder Sie können dies vermeiden, indem Sie den internen Zustand der Engine nach dem Laden der Definitionen dumpen. Ein solcher binärer Dump wird als Formatdatei bezeichnet. Dann müssen Sie nur noch den Formatnamen (den Namen der TeX-Formatdatei) angeben, bevor Sie eine Dokumentdatei setzen. Die TeX-Engine lädt eine solche Formatdatei viel schneller als ein Format in TeX-Syntax, da Formatdateien nicht verarbeitet werden müssen.

Heutzutage ist LaTeX das am häufigsten verwendete Format. Es ist höchst unwahrscheinlich, dass Sie Ihr eigenes Format benötigen, da LaTeX ein sehr breites Spektrum an Zwecken abdeckt. Aber falls Sie es jemals brauchen sollten, ermöglicht Ihnen die Aspose.TeX API-Lösung die Erstellung Ihres eigenen TeX-Formats. Hier finden Sie Informationen zur Erstellung von benutzerdefinierten Formatdateien und zum Setzen von Dokumenten mit einem benutzerdefinierten Format. Dafür benötigen wir:

Die Aspose.TeX für .NET API, eine funktionsreiche, leistungsstarke und einfach zu bedienende API zur Dokumentenbearbeitung und -konvertierung für die C#-Plattform.
Öffnen Sie den NuGet-Paketmanager, suchen Sie nach Aspose.TeX und installieren Sie es. Sie können auch den folgenden Befehl in der Paket-Manager-Konsole verwenden:

Package Manager Console Command

PM> Install-Package Aspose.TeX

Schritte zum Erstellen einer benutzerdefinierten TeX-Datei in C#.

Verwenden Sie die Methode ConsoleAppOptions() der Klasse TeXOptions , um TeX-Engine-Optionen für die Object TeX-Engine-Erweiterung in ihrem Anfangszustand (ganz ohne Format) zu instanziieren.
Geben Sie mit der Klasse InputFileSystemDirectory ein Dateisystem-Arbeitsverzeichnis für die Eingabe an.
Verwenden Sie die Klasse OutputFileSystemDirectory , um ein Dateisystem-Arbeitsverzeichnis für die Ausgabe anzugeben.
Erstellen Sie die Formatdatei durch Aufruf der Methode TeXJob.CreateFormat() . Der Name, den Sie als Argument angeben, muss der Name Ihrer TeX-Datei sein, die das Format enthält. Die binäre Formatdatei erhält denselben Namen.

C#-Codebeispiel: Erstellen einer benutzerdefinierten Formatdatei

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

Schritte zum Setzen einer TeX-Datei in einem benutzerdefinierten Format in C#.

Erstellen Sie den Format-Provider mit der Klasse InputFileSystemDirectory .
Erstellen Sie Konvertierungsoptionen für Ihr benutzerdefiniertes Format auf der Object TeX-Engine-Erweiterung mithilfe der Methode ConsoleAppOptions() der Klasse TeXOptions .
Geben Sie das Eingabe-Arbeitsverzeichnis an, falls die Haupteingabe nicht als Stream bereitgestellt wird. Verwenden Sie dazu die Klasse InputFileSystemDirectory .
Geben Sie ein Dateisystem-Arbeitsverzeichnis für die Ausgabe mit der Klasse OutputFileSystemDirectory an.
Erstellen Sie ein Objekt der Klasse TeXJob mit einer Instanz von XpsDevice und führen Sie den Auftrag durch Aufruf der Methode Run() aus. Hier zeigen wir auch, wie die TeX-Haupteingabedatei als Stream übergeben wird.

C#-Codebeispiel: Setzen einer TeX-Datei in einem benutzerdefinierten Format

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

FAQ

1. Was ist eine LaTeX-Vorlage?

Eine Vorlage ist ein gespeicherter Satz von Eigenschaften, Einstellungen oder Strukturen, der auf ein neu erstelltes Dokument angewendet werden kann, um Zeit zu sparen. Für LaTeX kann dies eine Datei sein, die Informationen über Seitenformat, Schriftarten, Dokumentklasse, enthaltene Pakete usw. enthält.

2. Wie verwende ich LaTeX-Vorlagen?

Wenn Sie keine zusätzliche Software verwenden und die Vorlage nur eine TeX-Datei ist, öffnen Sie sie einfach und beginnen Sie mit der Arbeit. Bedenken Sie jedoch, dass Sie die Änderungen nicht direkt in diesem Dokument speichern, sondern stattdessen die Option „Speichern unter“ verwenden.

3. Wie lege ich den Typ eines LaTeX-Dokuments fest?

Um den Typ eines Dokuments in LaTeX anzugeben, z. B. einen Artikel, ein Buch oder eine Präsentation, verwenden Sie den Befehl „\documentclass{…}“ mit einem der unterstützten Klassennamen in geschweiften Klammern.

4. Wie erstelle ich ein benutzerdefiniertes TeX-Format?

Um ein benutzerdefiniertes TeX-Format mit der Aspose.TeX-API-Lösung zu erstellen, erstellen Sie zunächst die richtigen TeX-Engine-Optionen. Anschließend geben Sie ein Dateisystem-Arbeitsverzeichnis für die Ein- und Ausgabe an. Und schließlich erstellen Sie das Format, indem Sie die Methode TeXJob.CreateFormat() aufrufen.

TeX What is TeX File Format

TeX ist ein Satzsystem und eine Programmiersprache, das Dokumente in Klartext beschreibt. TeX‑Dateien werden von einer TeX‑Engine (z. B. pdfTeX, XeTeX, LuaTeX) verarbeitet und erzeugen Ausgaben wie PDF oder DVI. Es bietet präzise Kontrolle über Layout, Typografie und mathematische Formeln.