Diferencias

Muestra las diferencias entre dos versiones de la página.

--- como_utilizar_el_repositorio_de_git_en_texto_plano [2021/06/05 22:22] – creado bru
+++ como_utilizar_el_repositorio_de_git_en_texto_plano [2023/09/17 01:33] (actual) – [En nuestro servidor texto-plano] peron
@@ Línea 1: / Línea 1: @@
-Hemos implementado un repositorio de git que puedes utilizar libremente para cualquier script, aplicación o cualquier material que necesite versionado que quieras compartir con nosotros y otras personas en internet. Este artículo no va a explicar el uso básico de GIT pero habrá otro manual de uso básico o puedes revisar otros en Internet.
+Hemos implementado un repositorio de [[git]] que puedes utilizar libremente para cualquier [[script|guión]], aplicación o cualquier material que necesite versionado que quieras compartir con nosotros y otras personas en internet. Este artículo no va a explicar el uso básico de GIT pero habrá otro manual de uso básico o puedes revisar otros en Internet.
-(EDIT 21/12/2020: Partimos de la base de que tienes un repositorio local listo para subir al sistema. Si no tienes un repositorio local, créalo)
+>Partimos de la base de que tienes un repositorio local listo para subir al sistema. Si no tienes un repositorio local, pídeselo al //~admin//)
-===== Cómo utilizar el repositorio remoto =====
+===== Cómo utilizar tu repositorio de git remoto =====
+Nuestra comunidad te ofrece un servidor, donde puedes almacenar repositorios git y actualzarlos, incluso desde el equipo local que utilizas para conectarte a texto-plano.xyz.
-Lo primero es que debes crear un enlace simbólico a la carpeta de /var/www/cgit_repos/<html><USUARIO></html> de la siguiente manera:
+==== En nuestro servidor texto-plano ====
+=== 1. Crea enlace simbólico a git ===
+Para poder utilizar git, debes contar con un enlace simbólico desde tu directorio ''~/public_repos/'' al directorio de sistema ''/var/www/cgit_repos/html/$USER''. Dicho enlace simbólico ya debería existir, pero en caso de no estarlo puedes hacerlo con el siguiente comando:
 <code>
 ln -s /var/www/cgit_repos/$USER ~/public_repos
 </code>
-Para crear tu propio repositorio tienes que entrar ahora a ~/public_repos y crear un directorio terminado en .git:
+=== 2. Genera un repositorio de proyecto ===
+El repositorio de proyecto es un directorio localizado dentro de ''~/public_repos/''. Por ejemplo, puedes crear un directorio para el repositorio de tu software que deseas compartir, denominado ''mi_programa'':
 <code>
-mkdir mi_programa.git
+mkdir ~/public_repos/mi_programa/
 </code>
-Luego entra a él e inicializa el repositorio:
-<code>
+Ingresa al directorio del respositorio de //mi_programa//, e inicialízalo en nuestro servidor git compartido:
-cd mi_programa.git && git init --bare
+<code bash>
+cd ~/public_repos/mi_programa/ ;
+git init --bare
 </code>
-Dentro de mi_programa.git hay un archivo que se llama config. Agrega lo siguiente:
-<code>
+=== 3. Configura el repositorio creado ===
-[gitweb] owner = usuario <usuario@texto-plano.xyz>
+Asegúrate de editar el fichero ''~/public_repos/mi_programa/.git/config'', agregando el siguiente contenido al final del fichero (no olvides de adecuarlo con tu nombre de usuari@):
+<code bash>
+[gitweb]
+        owner = usuario <usuario@texto-plano.xyz>
 </code>
-Luego agrega un archivo que se llame “description” (puede ser con echo o editándolo por vim/nano):
-<code>
+Si bien es opcional, es muy recomendable agregarle aste repositorio de //mi_programa// una descripción del repositorio. Esto se hace agregando una única línea d etexto en el fichero de descripción correpondiente, en este caso ''~/public_repos/mi_programa/.git/description''. Puedes hacerlo uzando tu [[editores de texto|tu editor favorito]] o bien usando el comando [[tutorial_basico_de_la_consola#echo|echo]], como en este ejemplo:
-echo "mi fabulosa aplicación que sirve para X cosa" > description
+<code bash>
+echo "mi programa es fabuloso para hacer X cosa" > ~/public_repos/mi_programa/.git/description
 </code>
-Eso por el lado del servidor. Para que tu repositorio local reconozca este repo deberás añadir un repositorio remoto a tu sistema. Dependerá de si trabajas tu aplicación desde tu ~ en texto-plano o si lo haces desde tu PC local:
-Si estás en tu ~ de texto-plano.xyz:
+>Con esto ya podrás utilizar git en texto-plano.xyz. Tu repositorio debería aparecer en https://git.texto-plano.xyz/
-<code>
+====En tu dispositivo local ====
-git remote add texto-plano.xyz /home/<USUARIO>/public_repos/<REPO>
+Para que tu repositorio en tu dispositivo local reconozca este repo remoto situado en texto-plano.xyz, debes añadir un repositorio remoto a tu sistema.
+Dependerá de si trabajas tu aplicación desde tu ~usuario en texto-plano o si lo haces desde tu PC local:
+===Desde tu home en texto-plano.xyz===
+<code bash>
+git remote add texto-plano.xyz /home/<USUARIO>/public_repos/mi_programa
 </code>
-Si estás en tu pc local:
-<code>
+===Si estás en tu dispositivo o PC local===
-git remote add texto-plano.xyz <USUARIO>@texto-plano.xyz:public_repos/<REPO>
+<code bash>
+git remote add texto-plano.xyz <USUARIO>@texto-plano.xyz:public_repos/mi_programa
+</code>
+(emplea [[SSH]] para conectarte)
+Cuando quieras especificar qué ficheros se van a subir debes utilizar:
+<code bash>
+git add fichero
+</code>
+...Y tienes que hacerle un //commit// a los cambios
+<code bash>
+git commit -m "Commit Inicial"
+</code>
+(Opcionalmente, puedes revisar los cambios antes de que se suban)
+<code bash>
+git log
 </code>
-(emplea SSH para conectarse)
 Cuando necesites actualizar un cambio:
-<code>
+<code bash>
 git push -u texto-plano.xyz master
 </code>
 (o el nombre que le hayas puesto a la rama principal)
-Tu repositorio debería aparecer en https://git.texto-plano.xyz
 (Tomado desde la [[https://wiki.tilde.institute|wiki de tilde.institute]] cuyo sistema es análogo al nuestro)
+Para más información ver: [[https://git-scm.com/doc| la documentación de git]]