> For the complete documentation index, see [llms.txt](https://academy.shade.inc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.shade.inc/shade-academy/shade-academy-fr/shadefs/pinning-files-offline.md). # Épingler des fichiers hors ligne ## Comment fonctionne l’épinglage Les fichiers épinglés sont stockés dans votre répertoire de cache, aux côtés des autres fichiers mis en cache, mais ils ne sont pas soumis aux limites de taille du cache ni aux règles d’éviction. Lorsque vous épinglez du contenu, ShadeFS crée une copie locale complète qui persiste jusqu’à ce que vous la désépingliez explicitement. **Cela signifie que vous pouvez épingler autant de contenu que votre stockage local peut en contenir, indépendamment de la taille de cache configurée.** {% embed url="" %}
## Travailler hors ligne Les fichiers épinglés restent pleinement accessibles, même hors ligne. Toutes les modifications que vous apportez aux fichiers épinglés pendant que vous êtes hors ligne sont marquées comme « modifiées » dans le système, ce qui indique qu’elles doivent être synchronisées avec le cloud. Ces fichiers sont protégés de l’éviction du cache jusqu’à ce qu’ils puissent être synchronisés avec succès, afin de garantir qu’aucun travail ne soit perdu lorsque vous revenez en ligne. Lors de la reconnexion ou du redémarrage de ShadeFS, le système identifie automatiquement tous les fichiers modifiés et les synchronise avec le cloud Shade. ## Modifications en conflit Si quelqu’un d’autre a modifié le même fichier pendant que vous étiez hors ligne, ShadeFS conserve les deux versions. Leur version conserve le nom d’origine, et votre version est enregistrée à côté avec `-conflict-` et un numéro ajouté à la fin du nom, par exemple `edit.prproj-conflict-2847193021`. Rien n’est écrasé, donc vous pouvez comparer les deux et conserver celui que vous voulez. La même chose s’applique si vous et quelqu’un d’autre créez tous les deux un fichier portant le même nom. ## Hiérarchie d’épinglage ShadeFS gère l’épinglage avec un système hiérarchique. Lorsqu’on travaille avec des dossiers imbriqués : * Épingler un dossier parent inclut automatiquement tout son contenu * Si un dossier extérieur et un dossier intérieur sont tous deux épinglés, désépingler le dossier intérieur n’aura aucun effet, car l’état d’épinglage du dossier extérieur est prioritaire * Vous pouvez épingler de manière sélective des fichiers ou dossiers spécifiques dans un dossier parent non épinglé ## Utilisation flexible L’un des principaux avantages de l’épinglage dans ShadeFS est sa flexibilité : * Vous pouvez épingler des fichiers sans monter d’abord le lecteur * Il n’y a pas de limite à la quantité de contenu que vous pouvez épingler (au-delà de l’espace de stockage disponible) * L’état d’épinglage persiste après les redémarrages du système et les reconnexions * Vous pouvez continuer à travailler avec des fichiers épinglés même hors ligne * Vous pouvez continuer à travailler pendant que les fichiers s’épinglent. Les fichiers que vous ouvrez via le lecteur monté se téléchargent toujours avant les fichiers épinglés, donc l’épinglage ralentit pendant que vous lisez activement des médias plutôt que de ralentir leur lecture. ## Gérer le contenu épinglé {% hint style="info" %} Les fichiers épinglés enregistreront tous les fichiers que vous épinglez en mode totalement hors ligne, en contournant les limites de cache que vous avez définies, lesquelles sont utilisées pour le stockage éphémère et standard. Cela signifie qu’il est possible d’épingler **davantage que l’espace encore disponible sur votre lecteur de cache, selon ce que vous essayez d’épingler.** {% endhint %} Pour épingler des fichiers ou des dossiers : 1. Ouvrez l’application Shade 2. Accédez au contenu souhaité 3. Faites un clic droit et sélectionnez « Épingler au cache » Pour désépingler du contenu : 1. Faites un clic droit sur l’élément épinglé 2. Sélectionnez « Désépingler du cache » Le désépinglage d’un fichier supprime également sa copie locale. Vous pouvez également désépingler des fichiers depuis **Paramètres > ShadeFS > Gestion du cache**. Pour afficher tous les fichiers ou dossiers épinglés, vous pouvez accéder à la **Éléments épinglés** page, accessible au niveau du lecteur ou de l’espace de travail. ### Épingler depuis le Finder (macOS) Sur macOS, vous pouvez également épingler et désépingler directement depuis le Finder. Faites un clic droit sur un fichier ou un dossier sur un lecteur Shade monté et sélectionnez **Épingler au cache** ou **Désépingler du cache**. Si vous avez sélectionné plusieurs éléments, l’option indique combien d’éléments seront épinglés ou désépinglés. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://academy.shade.inc/shade-academy/shade-academy-fr/shadefs/pinning-files-offline.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.