ヘルプセンター
LaTeX と Typst のプロジェクトの作成、コンパイル、共同作業のための実用的なガイド。
Typst をオンラインで共同編集する
オンライン Typst エディター。共著者とリアルタイムで書け、入力に合わせて PDF がブラウザーでコンパイルされ、パッケージ、引用、AI の支援も使えます。
Typst プロジェクトを始める
JointTex は LaTeX だけでなく Typst のオンラインエディターでもあります。Typst プロジェクトはブラウザーで書き、コンパイルし、共有でき、何もインストールする必要はありません。
手順
- 「プロジェクト」を開いて「新規プロジェクト」を選び、空白のプロジェクトのカードで Typst を選びます。プロジェクトは main.typ と references.bib で始まり、main.typ はすでに #bibliography でそのファイルを指定しています。
- Typst のテンプレートから始めることもできます。テンプレートが LaTeX か Typst かはルートファイルで決まり、そこから作ったプロジェクトも同じようにコンパイルされます。
- Word や Markdown の下書きを Typst として取り込む：「新規プロジェクト」から「ファイルからインポート」を選び、.docx または .md ファイルを指定して、変換先に Typst を選びます。
- 1 つのプロジェクトに両方の言語を置けます。どちらでコンパイルするかはルートファイルで決まり、ルートが .typ なら Typst でコンパイルされます。ルートファイルはプロジェクト設定で変更できます。
入力しながら PDF を見る
Typst はエディターのページ自体で動くので、入力が止まると少し後に PDF が追従します。押すべきコンパイルボタンはありません。
手順
- Typst プロジェクトでは「自動コンパイル」が最初からオンです。共同編集者の編集でもあなたのプレビューが再コンパイルされます。
- エラーと警告はソースに下線で示され、問題タブに一覧されます。エラーが直るまでは、最後にコンパイルできた PDF が画面に残ります。
- PDF のどこかをダブルクリックするか、Cmd/Ctrl を押しながらクリックすると、それを生成したソースへ移動し、{mod+j} を押すとカーソルから PDF へ移動します。位置は Typst コンパイラー自身から得られます。
- カーソル位置の数式は書いているそばから組版されて表示され、アウトラインには開いているファイルの見出しが並びます。
- ブラウザーでは、ダウンロードと印刷は同じバージョンの Typst でサーバーであらためてコンパイルされるので、共有するファイルはプロジェクト自身の PDF です。
Typst Universe のパッケージを使う
Typst のレジストリで公開されているパッケージは、ほかの環境と同じように使えます。
手順
- #import "@preview/name:version" でパッケージを読み込みます。コンパイルで初めて必要になったときに取得されます。
- サーバーでのコンパイルはネットワークに接続せずに実行されますが、@preview で公開されているパッケージならどれでも使えます。
- @local 名前空間のパッケージは、1 人のコンピューターにしかないため使えません。パッケージのファイルをプロジェクトに入れ、パスで読み込んでください。
.bib ファイルから引用する
Typst は LaTeX と同じ .bib ファイルを読みます。文書では #bibliography でファイルを指定し、@key でエントリーを引用します。
手順
- {mod+alt+c} を押すか、ツールバーの「引用を挿入」(@) を選ぶと、このプロジェクト、個人ライブラリ、Crossref などのオンライン情報、Zotero、対応プランの過去のプロジェクトを検索でき、エントリーを .bib ファイルに書き込んで @key を挿入します。
- @key の上、または .bib・.yml ファイルのキーの上で F2 を押すと名前を変更でき、エントリーとすべての引用が追従します。
- 引用したエントリーを Crossref と arXiv で検証するには、「プロジェクトチェック」を開いて「参考文献」を選びます。
共同で執筆する
共著者は LaTeX プロジェクトと同じように Typst プロジェクトを同時に編集でき、すべての変更に作成者が記録されます。
手順
- 「共有」ダイアログから共著者を招待します。全員が互いのカーソルと編集をリアルタイムで見られます。
- 文章の一部を選択してコメントし、「レビュー」で「自分の編集を追跡」をオンにして変更を提案として届け、「履歴」から以前のどのバージョンにも戻れます。
- 2 つのバージョンを修正箇所入り PDF で比較します。typdiff は、変更されたすべての .typ ファイルで、追加された部分に下線を、削除された部分に取り消し線を引きます。
AI アシスタントに頼む
アシスタントはプロジェクトが Typst で書かれていることを把握し、Typst で書きます。
手順
- AI パネルを開き、表、図、show ルール、またはコンパイルエラーの修正を依頼します。
- 「変更を追跡」がオンのとき（既定ではオンです）、アシスタントが加えた編集にはすべて印が付き、1 つずつ、またはまとめて、残すか破棄するかを選べます。
- 問題タブから、エラー 1 つ、またはすべての説明や修正を依頼できます。アシスタントはソースを編集し、もう一度コンパイルして修正を確かめます。
デスクトップアプリとオフラインで作業する
Typst プロジェクトには、ブラウザーでもデスクトップアプリでも TeX のインストールは不要です。
手順
- デスクトップアプリでは、Typst プロジェクトは入力に合わせてアプリのウィンドウ内でコンパイルされ、保存または印刷する PDF もその同じ PDF で、接続は必要ありません。
- ブラウザーでは、開いたことのあるプロジェクトはオフライン用に保持されるので、接続が切れても書き続けられます。
今のところ LaTeX ファイルでしか使えない機能
LaTeX ソースを読み書きするツールのいくつかは、まだ .typ ファイルでは動作しません。
手順
- 「ドキュメントを整形」と「Copy As」は .tex ファイル用です。
- 「数学記号」セクションが挿入するのは LaTeX コマンドです。また、.typ ファイルを開いている間はスクリーンショットからの数式認識が無効になります。
- .typ ファイルに貼り付けた表や画像は変換されません。表はプレーンテキストとして入り、画像は保存されません。