> 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 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>

## Travailler hors ligne

Les fichiers épinglés restent entièrement accessibles même hors ligne. Toute modification que vous apportez aux fichiers épinglés pendant que vous êtes hors ligne est marquée comme « sale » dans le système, ce qui indique 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 revenez en ligne.

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 l’emporte comme source de vérité.

## Hiérarchie d’épinglage

ShadeFS gère l’épinglage avec 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 dossiers spécifiques au sein d’un dossier parent non épinglé

## Utilisation flexible

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

* Vous pouvez épingler des fichiers sans monter d’abord le lecteur
* Il n’y a aucune 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é

{% hint style="info" %}
Les fichiers épinglés enregistreront tous les fichiers que vous épinglez en mode entièrement hors ligne, en contournant 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 d’épingler **davantage que ce qu’il vous reste de disponible sur votre disque 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 »

Pour afficher tous les fichiers ou dossiers épinglés, vous pouvez accéder à la **Éléments épinglés** page, que vous pouvez consulter 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.
