# FAQ et dépannage

Réponses rapides sur les premiers pas, les projets, la compilation, les assistants et les sauvegardes.

## Premiers pas

### Ai-je besoin d'un compte ?

Non. Téléchargez Oleafly, ouvrez-le et écrivez. Les services optionnels comme un fournisseur d'IA cloud, GitHub ou Dropbox utilisent leurs propres comptes.

### Oleafly prend-il en charge LaTeX, Typst et Markdown ?

Oui. Choisissez le moteur à la création d'un projet. Chaque moteur a ses propres capacités d'édition et d'export. Le [guide de démarrage rapide](/docs/getting-started/) vous accompagne pour votre premier PDF.

### Puis-je importer un article ou un CV existant ?

Oui. Importez le source d'un projet, une archive ZIP ou un dépôt Git. Oleafly propose aussi des chemins de conversion pour les DOCX et les PDF textuels. Lisez [Importer un projet existant](/docs/import-project/) pour choisir la bonne voie.

### Puis-je travailler hors ligne ?

Vous pouvez écrire, organiser des fichiers, utiliser la relecture locale et exécuter un modèle d'IA local téléchargé sans connexion cloud. Tectonic peut compiler avec des paquets en cache. Les nouveaux paquets, les références distantes, les modèles cloud, GitHub et les téléchargements exigent une connexion. Préparez un projet avec une compilation réussie avant de le passer hors ligne.

### Où sont mes fichiers ?

Vos projets sont des dossiers ordinaires dans votre bibliothèque locale. Vous pouvez les copier, les sauvegarder ou les ouvrir dans un autre outil. [Où vivent vos données](/docs/where-your-data-lives/) explique les fichiers de projet, les réglages de l'application et les points de contrôle.

### Puis-je utiliser Oleafly pour une thèse ou un CV ?

Oui. Commencez par le [flux de travail thèse](/docs/workflows/thesis/) ou le [flux de travail CV](/docs/workflows/resume/). Les deux utilisent le même éditeur, le même aperçu, les mêmes références et les mêmes outils d'export que pour un article de recherche.

## Installation

### Le système d'exploitation bloque l'installateur

Vérifiez que le fichier provient des [versions officielles](https://github.com/Oleafly/Oleafly/releases/latest) et correspond à votre plateforme. Suivez le [guide d'installation](/docs/install/#first-launch) pour les étapes de premier lancement de la plateforme.

### Quel paquet Linux dois-je utiliser ?

Choisissez l'architecture qui correspond à votre ordinateur, puis le paquet AppImage, le paquet Debian ou le RPM. Voir [Installation sous Linux](/docs/install/#linux) pour la configuration requise.

## Compilation

### Ma première compilation est lente

Tectonic peut devoir télécharger les paquets utilisés par ce document, et la première compilation sur un ordinateur récupère aussi un lot de paquets courants. Ils sont mis en cache pour les builds suivants. Tant que des paquets sont encore en cours de téléchargement, la compilation peut dépasser sa limite habituelle de cinq minutes. Ouvrez les [Journaux](/docs/compiling/#reading-the-logs) pour voir ce qui se passe.

### Un paquet manque

Si le mode hors ligne est activé, choisissez **Désactiver et compiler** dans le message, ou désactivez-le pour une compilation afin de récupérer le paquet. Sur une chaîne d'outils TeX système, utilisez **Trouver et installer** dans l'erreur. Un TeX Live de Debian, Ubuntu ou Fedora reçoit ses paquets par `apt` ou `dnf`. Voir [Moteurs et paquets LaTeX](/docs/latex-engines/#recover-from-a-missing-file).

### J'ai choisi pdfLaTeX et Oleafly demande une distribution TeX

pdfLaTeX, XeLaTeX, LuaLaTeX, upLaTeX et pLaTeX s'exécutent sur une distribution TeX installée sur votre ordinateur. Quand il n'y en a pas, en choisir un ouvre une boîte de dialogue avant toute compilation. Choisissez **Télécharger et utiliser TinyTeX** pour en installer une, ou **Revenir à Tectonic** pour retourner au moteur intégré. Après une compilation échouée, l'aperçu propose le même choix sous la forme de **Télécharger et utiliser TinyTeX** et **Utiliser Tectonic**. Voir [Quand aucun TeX n'est installé](/docs/latex-engines/#when-no-tex-is-installed).

### MiKTeX dit que latexmk a besoin de Perl

Le `latexmk` de MiKTeX s'exécute avec Perl, que MiKTeX n'inclut pas. Installez Strawberry Perl, ou installez TinyTeX depuis **Paramètres → Moteurs → LaTeX**, qui apporte son propre Perl et prend le relais de MiKTeX pour les compilations. Voir [MiKTeX et Perl](/docs/latex-engines/#miktex-and-perl).

### Du texte manque dans mon PDF

La police n'a pas de glyphes pour ces caractères. Cela arrive surtout avec du texte coréen, chinois et japonais, et TeX omet les caractères sans faire échouer la compilation. Oleafly vous avertit et les liste dans le journal. En LaTeX, collez la configuration que l'avertissement donne pour votre écriture. En Typst, téléchargez le pack de polices que l'avis propose, ou ajoutez au dossier `fonts` du projet une police qui contient ces caractères. En Markdown, réglez `mainfont` ou `CJKmainfont` dans l'en-tête YAML sur une police qui les contient. Voir [Caractères manquants dans le PDF](/docs/latex-engines/#characters-missing-from-the-pdf) et [Caractères qui s'affichent en cases](/docs/typst/#characters-that-show-as-boxes).

### Oleafly a arrêté ma compilation parce qu'elle durait trop longtemps

Une compilation peut durer 5 minutes. Tant que des paquets sont encore en cours de téléchargement, la limite s'étend jusqu'à 30 minutes. Markdown vers PDF dispose de 15 minutes, et Quarto et Calepin d'une heure. Compilez de nouveau : un téléchargement reprend là où il s'était arrêté. Pour les longs brouillons sur Tectonic, réglez le **Mode de compilation** sur **Rapide** dans le menu de compilation.

### Les nouveaux projets peuvent-ils utiliser ma propre installation TeX ?

Oui. Ouvrez **Paramètres → Moteurs → LaTeX** et réglez **Moteur de compilation par défaut** sur **latexmk (TeX du système)**. Les projets LaTeX nouveaux, importés et convertis démarrent alors dessus. Voir [Définir une valeur par défaut pour les nouveaux projets](/docs/engines/#set-a-default-for-new-projects).

### Mon document utilise minted ou PythonTeX

Ces paquets exécutent d'autres programmes pendant la compilation du document, ce qu'Oleafly bloque par défaut. Ils exigent un LaTeX système. Si vous faites confiance à chaque fichier du projet, choisissez **Autoriser les commandes externes** dans le bandeau au-dessus de l'éditeur. Voir [Autoriser les commandes externes](/docs/latex-engines/#allow-external-commands).

### La compilation s'est terminée avec des avertissements

Ouvrez les **Journaux** et contrôlez d'abord les citations et les références non définies. La [Prévérification](/docs/preflight/) aide à trouver les emplacements du source concernés avant l'export.

### Je ne comprends pas une erreur de compilation

Demandez à l'assistant de lire le journal, de corriger l'erreur et de recompiler. Utilisez **Demander l'autorisation** quand vous voulez examiner les actions proposées au fil de l'eau. Vous pouvez aussi publier le journal dans le forum d'aide sur [Discord](/discord).

### Pourquoi un format d'export manque-t-il ?

Les formats disponibles dépendent du moteur et du type de document. Consultez le [tableau des exports](/docs/export/#editable-formats).

## Assistants IA

### Quel assistant puis-je utiliser ?

Connectez un fournisseur de modèles, utilisez un modèle local ou choisissez un [agent CLI](/docs/cli-agents/). [Configurer l'IA](/docs/ai-setup/) couvre chaque voie.

### Ai-je besoin de l'IA pour utiliser l'éditeur ?

Non. L'écriture, la compilation, les citations, les aperçus, les diagrammes, l'historique de projet et les exports sont disponibles sans assistant.

### Que peut faire l'assistant ?

Il peut travailler avec les fichiers du projet, chercher des sources, inspecter un PDF, créer des figures, exécuter des outils et aider à réparer un build. Choisissez un plan et une politique d'approbation adaptés au travail. Voir [Travailler avec un assistant](/docs/ai-chat/).

### Que signifie Vérifié à côté d'un modèle ?

Le modèle a réussi une sonde d'appel d'outils. Cela vous aide à choisir un modèle pour les actions de projet ; cela n'évalue pas la qualité de son écrit ou de sa recherche. Voir [Configurer l'IA](/docs/ai-setup/).

### Pourquoi l'utilisation s'affiche-t-elle comme Inconnu ?

Certains fournisseurs et agents CLI ne rapportent pas l'utilisation. Inconnu signifie que la valeur n'est pas disponible. Lisez [Utilisation de l'IA et budgets](/docs/ai-usage/).

### Puis-je connecter un assistant externe ?

Oui. Utilisez une [connexion d'agent CLI](/docs/cli-agents/) intégrée, activez le [serveur MCP](/docs/mcp/) local d'Oleafly, ou connectez votre agent à la [commande `oleafly`](/docs/cli/), qui fonctionne aussi quand l'application est fermée.

## Historique et collaboration

### Comment récupérer une version antérieure ?

Ouvrez les [Points de contrôle](/docs/checkpoints/) pour comparer le source des builds réussis et restaurer une version. Utilisez le [Contrôle de version](/docs/git-history/) pour les commits Git que vous gérez vous-même.

### Puis-je travailler avec un coauteur ?

Oui. Avec la [collaboration en direct](/docs/collaboration/), vous et vos coauteurs modifiez le même projet en même temps via un serveur de collaboration que votre groupe exploite. Chacun garde le projet sous forme de fichiers sur son propre ordinateur. Vous pouvez aussi partager des archives de source ou utiliser la [synchronisation GitHub](/docs/github-sync/) pour échanger des commits.

### Puis-je utiliser mes projets sur deux ordinateurs ?

Oui. La [synchronisation cloud](/docs/cloud-sync/) conserve les projets et les réglages de votre bibliothèque dans votre propre Dropbox, et chaque ordinateur que vous connectez peut les télécharger. Ouvrez **Paramètres → Stockage des données → Synchronisation cloud** pour la connecter. Vous pouvez aussi déplacer un projet entre ordinateurs avec la [synchronisation GitHub](/docs/github-sync/).

### Exporter le source sauvegarde-t-il tout ?

Cela sauvegarde le source du projet. Les points de contrôle automatiques, les préférences de l'application et les identifiants vivent séparément. Suivez le [guide de sauvegarde](/docs/where-your-data-lives/#back-up-your-work) pour inclure ce dont vous avez besoin.

## Signaler un problème

Ouvrez **Paramètres → Aide et à propos → Copier les infos** et joignez ces détails avec une description courte, les étapes pour reproduire le problème et le journal pertinent. Signalez-le dans [Issues](https://github.com/Oleafly/Oleafly/issues) ; utilisez la [communauté Discord](/discord) pour les questions et l'aide sur les flux de travail.
