# Importez votre travail existant dans Oleafly

Importez une archive de projet, convertissez un document, récupérez un paquet source arXiv, copiez un dépôt GitHub ou transformez un projet LaTeX en projet Typst.

Choisissez **Nouveau projet → Importer un projet**, ou utilisez **Importer** dans la bibliothèque. Oleafly crée un nouveau projet local et laisse le fichier ou le dépôt d'origine inchangé. Sauf si l'import apporte son propre dépôt Git, les fichiers importés deviennent le [premier commit Git](/docs/new-project/#the-first-git-commit) du projet, **Créer le projet**.

![Choisissez Importer un projet dans la boîte de dialogue de nouveau projet pour démarrer à partir d'un travail existant.](https://cdn.oleafly.com/images/screenshots/desktop/docs/new-project-dark-window-v2.png)

## Choisissez la voie qui correspond à votre source

| Ce que vous avez | Voie d'importation | Projet que vous pouvez créer |
| --- | --- | --- |
| Un dossier de projet complet | **Projet existant** (`.zip`) | Les fichiers source archivés, les figures, la bibliographie et les fichiers de style locaux |
| Un document Word | **Document Word** (`.docx`) | LaTeX, Markdown ou Typst |
| Un document Markdown | **Document Markdown** (`.md`, `.markdown`) | LaTeX ou Typst |
| Un document HTML | **Page HTML** (`.html`, `.htm`) | LaTeX, Markdown ou Typst |
| Un document Typst | **Document Typst** (`.typ`) | LaTeX ou Markdown |
| Un article arXiv | **Article arXiv** avec un identifiant ou une URL | Le paquet source LaTeX de l'article |
| Un dépôt GitHub | **GitHub** | Un projet local connecté au dépôt |
| Un PDF sans source modifiable | **Oleafly Tools → Convertisseurs PDF** | Du LaTeX, du Markdown ou du Typst reconstruit, selon l'outil choisi |
| Un projet LaTeX déjà dans Oleafly | **Convertir en projet Typst** dans la palette de commandes | Un nouveau projet Typst, le projet LaTeX restant tel quel |

Choisissez le même format de rédaction uniquement quand Oleafly le propose. Pour conserver un fichier Markdown ou Typst dans son format d'origine, démarrez un projet vierge pour ce format et ajoutez le fichier source via l'[arborescence de fichiers](/docs/files/#adding-existing-files).

## Importer une archive de projet complète

Utilisez un ZIP lorsque vous avez déjà une arborescence source fonctionnelle.

1. Placez le document principal, les figures, la bibliographie et les fichiers de classe ou de style locaux dans un seul dossier. Conservez les chemins relatifs utilisés par les fichiers source.
2. Compressez le dossier en un fichier `.zip`.
3. Choisissez **Importer → Projet existant** et sélectionnez le ZIP.
4. Vérifiez le document principal marqué d'une étoile dans l'arborescence importée.
5. Compilez. Si le projet nécessite une autre chaîne d'outils LaTeX, choisissez-la dans le menu du compilateur.

Par exemple, gardez `main.tex`, `references.bib`, `sections/method.tex` et `figures/plot.pdf` ensemble. Un ZIP de sources préserve ces relations. Un PDF ne contient pas la même structure de projet modifiable.

Si l'archive contient plus d'un document principal probable, confirmez le bon via le menu des fichiers avant de compiler.

## Quel compilateur LaTeX pour une importation

Un projet LaTeX importé ou converti démarre sur le moteur de compilation par défaut défini dans **Paramètres → Moteurs → LaTeX**, à savoir Tectonic, sauf si vous l'avez changé. Quand cette valeur par défaut est `latexmk` et que le projet nomme pdfLaTeX, XeLaTeX ou LuaLaTeX, il conserve ce compilateur. Si l'importation rencontre des fonctions que Tectonic ne peut pas gérer, la boîte de dialogue des moteurs s'ouvre pour que vous puissiez en choisir un autre. Voir [Définir une valeur par défaut pour les nouveaux projets](/docs/engines/#set-a-default-for-new-projects) et [Quand Tectonic ne suffit pas](/docs/latex-engines/#when-tectonic-isnt-enough).

## Convertir Word, Markdown, HTML ou Typst

1. Choisissez le type de document correspondant dans **Importer**.
2. Sélectionnez le fichier.
3. Si Oleafly propose plusieurs destinations, choisissez le format dans lequel vous voulez éditer ensuite. LaTeX est indiqué comme la voie recommandée.
4. Terminez la configuration de Pandoc si vous y êtes invité. Oleafly peut utiliser une installation compatible ou télécharger sa version gérée.
5. Ouvrez le nouveau projet, compilez-le et comparez-le à l'original.

Les conversions s'exécutent localement via Pandoc. Un import Word ou HTML extrait aussi les médias intégrés dans le projet afin que le source converti puisse y faire référence. Un document Markdown importé dans un projet LaTeX conserve ses citations : `[@key]` devient `\citep` ou `\citet`, et le fichier de bibliographie l'accompagne, si bien que le panneau Références contient vos sources dès le départ.

Choisissez la destination en fonction du travail à venir :

- **LaTeX** convient aux modèles de revues, à la composition détaillée et aux flux PDF balisés.
- **Markdown** convient à un format de source plus léger et à la conversion de documents au sens large.
- **Typst** convient à la compilation rapide et aux modèles natifs Typst.

La conversion préserve la structure du document là où le format source l'expose. Les mises en page propres à Word, le style HTML personnalisé, les tableaux ajustés à la main, les citations et les équations complexes peuvent encore demander une passe de nettoyage. Comparez les titres, les listes, les tableaux, les équations, les liens, les citations et le placement des images avant de supprimer l'original.

## Importer un paquet source arXiv

Choisissez **Article arXiv**, puis collez un identifiant tel que `2401.01234` ou une URL `arxiv.org/abs/...`. Oleafly télécharge le paquet source soumis et l'ouvre comme projet LaTeX.

Utilisez cette voie quand vous avez besoin du source modifiable des auteurs. Utilisez [arXiv vers LaTeX](/docs/tools/arxiv-to-latex/) pour inspecter ou enregistrer une archive source sans passer par la boîte de dialogue d'import, et [arXiv vers Typst](/docs/tools/arxiv-to-typst/) pour obtenir l'article converti en Typst. Un identifiant arXiv nécessite une connexion réseau, ce qui n'est pas le cas d'une archive source déjà présente sur le disque.

Vérifiez toujours la licence et les conditions des auteurs avant de réutiliser le source ou les figures.

## Importer depuis GitHub

Choisissez **GitHub** dans la boîte de dialogue d'import. Si nécessaire, connectez votre compte via **Paramètres → Intégrations → GitHub**, puis sélectionnez un dépôt auquel vous avez accès.

Oleafly crée une copie locale dans la bibliothèque. Vérifiez son document principal et lancez une compilation avant de modifier. [Synchronisation GitHub](/docs/github-sync/) explique les opérations de pull, de commit et de publication des modifications après l'import.

## Convertir un projet LaTeX en Typst

Oleafly peut créer une copie Typst d'un projet LaTeX que vous avez déjà. Le projet LaTeX n'est pas modifié.

1. Ouvrez le projet LaTeX.
2. Ouvrez la palette de commandes ⌘K (Ctrl+K) et lancez **Convertir en projet Typst**.
3. Vérifiez le **Nom du nouveau projet**. Il prend par défaut le nom du projet suivi de `(Typst)`.
4. Choisissez **Convertir**. Oleafly convertit le projet avec Pandoc, crée le projet Typst et le compile une fois à titre de vérification.
5. Lisez le rapport, puis choisissez **Ouvrir le projet Typst**.

Le rapport indique si le nouveau projet compile, dénombre ce qui a été converti et liste ce qui demande une correction à la main, avec des liens vers chaque erreur de compilation. [Projets Typst](/docs/typst/#convert-a-latex-project-to-typst) explique la conversion et le rapport en détail.

## Reconstruire un PDF

Activez **Outils LaTeX** dans **Paramètres → Expérimentation**, puis choisissez l'outil correspondant au résultat dont vous avez besoin :

- [PDF vers LaTeX](/docs/tools/pdf-to-latex/) pour un projet LaTeX ou une archive source
- [PDF vers Markdown](/docs/tools/pdf-to-markdown/) pour du Markdown modifiable
- [PDF vers Typst](/docs/tools/pdf-to-typst/) pour du Typst modifiable

Le pipeline PDF local lit la couche de texte, restaure l'ordre de lecture et extrait les figures. Dans **PDF vers LaTeX**, passez en mode document numérisé quand le PDF est constitué d'images de pages. Cette voie utilise le modèle pour les Outils, un modèle Ollama local sauf si vous en choisissez un autre, et prend en charge les documents jusqu'à 50 pages.

Comparez le résultat avec le PDF page par page. Colonnes, équations, tableaux, notes de bas de page et ordre de lecture sont des problèmes de reconstruction : aucune conversion de PDF ne doit donc être traitée comme le source d'origine.

## Ajouter des références sans importer un manuscrit

Importez du BibTeX, du RIS, de l'EndNote XML ou du Zotero RDF via [Références et citations](/docs/citations/#import-a-whole-reference-library). Liez un dossier d'articles ou de données comme [contexte de recherche en lecture seule](/docs/linked-folders/) quand il doit rester en dehors du projet.