Erstellen Sie ein benutzerdefiniertes TeX-Format

Setzen Sie eine TeX-Datei in einem benutzerdefinierten Format über C# .NET

 

TeX ist eine Programmiersprache, die zum Schreiben von Programmen für ein Computerdokumentvorbereitungssystem verwendet wird, das auch TeX (die TeX-Engine) genannt wird ). Ihr Hauptzweck besteht darin, beim Verfassen mathematischer oder technischer Arbeiten zu helfen. Die TeX-Sprache enthält Befehle zur Steuerung des Satzprozesses, sei es durch das Auslösen einiger Aktionen oder durch die Optimierung einiger interner Parameter der Engine. Die Verwendung der TeX-Sprachsyntax kann produktiver sein, wenn Sie zur Vereinfachung Makros und Parameterwerte definieren. Sie können diese Definitionen in einer TeX-Datei platzieren, die Sie am Anfang jeder anderen TeX-Datei einfügen, die tatsächliche Dokumentdaten enthält. Sie können dies auch vermeiden, indem Sie den internen Zustand der Engine nach dem Laden der Definitionen sichern. Ein solcher binärer Speicherauszug 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 Format benötigen, da LaTeX ein sehr breites Anwendungsspektrum abdeckt. Wenn Sie es jedoch jemals benötigen, können Sie mit der Aspose.TeX-API-Lösung Ihr eigenes TeX-Format erstellen. Hier finden Sie Informationen, die erklären, wie Sie Dateien im benutzerdefinierten Format erstellen und Dokumente in einem benutzerdefinierten Format setzen. Dazu benötigen wir:

  • Die Aspose.TeX für .NET-API, eine funktionsreiche, leistungsstarke und benutzerfreundliche API zur Dokumentbearbeitung 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 über die Paket-Manager-Konsole verwenden

Package Manager Console Command

PM> Install-Package Aspose.TeX

Schritte zum Erstellen einer benutzerdefinierten TeX-Datei C#.

  1. Verwendung der Methode ConsoleAppOptions() von TeXOptions -Klasse, instanziiert TeX-Engine-Optionen für die Object-TeX-Engine-Erweiterung in ihrem Anfangszustand (ohne Format).
  2. Geben Sie mithilfe der Klasse InputFileSystemDirectory ein Dateisystem-Arbeitsverzeichnis für die Eingabe an.
  3. Verwenden Sie die Klasse OutputFileSystemDirectory , um ein Dateisystem-Arbeitsverzeichnis für die Ausgabe anzugeben.
  4. Erstellen Sie die Formatdatei, indem Sie die Methode TeXJob.CreateFormat() aufrufen. Der Name, den Sie als Argument angeben, muss der Name Ihrer TeX-Datei sein, die das Format enthält. Die Binärformatdatei hat 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 C#-Format.

  1. Erstellen Sie den Formatanbieter mithilfe der Klasse InputFileSystemDirectory .
  2. Erstellen Sie Konvertierungsoptionen für Ihr benutzerdefiniertes Format auf der Object TeX-Engine-Erweiterung mit der Methode ConsoleAppOptions() von TeXOptions Klasse.
  3. Geben Sie das Eingabearbeitsverzeichnis an, wenn die Haupteingabe nicht als Stream bereitgestellt wird. Verwenden Sie dazu die Klasse InputFileSystemDirectory .
  4. Geben Sie mithilfe der Klasse OutputFileSystemDirectory ein Dateisystem-Arbeitsverzeichnis für die Ausgabe an.
  5. Erstellen Sie ein Objekt der Klasse TeXJob mit einer Instanz von XpsDevice und führen Sie den Job aus, indem Sie die Methode Run() aufrufen. Hier zeigen wir auch, wie man die Haupt-TeX-Eingabedatei als Stream übergibt.

C#-Codebeispiel: Satz 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 Was ist TeX Dateiformat

TeX ist eigentlich kein Format. Es ist gleichzeitig eine Programmiersprache und auch eine Interpreter-Engine, die diese Sprache versteht. Eine TeX-Datei ist ein in LaTeX erstelltes Dokument. Dieses Dokument kann Grafiken, Tabellen, Symbole, Listen, Formeln und Gleichungen enthalten.