Aitor
159 lines
3.8 KiB
Markdown
159 lines
3.8 KiB
Markdown
# Cómo subir Txoko a Gitea — paso a paso
|
|
|
|
Instrucciones exactas. Copiar y pegar en la terminal del Mac.
|
|
No hace falta entender git para seguir esto.
|
|
|
|
---
|
|
|
|
## PASO 1 — Crear el repo en Gitea (una sola vez)
|
|
|
|
1. Abre tu instancia de Gitea en el navegador
|
|
2. Clic en el **+** (arriba a la derecha) → "New Repository"
|
|
3. Rellena:
|
|
- **Repository Name:** `txoko-dashboard`
|
|
- **Description:** `Suite de auditoría de privacidad Bitcoin para nodos propios`
|
|
- **Visibility:** Private (o Public si quieres compartirlo con la comunidad)
|
|
- **Initialize repository:** NO marcar (ya traemos nuestros archivos)
|
|
4. Clic en "Create Repository"
|
|
5. Gitea te muestra una página con instrucciones — copia la URL del repo,
|
|
será algo como: `https://gitea.tu-comunidad/tu-usuario/txoko-dashboard.git`
|
|
|
|
---
|
|
|
|
## PASO 2 — Configurar git en el Mac (una sola vez, si no lo tienes)
|
|
|
|
```bash
|
|
git config --global user.name "tu nombre"
|
|
git config --global user.email "tu@email.com"
|
|
```
|
|
|
|
Comprueba que git está instalado:
|
|
```bash
|
|
git --version
|
|
```
|
|
Si no está: `brew install git`
|
|
|
|
---
|
|
|
|
## PASO 3 — Crear el repo local y primer commit (una sola vez)
|
|
|
|
```bash
|
|
# Crear carpeta del proyecto en el Mac
|
|
mkdir ~/txoko-dashboard
|
|
cd ~/txoko-dashboard
|
|
|
|
# Copiar los archivos del repo que te he preparado
|
|
# (descarga los archivos de esta conversación y cópialos aquí)
|
|
|
|
# Inicializar git
|
|
git init
|
|
git branch -M main
|
|
|
|
# Añadir todos los archivos
|
|
git add .
|
|
|
|
# Primer commit — el historial empieza aquí
|
|
git commit -m "inicio: dashboard de privacidad Bitcoin con análisis on-chain"
|
|
```
|
|
|
|
---
|
|
|
|
## PASO 4 — Conectar con Gitea y subir (una sola vez)
|
|
|
|
```bash
|
|
# Sustituye la URL por la de tu repo de Gitea
|
|
git remote add origin https://gitea.tu-comunidad/tu-usuario/txoko-dashboard.git
|
|
|
|
# Subir
|
|
git push -u origin main
|
|
```
|
|
|
|
Gitea te pedirá usuario y contraseña la primera vez.
|
|
Si quieres evitar introducirlos cada vez, crea un token en
|
|
Gitea → Settings → Applications → "Generate Token" y úsalo como contraseña.
|
|
|
|
---
|
|
|
|
## PASO 5 — Flujo de trabajo normal (cada vez que yo te dé un archivo nuevo)
|
|
|
|
```bash
|
|
cd ~/txoko-dashboard
|
|
|
|
# Copiar el archivo actualizado descargado de esta conversación
|
|
cp ~/Downloads/txoko-dashboard.html ./dashboard.html
|
|
|
|
# Ver qué cambió (opcional pero útil)
|
|
git diff dashboard.html
|
|
|
|
# Registrar el cambio con un mensaje descriptivo
|
|
git add dashboard.html
|
|
git commit -m "fix: descripción breve de lo que se arregló"
|
|
|
|
# Subir a Gitea
|
|
git push
|
|
|
|
# Copiar al nodo (igual que antes)
|
|
scp dashboard.html armg@100.116.19.86:/home/armg/txoko/dashboard.html
|
|
```
|
|
|
|
---
|
|
|
|
## Mensajes de commit — ejemplos
|
|
|
|
El mensaje va después de `-m` y describe QUÉ cambiaste.
|
|
No tiene que ser perfecto, solo útil para ti en el futuro.
|
|
|
|
```
|
|
"fix: timeout en consultas al nodo"
|
|
"feat: score por bandas ALTA/MEDIA/BAJA"
|
|
"fix: responsive pestaña Mempool en móvil"
|
|
"fix: detección Whirlpool con tolerancia 2%"
|
|
"feat: fingerprinting wallet completo"
|
|
"fix: umbral dust por tipo de salida"
|
|
"docs: actualizar README con nuevas funcionalidades"
|
|
```
|
|
|
|
Convención (opcional pero ordenada):
|
|
- `fix:` — corrige algo que no funcionaba bien
|
|
- `feat:` — añade algo nuevo
|
|
- `docs:` — solo documentación
|
|
|
|
---
|
|
|
|
## Si algo sale mal
|
|
|
|
**Subiste algo que no querías:**
|
|
```bash
|
|
git revert HEAD
|
|
git push
|
|
```
|
|
|
|
**Quieres volver a una versión anterior:**
|
|
```bash
|
|
git log --oneline # ver el historial
|
|
git checkout HASH_DEL_COMMIT -- dashboard.html # recuperar ese archivo
|
|
```
|
|
|
|
**Ver el historial:**
|
|
```bash
|
|
git log --oneline
|
|
```
|
|
|
|
---
|
|
|
|
## Resumen del flujo
|
|
|
|
```
|
|
Claude te da dashboard.html
|
|
↓
|
|
cp ~/Downloads/dashboard.html ./dashboard.html
|
|
↓
|
|
git add . && git commit -m "descripción"
|
|
↓
|
|
git push
|
|
↓
|
|
scp dashboard.html armg@100.116.19.86:/home/armg/txoko/
|
|
```
|
|
|
|
Cuatro comandos después de la descarga. Siempre los mismos.
|