カスタム TeX 形式を作成する

C# .NET 経由でカスタム形式の TeX ファイルを作成する

 

TeX は、TeX (TeX エンジン) とも呼ばれるコンピューター文書作成システム用のプログラムを作成するために使用されるプログラミング言語です。彼らの主な目的は、数学的または技術的な記事の執筆を支援することです。 TeX 言語には、特定のアクションをトリガーしたり、エンジンの特定の内部パラメータを調整したりすることによって、合成プロセスを制御するコマンドが含まれています。利便性のためにマクロとパラメータ値を定義すると、TeX 言語構文の使用の生産性が向上します。これらの定義を TeX ファイルに配置し、実際の文書データを含む他の TeX ファイルの先頭に含めることができます。または、定義をロードした後にエンジンの内部状態をダンプすることでこれを回避できます。このようなバイナリ ダンプは フォーマット ファイルと呼ばれます。あとは文書ファイルを作成する前に形式名(TeX形式のファイル名)を指定するだけです。 TeX エンジンは、フォーマット ファイルを処理する必要がないため、TeX 構文フォーマットよりもはるかに高速にこのようなフォーマット ファイルを読み込みます。

現在、最も一般的に使用されている形式は LaTeX です。 LaTeX は非常に幅広いアプリケーションをカバーしているため、独自の形式が必要になる可能性はほとんどありません。ただし、必要な場合は、Aspose.TeX API ソリューションを使用して独自の TeX 形式を作成できます。ここでは、カスタム形式ファイルの作成方法と、カスタム形式を使用してドキュメントを作成する方法について説明します。このためには次のものが必要です。

  • Aspose.TeX API for .NET は、C# プラットフォーム向けの機能が豊富で強力で使いやすいドキュメント操作および変換 API です。

  • NuGet パッケージ マネージャーを開き、Aspose.TeX を検索してインストールします。パッケージ マネージャー コンソールから次のコマンドを使用することもできます。

Package Manager Console Command

PM> Install-Package Aspose.TeX

カスタム C# TeX ファイルを作成する手順。

  1. TeXOptionsConsoleAppOptions() メソッドを使用する は、初期状態 (フォーマットなし) で Object TeX エンジンを拡張するための TeX エンジン オプションをインスタンス化します。
  2. InputFileSystemDirectory クラスを使用して、 input のファイル システム作業ディレクトリを指定します。
  3. OutputFileSystemDirectory クラスを使用して、出力用のファイル システム作業ディレクトリを指定します。
  4. TeXJob.CreateFormat() メソッドを呼び出して、フォーマット ファイルを作成します。引数として指定する名前は、その形式を含む TeX ファイルの名前でなければなりません。バイナリ形式のファイルは同じ名前になります。

C# コード例: カスタム フォーマット ファイルの作成

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

カスタム C# 形式で TeX ファイルを作成する手順。

  1. InputFileSystemDirectory クラスを使用して形式プロバイダーを作成します。
  2. ConsoleAppOptions() を使用して、Object TeX エンジン拡張機能でカスタム形式の変換オプションを作成します。 TeXOptions クラス。
  3. プライマリ入力がストリームとして提供されない場合は、入力作業ディレクトリを指定します。これを行うには、 InputFileSystemDirectory クラスを使用します。
  4. OutputFileSystemDirectory クラスを使用して、出力用のファイル システム作業ディレクトリを指定します。
  5. XpsDevice にアクセスし、Run() メソッドを呼び出してジョブを実行します。ここでは、メインの TeX 入力ファイルをストリームとして渡す方法も示します。

C# コード例: TeX ファイルをカスタム形式に合成する

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



よくある質問

1. LaTeXテンプレートとは何ですか?

テンプレートは、時間を節約するために新しく作成されたドキュメントに適用できる、保存されたプロパティ、設定、または構造のセットです。 LaTeX の場合、これはページ形式、フォント、ドキュメント クラス、含まれるパッケージなどに関する情報を含むファイルになります。

2. LaTeX テンプレートを使用するにはどうすればよいですか?

追加のソフトウェアを使用しておらず、テンプレートが単なる TeX ファイルである場合は、それを開いて作業を開始するだけです。このドキュメントに変更を直接保存するのではなく、代わりに「名前を付けて保存」オプションを使用することに注意してください。

3. LaTeXドキュメントのタイプを設定するにはどうすればよいですか?

LaTeX で記事、書籍、プレゼンテーションなどのドキュメントの種類を指定するには、サポートされているクラス名のいずれかを中括弧で囲んでコマンド \documentclass{...} を使用します。

4. カスタム TeX 形式を作成するにはどうすればよいですか?

Aspose.TeX API ソリューションを使用してカスタム TeX 形式を作成するには、まず適切な TeX エンジン オプションを作成します。次に、入力および出力用のファイル システムの作業ディレクトリを指定します。最後に、TeXJob.CreateFormat() メソッドを呼び出してフォーマットを作成します。

TeX TeX ファイル形式とは

TeX は実際にはフォーマットではありません。プログラミング言語であると同時に、この言語を理解するインタープリター エンジンでもあります。 TeX ファイルは、LaTeX で作成されたドキュメントです。このドキュメントには、グラフィック、表、記号、リスト、数式、および方程式を含めることができます。