Vos fichiers et vos données
Sachez ce qui voyage avec un projet et comment sauvegarder le source, l'historique et les données de l'application.
Votre manuscrit est un dossier de fichiers sources ordinaires. Vous pouvez ouvrir ces fichiers avec un autre éditeur, les sauvegarder ou les sortir d’Oleafly.
Fichiers du projet
Section intitulée « Fichiers du projet »Les projets de la bibliothèque vivent normalement sous ~/.oleafly/projects/. Un projet peut contenir un document principal LaTeX, Typst ou Markdown, une bibliographie, des figures et du matériel de recherche.
project.json consigne l’identité et les réglages du projet, dont son document principal, son moteur et sa version de Typst épinglée. Un répertoire .git contient l’historique Git. Un projet qu’Oleafly crée ou importe commence normalement par un commit de ses fichiers, appelé « Créer le projet » (voir Git et le contrôle de version). Le répertoire .oleafly/build/ contient la sortie de compilation générée et peut être recréé en compilant.
Un projet Typst peut conserver des copies des paquets qu’il importe dans un dossier typst-packages, et compile ainsi hors ligne et sur d’autres ordinateurs. Typst utilise aussi les polices du dossier fonts d’un projet. Ces deux dossiers voyagent avec le projet.
Un dossier que vous ouvrez sur place reste où il est. Oleafly conserve les builds, les réglages, les points de contrôle et les discussions de ce dossier dans son propre dossier de données, donc rien n’est ajouté au vôtre.
Données stockées en dehors du projet
Section intitulée « Données stockées en dehors du projet »Les préférences de l’application, les identifiants chiffrés des fournisseurs, les relevés de discussions et d’utilisation, les outils téléchargés comme les versions supplémentaires de Typst et les points de contrôle enregistrés appartiennent au stockage local de l’application. Il en va de même des copies d’un projet qu’Oleafly conserve d’avant chaque tour de l’assistant ou de l’agent, qui vous permettent d’annuler les fichiers que ce tour a modifiés. La copie de votre bibliothèque Zotero que la recherche @ lit vit aussi là, pas dans le projet. Copier un dossier de manuscrit ne copie pas toutes ces données d’application.
Les dossiers liés restent dans leurs emplacements d’origine. Une archive de sources n’inclut pas leur contenu simplement parce que vous les avez liés.
Où vivent les notes
Section intitulée « Où vivent les notes »Les notes sont des fichiers Markdown sur votre ordinateur. Chaque note personnelle est un dossier dans le dossier des projets, à côté des projets de votre bibliothèque. Une note de projet est un fichier .md dans le dossier notes du projet : elle voyage donc avec le projet. Voir Où sont stockées les notes pour le dossier sous Windows, macOS et Linux, et pour le contenu du dossier d’une note.
Où vit TinyTeX
Section intitulée « Où vit TinyTeX »Quand vous installez TinyTeX depuis Paramètres → Moteurs → LaTeX, Oleafly le place dans ~/.oleafly/tinytex. Windows fait exception quand le nom de votre dossier utilisateur contient des lettres accentuées ou non latines, comme un nom coréen ou chinois, car TeX Live ne peut pas fonctionner depuis un tel dossier. TinyTeX va alors dans un dossier nommé Oleafly- suivi d’un court code, à l’intérieur de ProgramData, qui est généralement C:\ProgramData. Aucun accès administrateur n’est nécessaire. Si Oleafly ne peut pas non plus préparer ce dossier, il le dit. Vous pouvez continuer à compiler avec Tectonic, ou installer TeX Live vous-même dans C:\texlive.
La ligne de TinyTeX sous Gérer les distributions TeX affiche le dossier ; survolez le chemin flouté pour le lire. Retirez TinyTeX depuis cette ligne plutôt que de supprimer le dossier à la main.
Sauvegardez votre travail
Section intitulée « Sauvegardez votre travail »| Ce que vous voulez conserver | Comment le conserver |
|---|---|
| Source du manuscrit et actifs du projet | Copiez le dossier du projet ou exportez un ZIP de sources |
| Commits Git | Sauvegardez le dépôt ou poussez vers votre distant configuré |
| Points de contrôle enregistrés | Exportez une archive d’historique chiffrée depuis la Gestion des versions |
| Préférences de l’application et relevés locaux | Incluez le répertoire de données d’Oleafly dans votre sauvegarde habituelle |
| Données et références liées | Sauvegardez leurs dossiers d’origine |
| Projets et réglages de la bibliothèque, hors de cet ordinateur | Activez la synchronisation cloud pour garder une copie dans votre Dropbox |
Un ZIP de sources exclut les caches de compilation et Git. Utilisez la synchronisation GitHub pour un dépôt distant et les archives de points de contrôle pour l’historique des points de contrôle.
Passer à un autre ordinateur
Section intitulée « Passer à un autre ordinateur »Installez Oleafly et copiez ou clonez le projet du manuscrit. Reconnectez les dossiers liés et les fournisseurs de modèles sur cette machine. Le projet transporte son choix de compilateur et ses métadonnées ; des outils ou paquets supplémentaires peuvent demander une installation. Un projet Typst qui épingle une version absente de cet ordinateur propose de la télécharger avant de compiler.
Chemins à l’écran
Section intitulée « Chemins à l’écran »Les chemins situés dans votre dossier personnel apparaissent sous la forme ~/… dans les Paramètres, l’historique des versions, les détails des moteurs et des agents, et les discussions. Dans les Paramètres, les chemins de fichiers et de dossiers restent aussi flous tant que vous ne les survolez pas ou n’y accédez pas avec Tab, pour qu’une capture d’écran ne montre pas où vivent vos fichiers.
Accès réseau
Section intitulée « Accès réseau »L’écriture et la relecture locale se font sur votre machine. L’IA hébergée reçoit le contexte fourni au fournisseur sélectionné. Les outils qui lisent des images et des PDF numérisés utilisent un modèle Ollama local, sauf si vous choisissez pour eux un modèle hébergé ou Mathpix ; le fichier part alors vers ce service. Les citations Zotero communiquent avec l’application Zotero sur votre ordinateur, ou avec zotero.org quand vous connectez un compte. La recherche de citations, l’import Zotero, les outils alphaXiv, la synchronisation GitHub, les téléchargements de paquets et de versions Typst, les autres téléchargements et les vérifications de mises à jour contactent leurs services respectifs. La collaboration en direct envoie chaque projet partagé au serveur de collaboration sur lequel il est partagé. La synchronisation cloud envoie vos projets et réglages de bibliothèque vers votre propre Dropbox. Ouvrir Paramètres → Aide et à propos récupère des chiffres publics : le nombre d’étoiles et de forks GitHub du projet et le nombre de membres en ligne dans la communauté Discord. Ces requêtes ne transportent ni information de compte, ni de projet, ni d’utilisation, et le mode hors ligne ignore celle de Discord. Tectonic et Typst prennent tous deux en charge la compilation depuis le cache via le mode hors ligne.