LaTeX から Typst へ

LaTeX から Typst へは、Typst の高速なローカルのワークフローを使いたいのに、内容がすでに LaTeX にあるときの出発点になります。一般的な文書構造と数式を引き継ぎ、著者にしか決められない判断は、結果の上に残します。

こんなときに向いている

• 標準的なセクション、本文、リスト、リンク、表、数式でできた論文やノート
• 既存の下書きが Typst に合うかを試すとき
• 内容を打ち直さずに移すとき

作業が出版社のクラス、大きなマクロ層、Typst に相当するもののないパッケージに依存しているなら、LaTeX にとどまってください。変換しても、ジャーナルが別のソース形式を受け付けてくれるようにはなりません。

ソースを変換する

1. LaTeX から Typst へを開くか、/latex-to-typst を実行します。
2. LaTeX のソースを貼り付けます。
3. 変換を選びます。
4. 生成された Typst を読み、変換に関する注記があれば確認します。
5. コピーするか、converted.typ を保存するか、Typst プロジェクトを作成してコンパイルします。

標準的な \section、段落、箇条書き、ディスプレイ数式は、Typst の対応するものに変換されます。\newcommand{\model}{...} のような独自のコマンドは、手作業で Typst の関数や変数にする必要があるかもしれません。

移行の結果を確認する

同梱の Pandoc による変換はローカルで実行され、生成された Typst に互換性のための後処理を加えます。LaTeX のパッケージの挙動や、文書クラスの見た目のルールは再現しません。

次の点を確認してください。

• 独自のマクロと環境
• 数式の構文と番号付け
• 図のパスとキャプション
• 表と相互参照
• 参考文献と引用のスタイル
• ページの寸法と組版

Typst 版がコンパイルでき、完成した PDF 全体を比べ終えるまで、元のプロジェクトを残しておいてください。逆方向の変換には、Typst から LaTeX へを使います。

プロジェクト全体を変換する

このツールが変換するのは、貼り付けたテキストです。複数のファイル、図、参考文献を持つ LaTeX プロジェクトでは、プロジェクトを開き、コマンドパレットから Typst のプロジェクトに変換を実行します。別の Typst プロジェクトを作成してコンパイルし、確認が必要な点を報告します。手順は Typst プロジェクトで説明しています。1 つの数式だけなら、数式から Typst へのほうが手早く済みます。