¿Cómo agrego un submódulo a un subdirectorio?

Tengo un repositorio de git ~/.janus/con un montón de submódulos. Quiero agregar un submódulo ~/.janus/snipmate-snippets/snippets/, pero cuando ejecuto git submodule add <[email protected]:...>en el snipmate-snippetsdirectorio, aparece el siguiente mensaje de error:

You need to run this command from the toplevel of the working tree.

Entonces la pregunta es: ¿Cómo agrego un submódulo al snipmate-snippetsdirectorio?

Entras ~/.janusy corres:

git submodule add <git@github ...> snipmate-snippets/snippets/

Si necesita más información sobre submódulos (o git en general) ProGit es bastante útil.

Tenga en cuenta que a partir de git1.8.4 (julio de 2013), ya no tendrá que volver al directorio raíz.

 cd ~/.janus/snipmate-snippets
 git submodule add <git@github ...> snippets

( Bouke Versteegh comenta que no tiene que usar /., como en snippets/.: snippetses suficiente)

Ver commit 091a6eb0feed820a43663ca63dc2bc0bb247bbae :

submódulo: elimine el requisito de nivel superior

Use la nueva rev-parse --prefixopción para procesar todas las rutas dadas al comando del submódulo, eliminando el requisito de que se ejecute desde el nivel superior del repositorio.

Dado que la interpretación de una URL de submódulo relativa depende de si " remote.origin.url" está configurado o no , bloquee explícitamente las URL relativas en " git submodule add" cuando no esté en el nivel superior del árbol de trabajo.

Firmado por: John Keeping

Depende de commit 12b9d32790b40bf3ea49134095619700191abf1f

Esto hace que ' git rev-parse' se comporte como si fuera invocado desde el subdirectorio especificado de un repositorio, con la diferencia de que cualquier ruta de archivo que imprima tiene el prefijo de la ruta completa desde la parte superior del árbol de trabajo .

Esto es útil para los scripts de shell donde podemos querer llegar a cdla parte superior del árbol de trabajo pero necesitamos manejar rutas relativas dadas por el usuario en la línea de comando.

Tuve un problema similar, pero me pinté en una esquina con herramientas GUI.

Tenía un subproyecto con algunos archivos que hasta ahora había copiado en lugar de registrarme en su propio repositorio de git. Creé un repositorio en la subcarpeta, pude confirmar, enviar, etc. bien. Pero en el repositorio principal, la subcarpeta no se trataba como un submódulo, y el repositorio principal seguía rastreando sus archivos, lo cual no era bueno.

Para salir de este lío, tuve que decirle a Git que dejara de rastrear la subcarpeta (sin eliminar los archivos):

proj> git rm -r --cached ./ui/jslib

Luego tuve que decirle que había un submódulo allí (que no puede hacer si hay algo que actualmente está siendo rastreado por git):

proj> git submodule add ./ui/jslib

Actualizar

La forma ideal de manejar esto implica un par de pasos más. Idealmente, el repositorio existente se mueve a su propio directorio, libre de cualquier módulo git principal, se confirma y empuja, y luego se agrega como un submódulo como:

proj> git submodule add [email protected]:user/jslib.git ui/jslib

Eso clonará el repositorio de git como un submódulo, que implica los pasos de clonación estándar, pero también varios otros pasos de configuración más oscuros que git toma en su nombre para que ese submódulo funcione. La diferencia más importante es que coloca un archivo .git simple allí, en lugar de un directorio .git, que contiene una referencia de ruta a donde vive el directorio git real, generalmente en la raíz principal del proyecto .git / modules / jslib.

Si no haces las cosas de esta manera, funcionarán bien para ti, pero tan pronto como te comprometes y presionas al padre, y otro desarrollador va a tirar de ese padre, simplemente les harás la vida mucho más difícil. Será muy difícil para ellos replicar la estructura que tiene en su máquina siempre que tenga un directorio .git completo en una subcarpeta de un directorio que contenga su propio directorio .git.

Entonces, mover, empujar, git agregar submódulo, es la opción más limpia.

Para aquellos de ustedes que comparten mi extraño gusto por editar manualmente los archivos de configuración, agregar (o modificar) lo siguiente también sería el truco.

.git / config (configuración personal)

[submodule "cookbooks/apt"]
    url = https://github.com/opscode-cookbooks/apt

.gitmodules (configuración compartida comprometida)

[submodule "cookbooks/apt"]
    path = cookbooks/apt
    url = https://github.com/opscode-cookbooks/apt

Vea esto también: ¿ diferencia entre .gitmodules y especificación de submódulos en .git / config?

guión bash de una línea para ayudar a facilitar la respuesta de Chris anterior, ya que también me había pintado en una esquina usando las actualizaciones de Vundle para mis guiones .vim. DESTes la ruta al directorio que contiene sus submódulos. Haz esto después de hacergit rm -r $DEST

DEST='path'; for file in `ls ${DEST}`; do git submodule add `grep url ${DEST}/${file}/.git/config|awk -F= '{print $2}'` ${DEST}/${file}; done

salud