Brevísimo manual para subir scripts BASH a Codeberg

Brevísimo manual para subir scripts BASH a Codeberg.

Este proceso asume que ya tenés a git instalado.
Ante cualquier error, consultá la última sección (NOTAS IMPORTANTES).

 

Paso 1: inicializar un repositorio git local.

• Abrí tu terminal en el directorio en donde tengas el script y las carpetas con los sub-archivos del mismo.
• Una vez ahí, inicializá un repositorio git local con "git init" (esto creará una carpeta oculta ".git" en tu directorio, la cual git utilizará para rastrear los cambios)

La salida que verás en la terminal luego de ejecutar "git init", será similar a esta:

hint: Usando 'master' como el nombre de la rama inicial. Este nombre de rama predeterminado
hint: está sujeto a cambios. Para configurar el nombre de la rama inicial para usar en todos
hint: de sus nuevos repositorios, reprimiendo esta advertencia, llama a:
hint:
hint: git config --global init.defaultBranch <nombre>
hint:
hint: Los nombres comúnmente elegidos en lugar de 'master' son 'main', 'trunk' y
hint: 'development'. Se puede cambiar el nombre de la rama recién creada mediante este comando:
hint:
hint: git branch -m <nombre>
hint:
hint: Disable this message with "git config set advice.defaultBranchName false"

Paso 2: añadir tus archivos al repositorio.

Ahora, hay que decirle a git qué archivos querés que incluya en tu primer "paquete" de cambios. Vas a querer incluir el script junto con las carpetas del mismo, si es que las hay.

• git add script.sh
• git add carpeta/

Si tenés otros archivos importantes (licencia, archivos tipo "info", etc.), también agregalos utilizando el mismo procedimiento.

Si querés agregar todos los archivos nuevos y modificados en el directorio actual (cuidado con esto, asegurate de no incluir cosas que no querés), podés hacer "git add ." (el punto importa, y significa "todo lo que está acá").

Paso 3: confirmar los cambios (commit).

Ahora, git ya sabe qué archivos añadir. Creá una "instantánea" de esos cambios con un mensaje que describa lo que hiciste. Esto se llama "commit".

• git commit -m "Menú interactivo con barra en reversa."

El mensaje es importante para que vos (y otros) entiendan qué contiene ese commit.

Paso 4: crear un repositorio en Codeberg.

• Ahora andá a la web de Codeberg en el navegador: https://codeberg.org/
• Iniciá sesión.
• Hacé clic en el botón "+" (arriba, a la derecha) y seleccioná "Nuevo repositorio".
   
  
  
  
• Ponele un nombre representativo (ej: menu).
• Podés añadir una descripción opcional.
• Desmarcá la opción "Inicializar el repositorio" si vas a subir tus propios archivos "README". De no ser así, podés pedirle a CodeBerg que lo haga por vos, marcando esta opción.
• Definí el tipo de licencia que quieras para tu proyecto. En nuestro caso, utilizamos "GPL 3.0 or later". Para que te aparezca esta opción, debés marcar la casilla "inicializar el repositorio".
• Hacé clic en el botón azul "Crear repositorio".
• Una vez creado, Codeberg te mostrará unas instrucciones. Buscá la sección que dice algo así como "enviar un repositorio existente desde la línea de comandos". Vas a necesitar las dos líneas de comando que te dará. Si CodeBerg simplemente crea el repositorio y no te brinda esta información, simplemente andá arriba, a la derecha, y copiá la línea "https://codeberg.org ... script.git".
  
  
  

Paso 5: conectar tu repositorio local con Codeberg.

• Volvé a tu terminal.
• Utilizá las dos líneas que te dio Codeberg (van a ser algo como esto, pero con tu nombre de usuario y el nombre de tu repo):
  
  git remote add origin https://codeberg.org/tu_usuario/tu_script.git
  
  git pull origin main --rebase
  
  git branch -m main

Acordate de que si no te dio esa información, podés obtenerla manualmente en el paso anterior (es la que figura en azul).
La primera línea (la azul) le dice a tu repositorio local dónde está el repositorio remoto en Codeberg.
La segunda, renombra tu rama principal a "main" (es la convención moderna).
La tercera, sincroniza los cambios iniciales (README/licencia).

Paso 6: subir tus cambios a Codeberg (push).

• Finalmente, enviá todos tus cambios locales (el commit que hiciste) al repositorio en Codeberg con "git push -u origin main"

Te pedirá tu nombre de usuario y tu contraseña de Codeberg (o un token de acceso, si configuraste SSH).

¡Listo! Ahora, toca ir a la página de tu repositorio en Codeberg y ver que están todos tus archivos ahí, y que se actualizaron (o subieron) "hace 1 minuto".

NOTAS IMPORTANTES:

Si por alguna razón tenés que empezar de nuevo (te equivocaste, algo salió mal, etc.), tenés que borrar el directorio oculto ".git" que fue creado cuando hiciste "git init".

Si te "salta" este error en rojo

error: falló el empuje de algunas referencias a 'https://codeberg.org/tu_usuario/tu_script.git'

solucionalo así:

git pull --rebase origin main
git push origin main

Si en algún momento ves este mensaje:

Identidad del autor desconocido

*** Por favor cuéntame quién eres.

Ejecuta

git config --global user.email "you@example.com"
git config --global user.name "Tu Nombre"

para configurar la identidad por defecto de tu cuenta.
Omite --global para configurar tu identidad solo en este repositorio.

fatal: no es posible auto-detectar la dirección de correo (se obtuvo 'entropia@entropia-artix.(none)')

podés resolverlo ingresando las siguientes líneas en la terminal:

git config --global user.email "entropiabinaria38911@gmail.com"
git config --global user.name "Entropía binaria"

y volvé a repetir la línea que habías ejecutado sin éxito.
Esto generalmente sucede al procesar, por ejemplo:

git commit -m "Menú interactivo con barra en reversa."