ここで使う言葉

spicemine は、コードをバージョン管理する人と、それ以外のすべて（下書き、レイヤー、テイク、マスター）をバージョン管理する人の両方のためのものです。この2つのグループは語彙を共有していません。そのため、ページ上の用語には (i) が付いています。ホバーするか、タップすると説明が開きます。ここではその全てを一覧できます。

エンジンの解説

リポジトリ

1つのプロジェクトとその全履歴です。すべてのファイルのすべてのバージョンと、誰が何をなぜ変更したかが含まれます。最新のファイルを集めたフォルダとは違います。フォルダは「今」だけを覚えています。リポジトリは編集前の原稿も、トリミング前の写真も覚えていて、どちらの時点にも戻れます。

コミット

リポジトリの履歴に保存された1つの時点で、何を変更したかのメモが付きます。Fossil では「チェックイン」と呼びます。ファイルの保存とは違います。保存は頻繁に行い、コミットは「あとで戻ってきたい状態」に達したときに行います。

クローン

ここからあなたのマシンへ取得する、リポジトリの完全な複製です。履歴もすべて含まれます。ここで扱うエンジンはすべて分散型です。つまり、あなたのクローンは当サーバーの一部ではなく、それ自体が完全なリポジトリであり、このサーバーが止まっても使えます。

プッシュ

あなたのクローンのコミットをここへ送り返し、他の人や次に使うマシンから見えるようにすることです。push にはトークンが必要で、ブラウザのセッションは使えません。両者を分けているため、Cookie が盗まれても誰の作業も変更できません。

ブランチ

本流から分かれ、あとで再び合流することもある履歴の流れです。同じものの2つのバージョンを、どちらも失わずに同時に存在させる仕組みです。試している編集版と、合意済みの版が、どちらも実在し、どちらも保たれます。

タイムライン

リポジトリのページに表示される最近のコミットの一覧です。日時、作者、内容、そしてそれぞれのリビジョンが並びます。そのリポジトリが生きているか、何をしてきたかを最も早く知る方法です。

リビジョン

ある1つのコミットを正確に指す名前です。英数字の長い文字列で、画面では短縮して表示します。内容そのものから導かれるため、あとから付け替えることはできません。リビジョンを引用すれば、リポジトリが存在する限り、作業の状態を一意に指し示せます。

スペース

リポジトリが置かれる場所であり、誰が触れられるかを決める単位です。登録した時点で、自分の名前のスペースが1つ与えられます。もう一種類は個人ではなくグループに属し、メンバーを持ち、特定の人の関与より長く続きます。両者は同じ構造なので、個人のプロジェクトはメンバーを追加するだけでチームのプロジェクトになります。移動は不要です。

メンバー

スペースに追加された人で、3つの役割のどれかを持ちます。メンバーは、スペース内の非公開でないリポジトリ（メンバー限定を含む）をすべて読めます。書き込み権限者はさらにプッシュし、リポジトリを作り、非公開のリポジトリにも書き込めます。管理者はさらに人の追加と削除、リポジトリの公開範囲の変更ができます。誰もが自分の名前のスペースの管理者です。

公開範囲

そのリポジトリを誰が見られるかです。非公開：スペースの書き込み権限者と管理者のみ。メンバー限定：誰でもスペースの一覧で見つけ、ショーケース（タイトル、説明、公開のジャーナル投稿）を読めますが、ファイル、履歴、クローンのアドレスはスペースのメンバー向けです。公開：誰でも、すべてを。新しいリポジトリは非公開です。未発表の作業を預かる場所が、何かを偶然に流出させる場所であってはならないからです。見る権限のないものは、グレー表示や拒否ではなく、そもそも一覧に出ません。

ショーケース

リポジトリの表紙です。ファイルから取り出すのではなく、書き込み権限者が書いた、プロジェクト自身の言葉：タイトル、署名、1〜2行の説明、画像、ジャーナル。リポジトリを見られる人は誰でも見られます。メンバー限定のリポジトリでは、スペースの外の人に見えるのはこれだけです。

エンジン

リポジトリを実際に保管するバージョン管理システムのことです。fossil、git、hg、jj、lore のいずれかです。spicemine はそれらを置き換えるのではなくホストします。そのため、手元のツールは本物のエンジンと対話し、ここで独自の方言を覚える必要はありません。

セッション

このブラウザをこれらのページにサインインさせているものです。ページのスクリプトからは読めない Cookie に保持されます。30日間使われなければ失効します。設定ページに、所属するデバイスとともに一覧表示され、現在のものも含めてそこから終了できます。セッションはアカウントの閲覧と変更はできますが、push は決してできません。

トークン

コマンドライン、エディタ、スマートフォンアプリといったプログラムを、API と HTTPS 経由の clone / push に認証させる長い秘密の文字列です。保持するデバイスごとに名前を付けるため、ノートPCを紛失したときは、その1つだけを失効させれば済みます。トークンは一度だけ表示されます。ここにはハッシュのみが保存されるためです。

スコープ

トークンを作るときに書き込まれる、そのトークンの届く範囲です。1つのリポジトリ（repo:space/name）または1つのスペース全体（space:name）に、動詞 read か write を添えます。write は read を含みます。push できるトークンは clone もできるので、場所ごとに1つのスコープで足ります。スコープ付きトークンができるのは clone と push だけで、リポジトリの作成や削除はできず、あなた自身のアカウントの権限を超えることもありません。スコープのないトークンはアカウント全体であり、それは明示的に求めたときだけ作られます。

SSH 鍵

あなたのマシンが保持する鍵ペアのうち、公開鍵の側をここに保存できます。spicemine は受け付け、検証し、一覧表示しますが、まだ何にも使っていません。現在は HTTPS のみに対応しています。鍵を預かって黙って無視するのではなく、そう明記しています。

招待

1名が1回だけアカウントを作成できる、7日間有効なリンクです。このインスタンスはメールを送信しないため、管理者がリンクを発行し、すでに信頼している手段で相手に渡します。リンクは一度だけ表示され、その後はハッシュのみが保存されます。

README

リポジトリのページがトップとして表示するファイルです。既定ブランチの最上位にあれば表示されます。前提知識なしに訪れた人のために書いてください。これは何か、誰のためのものか、まず何をすればよいか。

このページの日本語は機械による下訳で、ネイティブによるレビューを待っています。読みにくい部分があれば、それはこの翻訳の問題です。