|
| 1 | +git-init(1) |
| 2 | +=========== |
| 3 | + |
| 4 | +NOMBRE |
| 5 | +------ |
| 6 | +git-init - Crear un repositorio de Git vacío o reinicializar uno ya existente |
| 7 | + |
| 8 | + |
| 9 | +SINOPSIS |
| 10 | +-------- |
| 11 | +[synopsis] |
| 12 | +git init [-q | --quiet] [--bare] [--template=<template-directory>] |
| 13 | + [--separate-git-dir <git-dir>] [--object-format=<format>] |
| 14 | + [--ref-format=<format>] |
| 15 | + [-b <branch-name> | --initial-branch=<branch-name>] |
| 16 | + [--shared[=<permissions>]] [<directory>] |
| 17 | + |
| 18 | + |
| 19 | +DESCRIPCIÓN |
| 20 | +----------- |
| 21 | + |
| 22 | +Este comando crea un repositorio Git vacío. Básicamente un directorio `.git` con subdirectorios para `objects`, `reas/heads`, `reos/tags`, y ficheros de plantillas. Se creará una rama inicial sin confirmaciones (ver la opción `--initial-branch` abajo por su nombre). |
| 23 | + |
| 24 | +If the `GIT_DIR` environment variable is set then it specifies a path to use instead of `./.git` for the base of the repository. |
| 25 | + |
| 26 | +If the object storage directory is specified via the `GIT_OBJECT_DIRECTORY` environment variable then the sha1 directories are created underneath; otherwise, the default `$GIT_DIR/objects` directory is used. |
| 27 | + |
| 28 | +Ejecutar `git init` en un repositorio existente es seguro. No sobre-escribirá cosas que ya existan ahí. La razón primaria para volver a ejecutar `git init` es para recoger plantillas agregadas recientemente (o para mover el repositorio a otro lugar si se proporciona `--separate-git-dir`). |
| 29 | + |
| 30 | +OPCIONES |
| 31 | +-------- |
| 32 | + |
| 33 | +`-q`:: |
| 34 | +`--quiet`:: |
| 35 | + |
| 36 | +Mostrar sólo los mensajes de error y advertencia; el resto de mensajes se suprimirán. |
| 37 | + |
| 38 | +`--bare`:: |
| 39 | + |
| 40 | +Crea un repositorio básico. Si la variable de ambiente `GIT_DIR` no está configurada, se configura al directorio de trabajo actual. |
| 41 | + |
| 42 | +`--object-format=<format>`:: |
| 43 | +Especifica el _<formato>_ de objeto (algoritmo hash )dado para el repositorio. Los valores válidos son `sha1` y -si esta habilitado- `sha256`. `sha1` es el predeterminado. |
| 44 | ++ |
| 45 | +Nota: En el presente, no hay interoperabilidad entre repositorios SHA-256 y SHA-1. |
| 46 | + |
| 47 | +Históricamente, hemos advertido que repositorios SHA-256 puedan necesitar después cambios incompatibles hacia atrás cuando introduzcamos tales características de interoperabilidad. Hoy, sólo esperamos cambios compatibles. Además, si tales cambios prueban ser necesarios, se puede esperar que repositorios SHA-256 creados con el Git de hoy sean usables por versiones futuras de Git sin pérdida de datos. |
| 48 | +[] |
| 49 | + |
| 50 | +`--ref-format=<format>`:: |
| 51 | +Especifica el _<formato>_ de almacenamiento de referencia dado para el repositorio. Los valores válidos son: |
| 52 | ++ |
| 53 | + |
| 54 | + |
| 55 | +[WARNING] |
| 56 | +==== |
| 57 | +Missing `es/ref-storage-format.txt` |
| 58 | + |
| 59 | +See original version for this content. |
| 60 | +==== |
| 61 | + |
| 62 | +[] |
| 63 | + |
| 64 | +`--template=<template-directory>`:: |
| 65 | +Especifica el directorio de dónde usar plantillas. (Ver la sección "DIRECTORIO DE PLANTILLAS" mas adelante.) |
| 66 | + |
| 67 | +`--separate-git-dir=<git-dir>`:: |
| 68 | +En lugar de inicializar el repositorio como un directorio ya sea de `$GIT_DIR` o `./.git`, crea un fichero de texto conteniendo la ruta al repositorio actual. Este fichero actúa como una liga simbólica de Git agnóstica de sistema de ficheros hacia el repositorio. |
| 69 | ++ |
| 70 | +Si es una re-inicialización, el repositorio se moverá a la ruta especificada. |
| 71 | + |
| 72 | +`-b <branch-name>`:: |
| 73 | +`--initial-branch=<branch-name>`:: |
| 74 | +Usar el _<nombre-de-rama>_ especificado para la rama inicial en el repositorio recientemente creado. Si no se especifica, recae en el nombre predeterminado (actualmente `master`, pero está sujeto a cambio en el futuro; el nombre puede ser personalizado con la variable de configuración `init.defaultBranch`). |
| 75 | + |
| 76 | +`--shared[=(false|true|umask|group|all|world|everybody|<perm>)]`:: |
| 77 | + |
| 78 | +Especifica que el repositorio Git será compartido entre varios usuarios. Esto permite a los usuarios pertenecientes al mismo grupo hacer push en ese repositorio. Cuando se especifica, la variable de configuración `core.sharedRepository` se asigna de tal manera que esos ficheros y directorios bajo `$GIT_DIR` son creados con los permisos solicitados. Cuando no se especifica, Git usará los permisos reportados por `umask`(2). |
| 79 | ++ |
| 80 | +La opción puede tomar los siguientes valores, predeterminando a `group` si no se da algún valor: |
| 81 | ++ |
| 82 | +-- |
| 83 | +`umask`:: |
| 84 | +`false`:: |
| 85 | + |
| 86 | +Use los permisos obtenidos con `umask`(2). El predeterminado, cuando no se indica `--shared`. |
| 87 | + |
| 88 | +`group`:: |
| 89 | +`true`:: |
| 90 | + |
| 91 | +Hace al repositorio escribible para el grupo, (y `g+sx`, ya que el grupo git podría no ser el grupo primario de todos los usuarios). Esto se usa para relajar los permisos de un valor -por el contrario- seguro de `umask`(2). Note que umask aún aplica a los otros bits de permisos (ej. si umask es `0022`, usando `group` no quitará privilegios de lectura de otros usuarios (no del grupo) ). Ver `0xxx` para cómo especificar exactamente los permisos del repositorio. |
| 92 | + |
| 93 | +`all`:: |
| 94 | +`world`:: |
| 95 | +`everybody`:: |
| 96 | + |
| 97 | +Igual que `group`, pero permite que cualquier usuario lea el repositorio. |
| 98 | + |
| 99 | +_<permisos>_:: |
| 100 | + |
| 101 | +`<permisos>` es un número octal de tres dígitos prefijado con `0` y cada fichero tendrá el modo `<permisos>`. `<permisos>` sobre-escribirá el valor `umask`(2) del usuario (y no solo permisos mas holgados como lo hacen `group` y `all`). `0640` creará un repositorio legible por el grupo, pero no escribible o accesible para otros. `0660` creará un repositorio que es legible y escribible por el usuario actual y grupo, pero inaccesible para otros (directorios y ficheros ejecutables obtienen su bit `x` del bit `r` para sus clases de usuarios correspondientes). |
| 102 | +-- |
| 103 | + |
| 104 | +Predeterminadamente, la bandera de configuración `receive.denyNonFastForwards` está habilitada en repositorios compartidos, de tal manera que no se pueda forzar un push no-fast-forward en él. |
| 105 | + |
| 106 | +Si se proporciona un _<directorio>_, el comando se ejecuta dentro de éste. Si éste directorio no existe, se creará. |
| 107 | + |
| 108 | +DIRECTORIO DE PLANTILLAS |
| 109 | +------------------------ |
| 110 | + |
| 111 | +Ficheros y directorios en el directorio de plantillas cuyo nombre no comiencen con un punto serán copiados en el directorio `$GIT_DIR` después de ser creado. |
| 112 | + |
| 113 | +El directorio de plantilla será uno de los siguientes (en este orden): |
| 114 | + |
| 115 | + - el argumento proporcionado con la opción `--template`; |
| 116 | + |
| 117 | + - el contenido de la variable de entorno `$GIT_TEMPLATE_DIR`; |
| 118 | + |
| 119 | + - la variable de configuración `init.templateDir`; o |
| 120 | + |
| 121 | + - el directorio de plantilla por defecto: `/usr/share/git-core/templates`. |
| 122 | + |
| 123 | +El directorio de plantillas predeterminado incluye una estructura de directorio, algunos "patrones de exclusión" sugeridos (ver linkgit:gitignore[5]) y ficheros de hook de ejemplo. |
| 124 | + |
| 125 | +Todos los ganchos de ejemplo están deshabilitados predeterminadamente. Para habilitar uno de los ganchos de ejemplo renómbralo quitando el sufijo `.sample`. |
| 126 | + |
| 127 | +Ver linkgit:githooks[5] para mas información general de la ejecución de hooks. |
| 128 | + |
| 129 | +EJEMPLOS |
| 130 | +-------- |
| 131 | + |
| 132 | +Crear un reprositorio Git nuevo para código fuente existente:: |
| 133 | ++ |
| 134 | +---------------- |
| 135 | +$ cd /ruta/a/mi/código |
| 136 | +$ git init <1> |
| 137 | +$ git add . <2> |
| 138 | +$ git commit <3> |
| 139 | +---------------- |
| 140 | ++ |
| 141 | +<1> Crear un directorio `/ruta/a/mi/código/.git` . |
| 142 | +<2> Añadir todos los ficheros existentes al índice. |
| 143 | +<3> Registra el estado prístino como el primer commit en el historial. |
| 144 | + |
| 145 | +CONFIGURACIÓN |
| 146 | +------------- |
| 147 | + |
| 148 | +Todo debajo de ésta línea en ésta sección es incluido selectivamente de la documentación de linkgit:git-config[1]. El contenido es el mismo al que se encuentra ahí: |
| 149 | +[] |
| 150 | + |
| 151 | +:git-init: |
| 152 | + |
| 153 | + |
| 154 | + |
| 155 | +[WARNING] |
| 156 | +==== |
| 157 | +Missing `es/config/init.txt` |
| 158 | + |
| 159 | +See original version for this content. |
| 160 | +==== |
| 161 | + |
| 162 | +[] |
| 163 | + |
| 164 | +GIT |
| 165 | +--- |
| 166 | +Parte de la suite de linkgit:git[1] |
0 commit comments