Uso de Git desde el editor

Introducción

¿Qué es Git?

Git (se pronuncia «guit») es un sistema de control de versiones de código que se usa habitualmente en los proyectos de software. Permite, entre otras cosas:

tener un historial del código, en el que se puede volver atrás;
sincronizar varios dispositivos y trabajar en equipo sobre los mismos archivos limitando los conflictos;
mantener varias versiones del mismo código, para desarrollar y experimentar sin romper la versión que funciona;
hacer copias de seguridad del proyecto fácilmente.

Una carpeta versionada con Git se llama repositorio (_repository_ o _repo_ en inglés).

¿Qué es una forja?

Aunque Git es un software que puede usarse en local (en tu máquina o en el editor de Leek Wars), también puede interactuar con una forja de software. Es un servidor que aloja repositorios Git.

Leek Wars soporta varias forjas; lo más sencillo es elegir una de estas:

GitHub, servicio privativo de Microsoft (EE. UU.). Aloja también el código de Leek Wars.
GitLab.com, instancia oficial de GitLab (EE. UU.), un software libre que se puede autoalojar.
Bitbucket, servicio privativo de Atlassian (EE. UU.).
Codeberg, instancia oficial de Forgejo, software libre comunitario que se puede autoalojar, alojada por una organización alemana sin ánimo de lucro.

También es posible usar otras forjas basadas en GitLab, Bitbucket, Forgejo, Gitea o Gogs, por ejemplo framagit.org o gitea.com.

Usar Git con una IA existente

En primer lugar, la IA debe estar en una carpeta, y no en la raíz. Crea una carpeta, haz clic derecho sobre la carpeta y elige "Inicializar un repositorio Git". Contendrá todos los archivos que se integrarán en Git.

Una pestaña Git con un pictograma de ramificación aparece en la parte superior de la lista de archivos (menú de la izquierda). Ve allí.

Hacer commits

(se pronuncia «comit»; en español se diría «confirmación» o «validación»)

En la parte superior de la pestaña Git, comprueba en el selector desplegable que el repositorio deseado está seleccionado (si tienes varios).

Cuando se modifican los archivos del repositorio, las modificaciones aparecen en la pestaña Git. Por ahora están sin indexar: es como un borrador, que todavía no está grabado en el mármol del historial.

Cuando quieras registrar las modificaciones en el historial, haz clic en el botón ➕ para indexarlas. Resume en pocas palabras las modificaciones en el campo "Mensaje de commit" y valida.

Nota: para ver bien todos los botones de la pestaña Git, puede ser necesario ampliarla hacia la derecha arrastrando su borde derecho.

El historial es una lista de commits, y cada commit es un conjunto de modificaciones, con una fecha y un mensaje. La idea es poder saber de cuándo data tal modificación, volver atrás, agrupar las modificaciones para evitar tener un código que funcione a medias...

Conectarse a una forja

Configuración en la forja

Créate una cuenta en una forja Git y crea en ella un repositorio vacío. Busca la dirección de tu repositorio, que debería parecerse a https://exemple.net/mon-pseudo/mon-depot.git. Es la dirección de la página principal de tu repositorio, con .git añadido al final.

Después hay que autorizar a Leek Wars a acceder al repositorio. El procedimiento depende de la forja.

GitHub: lo más sencillo es instalar la GitHub App de Leek Wars, directamente desde el editor (ver más abajo). Como alternativa, puedes crear un token: haz clic en tu perfil, Settings, Developer Settings (abajo del todo). En la página que se abre, elige Personal access tokens, Tokens (classic). Elige una caducidad (90 días, por ejemplo) y concede solo los permisos necesarios para participar en el repositorio.
Forgejo: Configuración de la cuenta, Aplicaciones, Nuevo token de acceso. Autoriza el acceso de lectura y escritura a "repository".

Si has creado un token, ¡guárdalo bien para no perderlo!

Configuración en Leek Wars

En la parte inferior de la pestaña Git, haz clic en el botón con forma de nube "Configuración del remote".

Aquí es donde se declara el repositorio remoto (el remote): indica un nombre (por ejemplo origin), pega la URL del repositorio y haz clic en el botón "Añadir". Este paso es indispensable antes de poder subir nada.

Para la autenticación, elige tu forja: GitHub, GitLab, Bitbucket o Forgejo.

GitHub: la vía principal es el botón "Instalar la GitHub App". Durante la instalación, elige los repositorios a los que dar acceso; de vuelta en Leek Wars, podrás seleccionar directamente uno de esos repositorios para el remote. Como alternativa, pega un Personal Access Token en el campo "Token de acceso".
GitLab y Bitbucket: pega el token en el campo "Token de acceso". Si usas una instancia autoalojada en lugar de gitlab.com o bitbucket.org, marca "Instancia autoalojada" e indica la dirección de la forja (esta casilla también existe para GitHub).
Forgejo: la casilla "Instancia autoalojada" no existe para esta forja; el campo de dirección de la instancia se muestra siempre (rellenado por defecto con codeberg.org). Indica la dirección de tu instancia si hace falta, y pega el token en el campo "Token de acceso".

Enviar los commits al servidor

Por ahora, el historial de commits solo está guardado en Leek Wars. Para enviarlo a la forja, se hace un push con el botón ⬆ situado abajo del todo en la pestaña Git.

Cada vez que quieras enviar nuevos commits, haz un push.

Otras funciones

El editor y la pestaña Git también ofrecen:

Clonar un repositorio: menú Archivo → "Clonar un repo git", indicando la URL del repositorio y la carpeta de destino.
Traer (pull): botón "Traer (pull)" para recuperar los commits del remote, con una estrategia merge o rebase a elegir ("Estrategia de pull").
Ramas: el selector de rama permite cambiar de rama, crear una ("Nueva rama...") y ver las ramas remotas.
Historial y diff: el botón "Historial" lista los commits, y un clic en un archivo modificado muestra sus diferencias.
Resolución de conflictos: en caso de conflicto durante una fusión o un rebase, el editor permite resolverlos y luego continuar.
Deshacer el último commit: los cambios del commit deshecho permanecen en el índice.
Compactar el repositorio: reduce el espacio ocupado por el repositorio (útil para la cuota).
Terminal Git integrado: muestra el registro de los comandos Git ejecutados por el editor.