はじめに

リポジトリが分かれている場合、それをまとめるリポジトリがあると便利です。

事前に

追加したいサブモジュールが空の場合にはエラーとなるので、対象のリポジトリをクローンして何かコミットしておくと良いです。

$ touch README.md
$ git add README.md; git commit -m 'first commit'; git push origin HEAD

サブモジュールの追加は git submodule add で行ないます。

$ git submodule add git@github.com:yousan/example.git example

うまく行かない場合がありますが、その場合には手動で確認を行ないます。

サブモジュールは３つのファイルによって構成されているようです。

サブモジュールに関する記述があります。

.gitmodule

[submodule "example"]
        path = example
        url = git@github.com:yousan/example.git

.git/config

[submodule "example"]
        url = git@github.com:yousan/example.git
        active = true

サブモジュールのディレクトリには .git ディレクトリではなくファイルが置いてあります。

example/.git

gitdir: example

上記の3ファイルが揃っていればSourceTreeなどでSubmoduleとして認識されます。うまく認識されない場合には上記のファイルを確認することとなります。