ヘルプセンター
LaTeX と Typst のプロジェクトの作成、コンパイル、共同作業のための実用的なガイド。
デスクトップアプリを使う
macOS、Windows、Linux に JointTex をインストールしてサインインし、自分のコンピューターの TeX でコンパイルします。
インストールしてサインインする
デスクトップアプリは、Web と同じプロジェクト、共著者、履歴を、専用のウィンドウで表示します。
手順
- プロジェクトページでアカウントメニューを開いて「デスクトップアプリをダウンロード」を選ぶか、サイトのフッターから「ダウンロード」ページを開きます。
- 自分のコンピューターに合ったものを選びます。macOS では Apple シリコン版か Intel 版、Windows ではインストーラー、Linux では AppImage、.deb、.rpm のいずれかです。
- アプリを開いて「ブラウザでログイン」を選ぶと、ブラウザーが開いてログインコードが表示され、アプリにも同じコードが表示されます。
- ブラウザーのコードがアプリに表示されているものと同じであることを確かめてから、「続行」を選びます。アプリがサインインした状態で開きます。
- ブラウザーを経由したくない場合は、代わりに「このウィンドウでログインする」を選びます。
このコンピューターでコンパイルする
デスクトップアプリでは、JointTex サーバーではなく、すでに入っている TeX、またはコンテナー内の TeX Live でプロジェクトをビルドできます。
手順
- プロジェクトで「設定」を開き、「コンパイル」に進んで「コンパイル先」を探します。
- ここにインストールされている TeX Live、MacTeX、MiKTeX を使うなら「このコンピューター」を、あなたのファイルから分離されたコンテナーでビルドするなら「このコンピューター(Docker)」か「このコンピューター(Podman)」を、あるいは「JointTex サーバー」を選びます。
- 設定の下の行を読みます。見つかったローカルの TeX の名前か、足りないものが示されます。
- 初回は、アプリが「Compile on this computer?」と尋ねます。一緒に書いている人たちを信頼できるなら「Allow」を選んでください。回答は、後からメニュー項目「Compiling on This Computer…」で変更できます。
- いつもどおりコンパイルします。PDF、「問題」タブ、PDF とソースの間のジャンプは同じように動作します。
ウィンドウと更新
アプリでは複数のプロジェクトを並べて開いておけます。新しいバージョンが出たときは知らせてくれます。
手順
- File → New Window を選ぶと、プロジェクト一覧を表示した別のウィンドウが開きます。
- プロジェクトページでプロジェクトのメニューから「新しいウィンドウで開く」を選ぶと、そのプロジェクトを専用のウィンドウで開けます。
- macOS ではアプリメニュー、Windows と Linux では File メニューから「Check for Updates…」を選びます。
- 更新がある場合は「Download」を選び、ダウンロードしたインストーラーを開いて現在のバージョンを置き換えます。
CtrlN で新しいウィンドウを開きます。CtrlW でアクティブなタブを閉じます。これはブラウザーではできない操作です。
ローカルのコンパイルが失敗するとき
このコンピューターでのコンパイルは、ここに何がインストールされているかに左右されるため、ほとんどの失敗は文書の外で解決します。
手順
- TeX のインストールが見つからない:TeX Live または MiKTeX をインストールするか、「コンパイル先」を「JointTex サーバー」にします。
- latexmk が見つからない:BasicTeX などの最小構成には含まれていません。ターミナルで tlmgr install latexmk(macOS では sudo tlmgr install latexmk)を実行するか、MiKTeX Console で latexmk パッケージをインストールします。
- Docker または Podman がインストールされているが起動していない:起動するか、別のコンパイル先を選びます。
- このコンピューターの TeX でコンパイルすることが許可されていない:数秒後にもう一度コンパイルして確認を表示させるか、メニューの「Compiling on This Computer…」で変更します。
- このプロジェクトのファイル名の中に、このコンピューターに書き込めないものがある:ファイルの名前を変更するか、JointTex サーバーでコンパイルします。
- ソースと PDF の位置を対応付けられない:TeX ディストリビューションの synctex プログラムをインストールするか、JointTex サーバーでコンパイルします。
