クイックスタート

このページでは、何もない状態から、パソコンに保存され Zaryn で共有されたプロジェクトまでを進めます。git などのバージョン管理ツールを知らなくても大丈夫です。各ステップで、コマンドが何をするのか、なぜ必要なのかを説明します。 > **バージョン管理とは?** プロジェクトの保存した各バージョンを覚えておくツールです。何が変わったかを確認したり、古いバージョンに戻したり、何も壊さずに別のアイデアを試したり、他の人と同じファイルで作業したりできます。zev がバージョン管理ツールで、Zaryn はプロジェクトをオンラインで置いておくウェブサイトです。 ## 1. zev をインストールする **Linux / macOS** ではターミナルを開いて実行します: ```bash curl -fsSL https://zaryn.xyz/install.sh | sh ``` **Windows** では PowerShell を開いて実行します: ```powershell irm https://zaryn.xyz/install.ps1 | iex ``` 動作を確認します: ```bash zev --version ``` `zev 0.3.0 (x86_64-linux)` のように表示されれば成功です。apt、dnf、pacman などの方法は [インストール](/docs/ja/installation) にあります。 ## 2. プロジェクトを作る プロジェクトのフォルダーに移動し(または新しく作り)、zev のリポジトリにします: ```bash mkdir my-project cd my-project zev init ``` `zev init` は `.zev` という隠しフォルダーを作り、そこに履歴を保存します。あなたのファイルはそのままです。 自分が誰かを zev に伝えます。名前は作成するすべてのコミットに記録されます: ```bash zev config set user.name "あなたの名前" zev config set user.email "you@example.com" ``` ## 3. 最初のバージョンを保存する ファイルを作るか、既存のファイルを使います: ```bash echo "# 私のプロジェクト" > README.md ``` 保存は2ステップです: ```bash zev add . zev commit -m "最初のバージョン" ``` - `zev add .` は、次の保存に**何を**含めるかを選びます。`.` は「このフォルダーのすべて」という意味です。これを*ステージング*と呼びます。 - `zev commit -m "..."` は、ステージしたものを短いメッセージと一緒に**保存**します。一つ一つの保存を*コミット*と呼びます。 なぜ2ステップなのか? 多くのファイルを変更しても、その一部だけをまとめて保存したいことがよくあるからです。`zev add` で選べます。 ## 4. 変更して差分を見る `README.md` を編集して、何が変わったかを zev に聞きます: ```bash zev status ``` `zev status` は、変更したファイル、ステージしたファイル、zev がまだ追跡していない新しいファイルを一覧にします。各セクションには次に実行するコマンドも表示されます。 変わった行を正確に見るには: ```bash zev diff ``` `+` で始まる行は追加、`-` で始まる行は削除です。よければもう一度保存します: ```bash zev add README.md zev commit -m "プロジェクトの説明" ``` これまでの保存の一覧: ```bash zev log --oneline ``` ## 5. Zaryn で共有する ターミナルからアカウントを作ります。メールアドレスの確認のため、zev が6桁のコードを送ります: ```bash zev login zaryn.xyz --register your-username --email you@example.com ``` 求められたらコードを入力します。ログインはパソコンごとに一度だけで、そのパソコンのすべてのプロジェクトで使われます。 すでに [zaryn.xyz](https://zaryn.xyz) のウェブサイトでアカウントを作っている場合は、ブラウザーでログインします: ```bash zev login zaryn.xyz --device ``` zev がリンクと短いコードを表示します。リンクを開き、コードが一致するのを確かめて承認します。 では Zaryn にプロジェクトを作り、コミットを送ります: ```bash zev new zev push ``` `zev new` は名前、プロジェクトの種類、公開か非公開か、ライセンスを尋ねます。Zaryn にリポジトリを作り、送信先の既定として `origin` という名前で覚えます。`zev push` がコミットを送ります。`https://zaryn.xyz/your-username/the-name` を開いて確認しましょう。 ## 毎日の流れ ほとんどの日は、この5つのコマンドだけで足ります: ```bash zev status # 何が変わった? zev diff # どう変わった? zev add . # 保存するものを選ぶ zev commit -m "やったこと" # 保存する zev push # 共有する ``` 他の人と作業するときは、まず `zev pull` で最新の変更を取り込みます。 ## 次に読むもの - [はじめてのリポジトリ、一歩ずつ](/docs/ja/first-repository): 同じ考え方をより詳しく。失敗の取り消し方も。 - [どうすれば…?](/docs/ja/how-do-i): よくある作業の短い答え(「変更を取り消す」「ファイルを削除する」「ブランチで作業する」)。 - [すべてのコマンド](/docs/ja/commands): zev の全コマンド。毎日使うものが先頭です。 - 困ったら、ドキュメントのどのページでも `/` を押して検索できます。