---
title: "Pliki, foldery Kalka i wersje | Kalka docs"
description: "Typy plików, które zapisuje Kalka, zawartość folderu Kalka, działanie automatycznego zapisu i odzyskiwania po awarii oraz przechowywanie wersji projektu w Gicie."
url: https://kalka.design/pl/docs/files-versions
language: pl
---

Twoje projekty to pliki na twoim komputerze. Kalka nigdy nie potrzebuje konta ani serwera, żeby je zapisać.

## Trzy sposoby zapisania dokumentu

| Format | Co to jest | Do czego się nadaje |
| --- | --- | --- |
| Folder Kalka | Folder ze stronami HTML, jednym arkuszem stylów, tokenami projektowymi i obrazami | Praca z programistami i agentami, przechowywanie wersji w Gicie |
| .kalka | Ten sam folder spakowany do jednego pliku | Wysyłanie projektu jako pojedynczego pliku |
| .fig | Format plików Figmy | Przechodzenie tam i z powrotem między Kalką a Figmą |

**Zapisz** (Cmd S na macOS, Ctrl S na Windowsie i Linuksie) zapisuje do otwartego pliku. **Zapisz jako…** wybiera nowy plik, `.fig` lub `.kalka`. **Zapisz jako folder…** w aplikacji na komputer pyta o nazwę i miejsce, a potem tworzy tam nowy folder Kalka.

Kalka odmawia zapisu do folderu, w którym są już inne pliki, na przykład projekt strony internetowej albo Pobrane, żeby nigdy nie mieszać swoich plików z twoimi. Pusty folder lub istniejący folder Kalka są w porządku.

## Co jest w folderze 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
```

_Panel Folder z zawartością folderu Kalka: design-system, instructions, pages, project.json i styles.css_

Panel Folder pokazuje pliki, które Kalka zapisuje dla dokumentu.
Każda strona to zwykły plik HTML, który otworzysz w edytorze kodu lub przeglądarce. Programista może go przeczytać, przejrzeć w Gicie i wziąć to, czego potrzebuje. Folder `instructions/` przechowuje to, co mówisz agentom o tym projekcie: podsumowanie, zasady, twoje własne umiejętności i dokumenty referencyjne. Zobacz [Agenci w Kalce](https://kalka.design/pl/docs/agents).

## Bezpieczny zapis

Kalka zapisuje nowy plik obok starego i podmienia go dopiero wtedy, gdy jest kompletny. Awaria, pełny dysk lub nieudany zapis zostawiają twój plik bez zmian. Folder Kalka zapisuje się tak samo: każdy plik najpierw powstaje obok, więc folder zawsze zawiera albo poprzedni zapis, albo nowy, nigdy mieszankę. Przerwany zapis zostaje dokończony przy następnym otwarciu folderu.

## Automatyczny zapis

Dla nowego dokumentu automatyczny zapis jest wyłączony. Włącz go poleceniem **Automatyczny zapis do pliku** w menu Plik: Kalka będzie wtedy zapisywać kilka sekund po tym, jak przestaniesz edytować. Potrzebuje pliku, do którego może zapisywać, więc najpierw zapisz dokument raz. Dokumenty otwarte z obszaru przechowywania w chmurze zapisują się automatycznie same.

W Chrome i Edge przeglądarka prosi o zgodę na zapis pliku, gdy włączasz automatyczny zapis. Jeśli automatyczny zapis się nie uda, Kalka powie ci o tym raz i zachowa twoje zmiany na potrzeby odzyskiwania po awarii, dopóki zapis znów nie zadziała.

## Odzyskiwanie po awarii

Podczas pracy Kalka trzyma na twoim komputerze kopię niezapisanych zmian. Jeśli Kalka lub komputer zatrzyma się przed zapisem, przy następnym uruchomieniu pojawi się **Odzyskaj niezapisaną pracę**: **Przywróć** przywraca dokumenty powiązane z plikami, z których pochodzą, więc następny zapis trafi do nich. **Odrzuć** je usuwa.

Możesz to wyłączyć w Ustawieniach opcją **Automatycznie zachowuj niezapisaną pracę**.

## Gdy inna aplikacja zmieni twój plik

Git, narzędzie do synchronizacji albo inny edytor może zmienić plik, który masz otwarty. Jeśli nie masz niezapisanych zmian, Kalka wczyta go ponownie. Jeśli masz, Kalka je zachowa i powie ci, że plik się zmienił; wybierz **Reload from disk**, żeby wziąć drugą wersję, albo zapisz, żeby zastąpić ją swoją.

## Wersje w Gicie

Panel **Historia** na lewej szynie przechowuje wersje dokumentu w Gicie. Działa w aplikacji na komputer, dla dokumentu zapisanego na twoim komputerze, i korzysta z zainstalowanego tam `git`.

- Otwórz **Historia**. Jeśli folder nie przechowuje jeszcze wersji, kliknij **Zachowuj wersje**. Kalka utworzy repozytorium Git w folderze dokumentu.

- Opisz zmiany w polu **Co się zmieniło** i kliknij **Utwórz wersję**. Kalka najpierw zapisze dokument; jeśli zapis się nie uda, nic nie zostanie zarejestrowane.

- Żeby wrócić, kliknij **Przywróć** obok wersji. Kalka najpierw zarejestruje bieżący stan, więc samo przywrócenie też da się cofnąć, a potem wczyta dokument ponownie.

Dla folderu Kalka wersja obejmuje cały folder. Dla pliku `.fig` lub `.kalka` obejmuje tylko ten plik: inne pliki obok niego nigdy nie są rejestrowane ani przywracane.

Za pierwszym razem Kalka może zapytać o twoje imię i adres e-mail. Są zapisywane tylko w tym repozytorium.

### Publikowanie wersji online

Żeby trzymać wersje na GitHubie lub w innym serwisie Git, utwórz tam puste repozytorium, wklej jego adres w sekcji **Opublikuj online** i kliknij **Połącz**. Kalka używa logowania do Gita, które masz już na komputerze. Od tej chwili każda zarejestrowana wersja jest publikowana. **Pobierz zmiany** ściąga wersje opublikowane gdzie indziej, a **Opublikuj** wysyła twoje, jeśli jakieś zostały zarejestrowane offline.

Gdy zmiany wprowadził agent, wersja mówi który, na przykład Pebble.
