Kalka
ドキュメント

ファイル、Kalka フォルダ、バージョン

Kalka が保存するファイル形式、Kalka フォルダの中身、自動保存とクラッシュからの復元の仕組み、Git でデザインのバージョンを残す方法。

docs / files-versions

デザインはあなたのコンピューター上のファイルです。保存するのに、Kalka がアカウントやサーバーを必要とすることはありません。

ドキュメントの 3 つの保存方法

形式 中身 向いている用途
Kalka フォルダ HTML ページ、1 つのスタイルシート、デザイントークン、画像が入ったフォルダ 開発者やエージェントとの作業、Git でのバージョン管理
.kalka 同じフォルダを 1 つのファイルにまとめたもの デザインを 1 ファイルで送る
.fig Figma のファイル形式 Figma との行き来

保存(macOS は Cmd S、Windows と Linux は Ctrl S)は、開いたファイルに書き込みます。名前を付けて保存… は、.fig または .kalka として新しいファイルを選びます。デスクトップアプリの フォルダとして保存… は、名前と場所を尋ねて、そこに新しい Kalka フォルダを作ります。

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
Kalka フォルダの中身を表示したフォルダパネル。design-system、instructions、pages、project.json、styles.css
フォルダパネルには、Kalka がドキュメントのために書き出すファイルが表示されます。

各ページは、コードエディタやブラウザで開ける普通の HTML ファイルです。開発者はそれを読み、Git でレビューし、必要なものを取り出せます。instructions/ フォルダには、このプロジェクトについてエージェントに伝えることを入れます。概要、ルール、自分のスキル、参考ドキュメントです。Kalka のエージェントを参照してください。

安全な保存

Kalka は古いファイルの隣に新しいファイルを書き、書き終わってから入れ替えます。クラッシュ、ディスクの容量不足、書き込みの失敗があっても、ファイルは元のままです。Kalka フォルダも同じ方法で保存します。すべてのファイルをまず別の場所に書くので、フォルダは常に前回の保存か新しい保存のどちらかで、混ざることはありません。途中で止まった保存は、次にフォルダを開いたときに完了します。

自動保存

新しいドキュメントでは自動保存はオフです。ファイルメニューの ファイルに自動保存 でオンにすると、編集の手を止めて数秒後に Kalka が保存します。書き込み先のファイルが必要なので、先に一度ドキュメントを保存してください。クラウドストレージのワークスペースから開いたドキュメントは、自動で保存されます。

Chrome と Edge では、自動保存をオンにするとブラウザがファイルへの書き込み許可を求めます。自動保存に失敗すると Kalka が一度だけ知らせ、保存が再び成功するまで、変更をクラッシュからの復元用に保持します。

クラッシュからの復元

作業中、Kalka は未保存の変更のコピーをコンピューターに保存しています。保存前に Kalka やコンピューターが止まると、次の起動時に 未保存の作業を復元 が表示されます。復元 でドキュメントが元のファイルとひも付いた状態で戻り、次の保存はそのファイルに書き込まれます。破棄 で捨てます。

この機能は、設定の 未保存の作業を自動的に保持 でオフにできます。

ほかのアプリがファイルを変更したとき

Git、同期ツール、別のエディタが、開いているファイルを変更することがあります。未保存の編集がなければ、Kalka はファイルを読み込み直します。未保存の編集がある場合は、それを残したままファイルが変更されたことを知らせます。Reload from disk でもう一方のバージョンを取り込むか、保存してあなたのバージョンで置き換えてください。

Git でのバージョン管理

左側のレールにある 履歴 パネルは、Git でドキュメントのバージョンを残します。デスクトップアプリで、コンピューターに保存したドキュメントに対して使え、すでにインストールされている git を使います。

  1. 履歴 を開きます。フォルダでまだバージョンを残していなければ、バージョンを残す をクリックします。Kalka がドキュメントのフォルダに Git リポジトリを作ります。
  2. 変更内容 に変えたことを書き、バージョンを作成 をクリックします。Kalka はまずドキュメントを保存し、保存に失敗した場合は何も記録しません。
  3. 前の状態に戻るには、バージョンの横の 復元 をクリックします。Kalka はまず現在の状態を記録するので、復元自体も取り消せます。そのあとドキュメントを読み込み直します。

Kalka フォルダでは、バージョンはフォルダ全体を記録します。.fig や .kalka ファイルでは、そのファイルだけを記録し、隣にあるほかのファイルが記録や復元の対象になることはありません。

初回は、名前とメールアドレスを尋ねられることがあります。これはそのリポジトリにだけ保存されます。

バージョンをオンラインで公開する

GitHub などの Git ホスティングにバージョンを残すには、そこで空のリポジトリを作り、そのアドレスを オンラインで公開 に貼り付けて 接続 をクリックします。Kalka はコンピューターにすでにある Git のサインイン情報を使います。それ以降、記録したバージョンはすべて公開されます。更新を取得 はほかの場所から公開されたバージョンを取り込み、公開 はオフラインで記録したバージョンを送ります。

変更をエージェントが行った場合、バージョンには Pebble のように、どのエージェントかが記されます。