# Exporter et convertir un projet

Enregistrez le dernier PDF, empaquetez le source modifiable, exportez des images de pages ou du HTML, écrivez des PDF/A et PDF/UA depuis Typst, ou convertissez un document LaTeX, Typst ou Markdown.

Ouvrez **Exporter** dans la barre d'outils du projet. Le menu suit le moteur et le type du document en cours, et n'affiche donc que les chemins d'export qu'Oleafly peut exécuter pour ce projet.

![Exporter est le contrôle de téléchargement juste après Recompiler dans la barre de projet en haut.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png#view=1282,0,232,48)

## Choisir la sortie adaptée à votre destinataire

- Le **PDF** sert à la lecture, à l'impression et à la plupart des portails de soumission.
- Le **ZIP du source** est destiné aux coauteurs ou aux systèmes qui ont besoin du manuscrit, des figures, de la bibliographie et des styles locaux.
- Le **PNG de page** convient à une diapositive, un message ou un système de relecture qui attend une image.
- Les **PNG, SVG ou HTML écrits par Typst** concernent les projets Typst qui exigent chaque page en image, des pages vectorielles ou une page web.
- **Word, HTML, Markdown, Typst, LaTeX ou texte brut** sert quand quelqu'un doit modifier ou réutiliser le contenu dans un autre format.
- **PowerPoint** transforme une présentation ou un document Markdown en diapositives. **EPUB** cible les liseuses. Les formats proposés dépendent du moteur. Voir [Exports de présentations et de livres](#presentation-and-book-exports).

## Enregistrer un PDF, une archive du source ou une image de page

1. Choisissez **Recompiler** pour que la sortie intègre vos dernières modifications.
2. Vérifiez le PDF, y compris les dernières pages et la bibliographie.
3. Ouvrez **Exporter**.
4. Choisissez **Exporter en PDF**, **Exporter le source (.zip)** ou **Exporter la page en PNG**.
5. Choisissez une destination dans la boîte de dialogue d'enregistrement.
6. Choisissez **Afficher dans le dossier** dans le message de fin pour retrouver le fichier enregistré.

Les actions PDF et image de page restent désactivées jusqu'à ce que le projet ait un PDF, et le menu indique **Le PDF exige d'abord une compilation**. **Exporter en PDF** enregistre le PDF affiché dans l'aperçu. **Exporter la page en PNG** enregistre la page que vous regardez dans l'aperçu, en haute résolution.

Une archive du source exclut les caches de compilation et les mécanismes internes de Git. Elle laisse aussi de côté les liens symboliques, et le message de fin indique combien elle en a ignoré.

### Quand le PDF n'est pas à jour

Oleafly enregistre quand même le PDF ou l'image de page lorsque l'aperçu est périmé, et le message de fin vous le dit :

- Après une compilation échouée, il indique que la dernière compilation a échoué, si bien que le fichier peut être incomplet.
- Après des modifications non compilées, il indique que le fichier vient de la dernière compilation et ne comprend pas vos dernières modifications.

Recompilez, vérifiez l'aperçu et exportez de nouveau avant d'envoyer le fichier à qui que ce soit.

## Images et HTML Typst

Le menu Exporter d'un projet Typst propose aussi **Images et HTML**, qui ouvre **Exporter avec Typst**. Typst dessine lui-même ces fichiers, donc les pages PNG et SVG ressemblent exactement au PDF.

- Les **images PNG** acceptent une **Résolution** de 72, 144, 300 ou 600 PPI.
- Les **images SVG** conservent les pages en graphiques vectoriels.
- **HTML** est marqué **Expérimental**. Le HTML de Typst garde le texte et les images, mais omet la mise en page et les dessins. Avant Typst 0.15, il omet aussi les équations, et la boîte de dialogue le dit quand vous choisissez HTML.

Pour le PNG et le SVG, **Pages** accepte des numéros et des plages de pages tels que `1, 3-5` ou `8-`. Laissez le champ vide pour toutes les pages. Chaque page est enregistrée dans son propre fichier, numérotée d'après le nom que vous choisissez. Les plages de pages exigent Typst 0.12 ou ultérieur, et le HTML exige Typst 0.13 ou ultérieur. La boîte de dialogue ne propose que ce que la version de Typst du projet sait faire. Si le projet a des [variantes de compilation](/docs/typst/#build-variants-and-sysinputs), l'export utilise celle sélectionnée dans le menu de compilation.

## PDF/A et PDF/UA depuis Typst

Typst écrit lui-même les PDF d'archivage et accessibles. Ouvrez le **bouclier** dans le rail du projet pour la [Prévérification](/docs/preflight/), et cherchez **Normes PDF** sous le contrôle **Accessibilité**. Choisissez une **Norme**, par exemple PDF/A-2b ou PDF/UA-1, puis choisissez **Exporter le PDF**.

La liste dépend de la version de Typst du projet. Typst 0.11 n'en propose aucune, Typst 0.12 offre PDF/A-2b, Typst 0.13 ajoute PDF/A-3b, et Typst 0.14 et ultérieur offrent tous les niveaux PDF/A plus PDF/UA-1. Typst 0.14 et ultérieur balisent aussi chaque PDF pour les lecteurs d'écran, donc il n'y a pas de compilation balisée séparée. PDF/UA-1 exige un titre de document et du texte alternatif pour chaque image, et la Prévérification vérifie les deux.

## Formats modifiables

| Moteur du projet | Formats dans Exporter |
| --- | --- |
| **LaTeX** | Word, HTML autonome avec MathML, Markdown, Typst et texte brut |
| **Typst** | LaTeX, Word, HTML autonome avec MathML, Markdown et texte brut |
| **Markdown** | Word, HTML autonome avec MathML, Typst, LaTeX et texte brut |

Un projet Typst propose aussi EPUB, et un projet Markdown propose PowerPoint et EPUB. Un projet LaTeX ne les propose que pour une classe de document qui convient.

Ces conversions s'exécutent localement via Pandoc. Oleafly utilise une installation compatible présente sur votre ordinateur ou télécharge une version gérée vérifiée la première fois qu'elle est nécessaire.

Les projets Typst suivent un autre chemin. Typst écrit d'abord le document en HTML, et Pandoc transforme ce HTML en Word, HTML, Markdown, LaTeX, texte brut ou EPUB, si bien que les équations et les références passent. La possibilité de suivre ce chemin dépend de la version de Typst du projet :

| Version de Typst | Chemin |
| --- | --- |
| 0.15 ou ultérieur | Via le HTML |
| 0.13 et 0.14 | Via le HTML quand Typst peut écrire tout le document. Sinon, Pandoc lit le source Typst à la place. |
| 0.12 ou antérieur | Pandoc lit le source |

Si Typst s'arrête sur une erreur en écrivant le HTML, Pandoc lit le source quelle que soit la version. Quand Pandoc lit le source avec Typst 0.13 ou 0.14, le message de fin avertit que le texte pivoté, mis à l'échelle, déplacé ou incliné peut manquer, sauf si l'export a des avertissements. Pour l'export le plus complet, passez le projet à Typst 0.15 ou ultérieur sous **Version de Typst (ce projet)** dans le menu de compilation.

Quand l'export passe par le HTML, le texte à l'intérieur des fonctions de mise en page comme `align`, `grid` et `rotate` y reste. Un dessin fait avec CeTZ perd ses traits et ses formes et ne garde que ses étiquettes de texte, et le message de fin nomme ce que Typst a omis.

## Convertir un document

1. Compilez une fois et corrigez les erreurs du source.
2. Ouvrez **Exporter** et choisissez le format cible.
3. Terminez la configuration de Pandoc si on vous le demande. Si Oleafly dit que Pandoc n'est pas disponible, choisissez **Réparer Pandoc** dans **Paramètres → Moteurs → Markdown**, puis exportez de nouveau.
4. Enregistrez le fichier converti avec l'extension suggérée.
5. Lisez le message de fin. S'il mentionne des avertissements, choisissez **Afficher les avertissements** pour voir ce que l'export a omis.
6. Ouvrez le fichier dans l'application de destination et vérifiez sa structure et son apparence.

Pour un test rapide, exportez une section courte qui contient un titre, une équation, un tableau, une image et une citation. Si ces cinq éléments survivent bien, convertissez le manuscrit complet et vérifiez-le de nouveau.

Pour transformer tout un projet LaTeX en projet Typst dans lequel vous continuez à travailler, utilisez plutôt [Convertir en projet Typst](/docs/typst/#convert-a-latex-project-to-typst). Cela crée un nouveau projet et signale ce qui mérite attention.

### Ce que la conversion préserve

Pandoc s'attache à préserver les titres, les paragraphes, les listes, les liens, les citations, les tableaux, les images et les mathématiques modifiables. Il ne peut pas reproduire chaque fonctionnalité du langage source dans chaque cible. Vérifiez attentivement ces points :

- commandes et environnements LaTeX personnalisés
- mise en page ou flottants réglés à la main
- tableaux complexes ou imbriqués
- style de bibliographie et rendu des citations
- fonctions Typst sans équivalent direct dans la cible
- HTML brut ou extensions Markdown

L'export HTML intègre ses ressources et écrit les équations en MathML. Cela le rend utile pour partager un document qui doit s'ouvrir tout seul, mais il reste utile de le tester dans les navigateurs qu'emploient vos lecteurs.

### Ce que chaque format garde

- Les exports Word et PowerPoint transforment les figures PDF, SVG et WebP en images PNG à 220 ppi. Une figure sans taille dans le source garde sa propre largeur.
- Les exports HTML et EPUB transforment les figures PDF en images PNG.
- Le Markdown et le texte brut exportés depuis LaTeX gardent le titre, l'auteur et le résumé.
- Les exports vers Markdown ou Typst depuis LaTeX, et vers LaTeX ou Typst depuis Markdown, pointent vers les fichiers de figures du projet au lieu de les copier. Sauf si l'export a des avertissements, le message de fin vous rappelle de copier les images et la bibliographie à côté du fichier exporté avant de le compiler. Un document Markdown exporté vers Typst ou LaTeX garde la bibliographie qu'il déclare, ou les fichiers `.bib` du projet s'il n'en déclare aucune.
- Un export LaTeX d'un document Markdown suit son [type de document](/docs/writing/markdown/#document-types). Les diapositives et les posters deviennent du source Beamer, un rapport ou un livre commence ses chapitres aux titres `#`, et une lettre devient une lettre KOMA-Script.
- Un export LaTeX depuis Typst copie les images du document dans un dossier `<name>-media` à côté du fichier `.tex`. Les images SVG, GIF et WebP y deviennent des PDF, parce que LaTeX ne sait pas les lire.

Les exports cherchent les figures dans le dossier du document principal, la racine du projet et tout dossier `\graphicspath`, et ils trouvent une figure nommée sans son extension. Les figures EPS ne peuvent pas être converties : elles entrent donc dans le fichier telles quelles, avec un avertissement. Dans un export Word, HTML, EPUB ou PowerPoint d'un document Markdown, un bloc Mermaid affiche la figure enregistrée pour lui.

### Avertissements après un export

Pandoc omet ce qu'un format ne peut pas contenir. Quand cela arrive dans un export depuis un projet LaTeX ou Markdown, ou dans un export Typst qui lit le source, le message de fin indique que le fichier a été enregistré avec des avertissements, et combien, à la place de ses autres notes, comme le rappel de copier les images. Choisissez **Afficher les avertissements** pour ouvrir **Avertissements d'export**, qui liste ce qui a disparu. **Afficher dans le dossier**, dans cette boîte de dialogue, ouvre le dossier du fichier enregistré.

La liste peut nommer :

- un bloc que l'export a omis, avec son fichier et sa ligne quand ils sont connus, comme un `tikzpicture`, un `\includepdf` ou une commande de recouvrement Beamer comme `\only` ou `\uncover`
- une figure que l'export n'a pas pu trouver ou convertir
- une clé de citation absente de la bibliographie
- des mathématiques restées en code TeX
- des références qui n'ont pas encore de numéro, ce qu'une compilation corrige

Un avertissement répété n'apparaît qu'une fois, et la liste s'arrête à 50. Un export PowerPoint fonctionne autrement quand une figure manque : il s'arrête, n'enregistre aucun fichier, et l'erreur nomme la figure. Les exports Typst qui passent par le HTML disent plutôt ce que Typst a omis dans le message de fin.

## Exports de présentations et de livres

Un projet LaTeX les accorde à sa classe de document. **Exporter en PowerPoint (.pptx)** apparaît pour une présentation Beamer, et **Exporter en EPUB (.epub)** pour les classes `book`, `report`, `memoir`, `scrbook` et `scrreprt`.

Dans un jeu de diapositives Beamer, chaque frame ouvre une nouvelle diapositive, `\section` ajoute une diapositive de section, et `\subsection` n'en ajoute aucune. Une frame qui contient plusieurs images, ou une image et d'autres éléments, peut déborder sur une seconde diapositive.

Dans les projets Typst et Markdown, le menu ne vérifie pas le document pour ces exports. Un projet Markdown propose toujours les deux, et un projet Typst propose toujours EPUB. Quand un document Markdown devient PowerPoint, chaque titre de niveau 1 devient une diapositive de section et chaque titre de niveau 2 ouvre une nouvelle diapositive. L'exception est un document avec `type: slides` : une ligne `slide-level` dans son en-tête choisit le niveau de titre qui ouvre une diapositive. Chaque EPUB reçoit une table des matières, et ses équations sont en MathML.

Utilisez-les comme points de départ modifiables. La composition des diapositives et la typographie des livres se correspondent rarement un à un entre les formats, donc inspectez chaque diapositive ou chapitre dans son application de destination.

## Exporter une figure autonome

Un projet de figure autonome propose **Exporter en PDF (image vectorielle)** et **Exporter en PNG** après la compilation. Choisissez PDF pour des traits et un texte nets à toute échelle. Choisissez PNG quand la destination n'accepte que des images matricielles.

## Enregistrer la sortie dans le projet

L'[aperçu PDF](/docs/pdf-preview/) propose aussi **Enregistrer le PDF dans le projet**. Cela garde une copie de soumission ou une figure compilée à côté du source. Pour garder cette copie à jour, activez [Synchroniser le PDF à la compilation](/docs/pdf-preview/#sync-pdf-on-compiles) dans le même menu, et Oleafly actualise un PDF nommé d'après le projet après chaque compilation réussie. Un PDF antérieur peut être enregistré depuis un [point de contrôle](/docs/checkpoints/#save-a-pdf-from-a-checkpoint) sans restaurer le projet. Ajoutez ce fichier à l'[historique Git](/docs/git-history/) uniquement si vous avez l'intention de versionner la sortie générée.

## Vérifier avant de partager

Lancez la [Prévérification](/docs/preflight/) avant une soumission. Si vous avez besoin d'un PDF balisé, suivez le flux d'export accessible pour LaTeX ou choisissez une norme PDF/UA dans un projet Typst, puis vérifiez le résultat avec un outil PDF/UA indépendant et une revue d'accessibilité humaine. La Prévérification contrôle de nombreux signaux utiles, mais elle ne certifie pas la conformité.
