# Analyse du document

Listez les titres, figures, tableaux, équations, étiquettes, citations et TODO d'un document LaTeX, Typst ou Markdown, et copiez ses métadonnées de soumission.

Avant de soumettre, il est utile de voir ce que le document contient réellement. Chaque figure a-t-elle une légende, et chaque clé citée figure-t-elle dans la bibliographie ? L'**Analyse du document** liste tout dans une seule boîte de dialogue, chaque entrée étant reliée à sa ligne dans le source.

Ouvrez-la avec le bouton **Analyse du document** à l'extrémité droite de la barre d'outils de l'éditeur, ou lancez **Analyse du document** depuis la palette ⌘K. Elle fonctionne dans les projets LaTeX, Typst et Markdown et lit le document à partir du fichier principal, donc un chapitre LaTeX amené par `\input` ou un fichier Typst amené par `#include` est compté aussi.

## Ce que liste chaque onglet

La **Vue d'ensemble** affiche un compteur pour chaque liste ci-dessous. Cliquez sur un compteur pour ouvrir l'onglet correspondant.

- **Titres**, avec retrait selon le niveau.
- **Figures** et **Tableaux**, chacun avec sa légende (ou **Sans légende**), son étiquette, et **Non numéroté** quand il n'a pas de numéro.
- **Équations** : uniquement les équations hors ligne, pas les maths en ligne.
- **Étiquettes** : chaque étiquette, avec ce qu'elle marque : titre, figure, tableau, équation ou autre.
- **Citations** : chaque clé citée et le nombre de fois où elle est citée. Une clé absente de la bibliographie est marquée **Introuvable dans la bibliographie**, et la Vue d'ensemble indique combien il y en a.
- **À faire** : les notes `TODO`, `FIXME` et `XXX` dans le source. En LaTeX, `\todo`, `\missingfigure` et les notes du paquet fixme comptent aussi.

Cliquez sur une ligne pour fermer la boîte de dialogue et sauter à cette ligne. Une ligne en gris n'a pas pu être reliée au source.

## Numéros et pages

L'origine des numéros dépend du moteur :

- **LaTeX** : les numéros de figures, de tableaux, d'équations et de titres, ainsi que leurs pages, viennent de la dernière compilation, pour les éléments qui ont une étiquette. Le pied de page indique s'ils sont à jour. Si vous avez modifié le document depuis, recompilez pour les mettre à jour.
- **Typst** : la boîte de dialogue demande à Typst de lire le document à son ouverture, avec la version de Typst du projet et la variante de compilation choisie, donc les numéros et les pages correspondent au source tel qu'il est maintenant. Si Typst ne peut pas compiler le document, la Vue d'ensemble liste plutôt les erreurs, chacune reliée à sa ligne. Seuls les 5 000 premiers éléments sont listés. Le pied de page nomme la version de Typst utilisée.
- **Markdown** : les entrées sont listées dans l'ordre du source, sans numéros ni pages.

**Actualiser** relit le document sans fermer la boîte de dialogue.

## Métadonnées de soumission

La Vue d'ensemble affiche aussi le **Titre**, les **Auteurs**, les **Mots-clés**, la **Date** et le **Résumé** qu'Oleafly a trouvés. Ce qui manque s'affiche **Non défini**.

- En LaTeX, elles viennent de `\title`, `\author`, `\date`, de l'environnement `abstract`, et d'une commande `\keywords` ou d'un environnement `keywords` ou `IEEEkeywords`.
- En Typst, elles viennent des arguments du modèle que le document applique, ou de `#set document(...)`. Un résumé peut aussi venir d'un titre nommé « Abstract ».
- En Markdown, elles viennent de l'en-tête YAML : `title`, `author` ou `authors`, `date`, `keywords` et `abstract`.

**Copier les métadonnées de soumission** place le titre, les auteurs, les mots-clés et le résumé dans le presse-papiers sous forme de lignes étiquetées, prêtes à coller dans un formulaire de soumission. Le bouton est désactivé quand aucun n'est défini.

## Pages liées

- [Contrôles de prévérification](/docs/preflight/) : des contrôles plus approfondis du source, du journal et du PDF avant la soumission
- [Citations et bibliographie](/docs/citations/) : ajoutez les clés que l'Analyse du document signale comme manquantes
- [Réglages du document](/docs/document-settings/) : l'autre outil de document de la barre d'outils de l'éditeur
