> 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

Contrairement au système de cache standard, les fichiers épinglés existent dans un espace de stockage séparé qui n’est 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 accueillir, quelle que soit la taille de cache configurée.

{% embed url="<https://youtu.be/apDcYPUC7tw?si=LB3hSQr8zL2Ow_Md>" %}

<figure><img src="/files/29780ffabdc075ae22d24d4517948120f4ef4051" alt=""><figcaption></figcaption></figure>

## Travail hors ligne

Les fichiers épinglés restent entièrement accessibles même hors ligne. Toute modification que vous apportez à des fichiers épinglés pendant que vous êtes hors ligne est marquée comme « modifiée » dans le système, indiquant qu’elle doit être synchronisée 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 qu’aucun travail ne soit perdu lorsque vous vous reconnectez.

Lors de la reconnexion ou du redémarrage de ShadeFS, le système identifie automatiquement les fichiers modifiés et les synchronise avec le cloud Shade. Actuellement, en cas de modifications conflictuelles entre utilisateurs, la modification la plus récente est prioritaire comme source de vérité.

## Hiérarchie d’épinglage

ShadeFS gère l’épinglage à l’aide d’un système hiérarchique. Lors du travail avec des dossiers imbriqués :

* Épingler un dossier parent inclut automatiquement tout son contenu
* Si un dossier externe et un dossier interne sont tous deux épinglés, le désépinglage du dossier interne n’aura aucun effet, car l’état d’épinglage du dossier externe est prioritaire
* Vous pouvez épingler de manière sélective des fichiers ou des dossiers spécifiques au sein d’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 votre stockage disponible)
* L’état épinglé 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

## Gestion du contenu épinglé

{% hint style="info" %}
Les fichiers épinglés enregistreront tous les fichiers que vous épinglez entièrement hors ligne, en évitant les limites de cache que vous avez définies, qui sont utilisées pour le stockage éphémère et standard. Cela signifie qu’il est possible pour vous d’épingler **plus que ce qu’il vous reste de disponible sur votre lecteur de cache, selon que vous essayez ou non 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 »

Pour afficher tous les fichiers ou dossiers épinglés, vous pouvez accéder à la **Éléments épinglés** page, à laquelle vous pouvez accéder au niveau du lecteur ou de l’espace de travail.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://academy.shade.inc/shade-academy/shade-academy-fr/shadefs/pinning-files-offline.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
