FAQ et dépannage
Réponses rapides sur les premiers pas, les projets, la compilation, les assistants et les sauvegardes.
Premiers pas
Section intitulée « Premiers pas »Ai-je besoin d’un compte ?
Section intitulée « 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 ?
Section intitulée « 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 vous accompagne pour votre premier PDF.
Puis-je importer un article ou un CV existant ?
Section intitulée « 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 pour choisir la bonne voie.
Puis-je travailler hors ligne ?
Section intitulée « 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 ?
Section intitulée « 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 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 ?
Section intitulée « Puis-je utiliser Oleafly pour une thèse ou un CV ? »Oui. Commencez par le flux de travail thèse ou le flux de travail CV. 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
Section intitulée « Installation »Le système d’exploitation bloque l’installateur
Section intitulée « Le système d’exploitation bloque l’installateur »Vérifiez que le fichier provient des versions officielles (s’ouvre dans un nouvel onglet) et correspond à votre plateforme. Suivez le guide d’installation pour les étapes de premier lancement de la plateforme.
Quel paquet Linux dois-je utiliser ?
Section intitulée « 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 pour la configuration requise.
Compilation
Section intitulée « Compilation »Ma première compilation est lente
Section intitulée « 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 pour voir ce qui se passe.
Un paquet manque
Section intitulée « 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.
J’ai choisi pdfLaTeX et Oleafly demande une distribution TeX
Section intitulée « 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é.
MiKTeX dit que latexmk a besoin de Perl
Section intitulée « 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.
Du texte manque dans mon PDF
Section intitulée « 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 et Caractères qui s’affichent en cases.
Oleafly a arrêté ma compilation parce qu’elle durait trop longtemps
Section intitulée « 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 ?
Section intitulée « 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.
Mon document utilise minted ou PythonTeX
Section intitulée « 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.
La compilation s’est terminée avec des avertissements
Section intitulée « 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 aide à trouver les emplacements du source concernés avant l’export.
Je ne comprends pas une erreur de compilation
Section intitulée « 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.
Pourquoi un format d’export manque-t-il ?
Section intitulée « 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.
Assistants IA
Section intitulée « Assistants IA »Quel assistant puis-je utiliser ?
Section intitulée « Quel assistant puis-je utiliser ? »Connectez un fournisseur de modèles, utilisez un modèle local ou choisissez un agent CLI. Configurer l’IA couvre chaque voie.
Ai-je besoin de l’IA pour utiliser l’éditeur ?
Section intitulée « 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 ?
Section intitulée « 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.
Que signifie Vérifié à côté d’un modèle ?
Section intitulée « 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.
Pourquoi l’utilisation s’affiche-t-elle comme Inconnu ?
Section intitulée « 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.
Puis-je connecter un assistant externe ?
Section intitulée « Puis-je connecter un assistant externe ? »Oui. Utilisez une connexion d’agent CLI intégrée, activez le serveur MCP local d’Oleafly, ou connectez votre agent à la commande oleafly, qui fonctionne aussi quand l’application est fermée.
Historique et collaboration
Section intitulée « Historique et collaboration »Comment récupérer une version antérieure ?
Section intitulée « Comment récupérer une version antérieure ? »Ouvrez les Points de contrôle pour comparer le source des builds réussis et restaurer une version. Utilisez le Contrôle de version pour les commits Git que vous gérez vous-même.
Puis-je travailler avec un coauteur ?
Section intitulée « Puis-je travailler avec un coauteur ? »Oui. Avec la collaboration en direct, 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 pour échanger des commits.
Puis-je utiliser mes projets sur deux ordinateurs ?
Section intitulée « Puis-je utiliser mes projets sur deux ordinateurs ? »Oui. La synchronisation cloud 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.
Exporter le source sauvegarde-t-il tout ?
Section intitulée « 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 pour inclure ce dont vous avez besoin.
Signaler un problème
Section intitulée « 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 (s’ouvre dans un nouvel onglet) ; utilisez la communauté Discord pour les questions et l’aide sur les flux de travail.