# 文書の分析

LaTeX、Typst、Markdown の文書にある見出し、図、表、数式、ラベル、引用、ToDo を一覧し、投稿用のメタデータをコピーします。

投稿する前に、文書に実際に何が入っているかを確認しておくと役に立ちます。すべての図にキャプションはあるか。引用されたキーはすべて参考文献にあるか。 **文書の分析**は、これらをひとつのダイアログにまとめて表示し、各項目をソースの該当行にリンクします。

エディタのツールバー右端の**文書の分析**ボタンで開くか、⌘K パレットから**文書の分析**を実行します。LaTeX、Typst、Markdown のプロジェクトで使え、メインファイルからたどって文書を読み取るため、`\input` で取り込んだ LaTeX の章や、`#include` で取り込んだ Typst のファイルも対象になります。

## 各タブの内容

**概要**には、以下の各リストの件数が表示されます。件数をクリックすると、そのタブが開きます。

- **見出し**。階層に応じてインデントされます。
- **図**と**表**。それぞれにキャプション（なければ**キャプションなし**）、ラベル、番号がなければ**番号なし**が表示されます。
- **数式**：ディスプレイ数式のみで、インライン数式は含みません。
- **ラベル**：すべてのラベルと、それが何に付いているか（見出し、図、表、数式、その他）。
- **引用**：引用されたキーすべてと、その引用回数。参考文献にないキーには**参考文献にありません**と表示され、概要にその件数が表示されます。
- **ToDo**：ソース中の `TODO`、`FIXME`、`XXX` のメモ。LaTeX では、`\todo`、`\missingfigure`、fixme パッケージのメモも数えられます。

行をクリックすると、ダイアログが閉じてその行に移動します。灰色の行は、ソースまでたどれなかったものです。

## 番号とページ

番号の取得元は、エンジンによって異なります。

- **LaTeX**：図、表、数式、見出しの番号とそのページは、ラベルが付いている項目について、前回のコンパイルから取得します。フッターに、それが最新かどうかが表示されます。その後に編集した場合は、もう一度コンパイルして更新してください。
- **Typst**：ダイアログを開くとき、プロジェクトの Typst のバージョンと選択中のビルドバリアントで Typst に文書を読み取らせるため、番号とページは現在のソースと一致します。Typst が文書をコンパイルできない場合は、概要に代わりにエラーが一覧され、それぞれの行へのリンクが付きます。一覧されるのは最初の 5,000 個の要素だけです。フッターに、使用した Typst のバージョンが表示されます。
- **Markdown**：項目はソースの順に並び、番号やページはありません。

**更新**を押すと、ダイアログを閉じずに文書を読み直します。

## 投稿用メタデータ

概要には、Oleafly が見つけた**タイトル** / **著者** / **キーワード** / **日付** / **要旨**も表示されます。見つからないものには**未設定**と表示されます。

- LaTeX では、`\title`、`\author`、`\date`、`abstract` 環境、および `\keywords` コマンドまたは `keywords` か `IEEEkeywords` 環境から取得します。
- Typst では、文書が適用しているテンプレートの引数、または `#set document(...)` から取得します。要旨は、「Abstract」という名前の見出しから取得することもあります。
- Markdown では、フロントマターの `title`、`author` または `authors`、`date`、`keywords`、`abstract` から取得します。

**投稿用メタデータをコピー**を押すと、タイトル、著者、キーワード、要旨がラベル付きの行としてクリップボードにコピーされ、投稿フォームにそのまま貼り付けられます。どれも設定されていない場合、このボタンは無効です。

## 関連ページ

- [プリフライトチェック](/docs/preflight/)：投稿前の、ソース、ログ、PDF に対するより詳しいチェック
- [引用と参考文献](/docs/citations/)：文書の分析が不足していると報告したキーを追加する
- [文書の設定](/docs/document-settings/)：エディタのツールバーにあるもう 1 つの文書ツール
