ヘルプセンター
LaTeX と Typst のプロジェクトの作成、コンパイル、共同作業のための実用的なガイド。
バージョン履歴とレビュー
過去のバージョンを見つけて復元し、変更履歴とコメントを処理します。
過去の版を探す
執筆中の版は自動で記録されます。日時、編集者、変更元から必要な版を探せます。
手順
- アクティビティバーで履歴を開き、最近の変更・実行者・Web エディター/デスクトップアプリ/Git/AI アシスタントのどれによるものかを確認します。
- 後で探す可能性のあるバージョンにはマイルストーンの印を付けます。投稿時、共著者への引き継ぎ、まとまった草稿など。
- バージョンからファイルの差分を開き、タイムスタンプから推測せずに何が変わったかを正確に見ます。
- 複数人とアシスタントが動いているときは、作成者と発生元で長い一覧を絞り込みます。
- 「ファイルで絞り込む」と「作成者で絞り込む」で一覧を絞り込み、「履歴の表示」を「まとめる」と「詳細」で切り替えます。
- マイルストーンを右クリックして「マイルストーンの名前を変更…」または「マイルストーンを削除…」を選びます。削除されるのはラベルだけで、それが指していたバージョンは履歴に残ります。
必要なものを復元する
プロジェクト全体または特定のファイルを復元できます。復元した操作も履歴に残ります。
手順
- 方向性ごと間違えたときは、バージョンに対して復元を実行しプロジェクト全体を戻します。
- ほかの部分が先へ進んでいる場合は、1 ファイルだけを復元します。
- 復元には編集権限が必要で、復元自体も履歴に残るため、さらに取り消せます。
- 復元の前に差分を読みましょう。記憶にあるバージョンが目的のものとは限りません。
- バージョンまたはマイルストーンを右クリックして「ZIP としてダウンロード」を選ぶと、何も変更せずに、その時点のプロジェクトをそのまま取得できます。閲覧者も利用できます。
2 つのバージョンを修正箇所入り PDF で比較する
修正箇所入り PDF は、2 つのバージョンの間で何が変わったかを組版後の文書で示します。追加箇所には下線、削除箇所には取り消し線が付き、改訂稿に添えて送れる PDF になります。
手順
- 履歴で「修正箇所入り PDF を生成…」を選ぶか、バージョンまたはマイルストーンを右クリックして「現在のバージョンと比較して修正箇所入り PDF に」を選びます。コマンドパレットでは「バージョンを比較(修正箇所入り PDF)…」、プロジェクトメニューでは「修正箇所入り PDF をダウンロード…」が同じ機能です。
- 「旧バージョン」と「新バージョン」を選び(「バージョンを入れ替え」で入れ替えられます)、ダイアログに「ルートファイル」が表示されている場合はそれを確認して、「生成」を選びます。プロジェクトのコンパイル設定が使われます。
- 「詳細設定」で、「表示スタイル」を「下線と取り消し線」「色のみ」「色と余白の変更バー」から、「数式」を「数式全体を示す」「数式内部を示す」「数式を示さない」から設定します。
- 通知に「修正箇所入り PDF の準備ができました」と表示されたら、「開く」でタブに表示するか、「ダウンロード」で保存します。タブには「追加」と「削除」の「凡例」が表示され、「.tex をダウンロード」「再生成」「バージョンを変更…」を使えます。
- 修正箇所が示されるのは .tex ファイルの変更だけです。図など、ほかのファイルの変更は示されず、.tex ファイルに違いがなければ示すものはありません。
- 修正箇所入り PDF がコンパイルできないときは、「ログを表示」で原因を確認するか、「互換モードで再試行」を選びます。制限時間を超える場合は、互換モードを試すか、比較する変更を減らしてください。
- Typst プロジェクトでは typdiff が修正箇所を示します。プロジェクト内の変更された .typ ファイルがすべて対象になり、新しいファイルは全体が追加として示されます。「詳細設定」はなく、表示スタイルの選択も互換モードもありません。タブでは「.tex をダウンロード」の代わりに「.typ をダウンロード」を使えます。
- typdiff は数式、raw テキスト、その他のコードを、内部に印を付けるのではなく全体として置き換えます。画像のパスやページの余白など、コードだけの変更は示されません。削除された表の行のように、関数呼び出しの内部から取り除かれた内容は跡が残りません。
変更履歴とコメント
レビュー画面で変更提案やコメントを確認し、共著者からのフィードバックに対応できます。
手順
- レビューで「自分の編集を追跡」を有効にすると、変更が静かな編集ではなく提案として届きます。
- 提案は 1 件ずつ承認・却下するか、開いているファイルに対して「ファイルを承認」と「このファイルのすべての変更を拒否」を使います。
- 保留中の変更があるあいだ、エディターの下の細いバーに、いくつのファイルに何件の変更が残っているかが表示されます。矢印でどのファイルの前後の変更にも移動でき、ボタンでこのファイル、またはすべてのファイルをまとめて承認・拒否できます。
- テキストを選択してコメントを選ぶと、その箇所に固定されたスレッドが始まります。編集の追跡と提案の判断には編集権限が必要です。コメントは「コメント可」または「編集可」でできます。閲覧者は読むことしかできません。
- 返信は、誰かがスレッドを解決するまでそのテキストに紐づいたままです。
- スレッドでは、「返信を下書き」で AI に返信を書かせて編集してから送信でき、「対応」で AI にコメントへ対応する形で原稿を編集させられます。
- 解決したスレッドは「解決済みのコメント」に移り、「再開」で元に戻せます。「PDF で表示」はプレビュー内の該当箇所へ移動します。
テキストを選択して CtrlAltM を押すとコメントを追加します。提案のある行では、CtrlAltEnter でカーソルに最も近い提案を承認し、CtrlAltBackspace で却下します。
