---
title: "Fichiers, dossiers Kalka et versions | Kalka docs"
description: "Les types de fichiers qu’enregistre Kalka, ce que contient un dossier Kalka, comment fonctionnent l’enregistrement automatique et la récupération après plantage, et comment garder des versions d’un design avec Git."
url: https://kalka.design/fr/docs/files-versions
language: fr
---

Vos designs sont des fichiers sur votre ordinateur. Kalka n’a jamais besoin d’un compte ni d’un serveur pour les enregistrer.

## Trois façons d’enregistrer un document

| Format | Ce que c’est | Idéal pour |
| --- | --- | --- |
| Dossier Kalka | Un dossier de pages HTML, une feuille de style, des design tokens et des images | Travailler avec des développeurs et des agents, garder des versions dans Git |
| .kalka | Le même dossier réuni en un seul fichier | Envoyer un design en un seul fichier |
| .fig | Le format de fichier de Figma | Faire des allers-retours avec Figma |

**Enregistrer** (Cmd S sur macOS, Ctrl S sur Windows et Linux) écrit dans le fichier que vous avez ouvert. **Enregistrer sous…** choisit un nouveau fichier, en `.fig` ou en `.kalka`. **Enregistrer comme dossier…**, dans l’app desktop, demande un nom et un emplacement et y crée un nouveau dossier Kalka.

Kalka refuse d’enregistrer dans un dossier qui contient déjà d’autres fichiers, comme un projet de site web ou Téléchargements, pour ne jamais mélanger ses fichiers avec les vôtres. Un dossier vide ou un dossier Kalka existant convient.

## Ce que contient un dossier Kalka

```
my-design/
  project.json          pages, artboard positions, settings, variables
  pages/
    home.html           one HTML file per page
    pricing.html
  styles.css            the classes your layers share
  design-system/
    tokens.json         your variables as W3C design tokens
    tokens.css          the same tokens as CSS custom properties
  assets/
    images/             every image, named by its content
  instructions/         optional rules, skills and documents for agents
```

_Le panneau Dossier qui liste un dossier Kalka : design-system, instructions, pages, project.json et styles.css_

Le panneau Dossier montre les fichiers que Kalka écrit pour le document.
Chaque page est un simple fichier HTML que vous pouvez ouvrir dans un éditeur de code ou un navigateur. Un développeur peut le lire, le relire dans Git et prendre ce dont il a besoin. Le dossier `instructions/` contient ce que vous dites aux agents sur ce projet : un résumé, des règles, vos propres skills et des documents de référence. Voir [Les agents dans Kalka](https://kalka.design/fr/docs/agents).

## Enregistrer sans risque

Kalka écrit un nouveau fichier à côté de l’ancien et ne le met à sa place qu’une fois complet. Un plantage, un disque plein ou une écriture ratée laissent votre fichier tel qu’il était. Un dossier Kalka est enregistré de la même façon : chaque fichier est d’abord écrit à part, donc le dossier correspond toujours soit au dernier enregistrement, soit au nouveau, jamais à un mélange. Un enregistrement interrompu est terminé à la prochaine ouverture du dossier.

## Enregistrement automatique

L’enregistrement automatique est désactivé pour un nouveau document. Activez-le avec **Enregistrement automatique** dans le menu Fichier : Kalka enregistre alors quelques secondes après que vous avez arrêté de modifier. Il lui faut un fichier où écrire, donc enregistrez le document une première fois. Les documents ouverts depuis un espace de stockage cloud s’enregistrent automatiquement d’eux-mêmes.

Dans Chrome et Edge, le navigateur demande l’autorisation d’écrire le fichier quand vous activez l’enregistrement automatique. Si un enregistrement automatique échoue, Kalka vous prévient une fois, et garde vos modifications pour la récupération après plantage jusqu’à ce qu’un enregistrement réussisse à nouveau.

## Récupération après plantage

Pendant que vous travaillez, Kalka garde une copie des modifications non enregistrées sur votre ordinateur. Si Kalka ou votre ordinateur s’arrête avant que vous ayez enregistré, le lancement suivant affiche **Récupérer le travail non enregistré** : **Restaurer** fait revenir les documents, reliés aux fichiers d’où ils venaient, pour que le prochain enregistrement y écrive. **Supprimer** les abandonne.

Vous pouvez désactiver ce comportement dans les Paramètres avec **Conserver automatiquement le travail non enregistré**.

## Quand une autre app modifie votre fichier

Git, un outil de synchronisation ou un autre éditeur peut modifier un fichier que vous avez ouvert. Sans modifications non enregistrées, Kalka le recharge. Avec des modifications non enregistrées, Kalka les garde et vous signale que le fichier a changé ; choisissez **Recharger depuis le disque** pour prendre l’autre version, ou enregistrez pour la remplacer par la vôtre.

## Versions avec Git

Le panneau **Historique**, dans le rail de gauche, garde des versions d’un document avec Git. Il fonctionne dans l’app desktop, pour un document enregistré sur votre ordinateur, et utilise le `git` déjà installé.

- Ouvrez **Historique**. Si le dossier ne garde pas encore de versions, cliquez sur **Garder les versions**. Kalka crée un dépôt Git dans le dossier du document.

- Décrivez ce qui a changé sous **Ce qui a changé** et cliquez sur **Créer la version**. Kalka enregistre d’abord le document ; si l’enregistrement échoue, rien n’est enregistré dans l’historique.

- Pour revenir en arrière, cliquez sur **Restaurer** à côté d’une version. Kalka note d’abord où vous en étiez, pour que la restauration puisse elle-même être annulée, puis recharge le document.

Pour un dossier Kalka, une version enregistre tout le dossier. Pour un fichier `.fig` ou `.kalka`, elle n’enregistre que ce fichier : les autres fichiers à côté ne sont jamais enregistrés ni restaurés.

La première fois, Kalka peut vous demander votre nom et votre adresse e-mail. Ils ne sont stockés que dans ce dépôt.

### Publier les versions en ligne

Pour garder vos versions sur GitHub ou un autre hébergeur Git, créez-y un dépôt vide, collez son adresse sous **Publier en ligne** et cliquez sur **Connecter**. Kalka utilise la connexion Git déjà configurée sur votre ordinateur. Ensuite, chaque version que vous créez est publiée. **Récupérer** fait venir les versions publiées depuis ailleurs, et **Publier** envoie les vôtres si vous en avez créé hors ligne.

Quand c’est un agent qui a fait les modifications, la version indique lequel, par exemple Pebble.
