> 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 distinct qui n’est pas soumis aux limitations 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>

## Utilisation hors ligne

Les fichiers épinglés restent pleinement accessibles même hors ligne. Toute modification apportée aux 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 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. Actuellement, en cas de modifications conflictuelles entre utilisateurs, la modification la plus récente prévaut comme source de vérité.

## Hiérarchie d’épinglage

ShadeFS gère l’épinglage à l’aide d’un système hiérarchique. Lorsque vous travaillez 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, désépingler le 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 dans un dossier parent non épinglé

## Utilisation flexible

Un avantage clé de l’épinglage dans ShadeFS est sa flexibilité :

* Vous pouvez épingler des fichiers sans d’abord monter le lecteur
* Il n’y a pas de limite à la quantité de contenu que vous pouvez épingler (au-delà de votre espace de 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é

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 dans le cache »

Pour désépingler du contenu :

1. Faites un clic droit sur l’élément épinglé
2. Sélectionnez « Désépingler »

Pour voir 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.
