Rustlings v1.0.0

.assetsignore

@@ -0,0 +1 @@
+_worker.js

.github/workflows/deploy.yml

@@ -44,14 +44,23 @@ jobs:
           VITE_CLARITY_PROJECT_ID: ${{ secrets.VITE_CLARITY_PROJECT_ID }}
         run: npm run build
 
+      - name: Ignore _worker.js in assets
+        run: echo "_worker.js" > dist/.assetsignore
+
       - name: Deploy
         uses: cloudflare/wrangler-action@v3
         env:
           VITE_CLARITY_PROJECT_ID: ${{ secrets.VITE_CLARITY_PROJECT_ID }}
+          GH_CLIENT_ID: ${{ secrets.GH_CLIENT_ID }}
+          GH_CLIENT_SECRET: ${{ secrets.GH_CLIENT_SECRET }}
+          SESSION_SECRET: ${{ secrets.SESSION_SECRET }}
         with:
-          wranglerVersion: "4.19.1"
+          wranglerVersion: "4.45.0"
           apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
           command: deploy
           secrets: |
             VITE_CLARITY_PROJECT_ID
+            GH_CLIENT_ID
+            GH_CLIENT_SECRET
+            SESSION_SECRET

.github/workflows/pr-preview.yml

@@ -73,8 +73,11 @@ jobs:
         run: npm install
       - name: Build
         env:
-          NUXT_CLARITY_ID: ${{ secrets.CLARITY_ID }}
-        run: npm run build --preset=cloudflare_pages
+          VITE_CLARITY_PROJECT_ID: ${{ secrets.VITE_CLARITY_PROJECT_ID }}
+        run: npm run build
+
+      - name: Ignore _worker.js in assets
+        run: echo "_worker.js" > dist/.assetsignore
 
       # Deploy steps
       - name: Normalize alias
@@ -89,7 +92,16 @@ jobs:
           wranglerVersion: "4.45.0"
           apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
           accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
-          command: versions upload --name "${{ env.PROJECT_NAME }}" --preview-alias "${{ env.ALIAS }}"
+          secrets: |
+            VITE_CLARITY_PROJECT_ID
+            GH_CLIENT_ID
+            GH_CLIENT_SECRET
+            SESSION_SECRET
+        env:
+          VITE_CLARITY_PROJECT_ID: ${{ secrets.VITE_CLARITY_PROJECT_ID }}
+          GH_CLIENT_ID: ${{ secrets.GH_CLIENT_ID }}
+          GH_CLIENT_SECRET: ${{ secrets.GH_CLIENT_SECRET }}
+          SESSION_SECRET: ${{ secrets.SESSION_SECRET }}
 
       - name: Extract hash from CF url Deploy
         run: |

.gitignore

@@ -16,11 +16,15 @@ pnpm-debug.log*
 # environment variables
 .env
 .env.production
+.dev.vars
 
 # macOS-specific files
 .DS_Store
 
 # jetbrains setting folder
 .idea/
 bun.lock
-pnpm-lock.yaml
+pnpm-lock.yaml
+
+# wrangler
+.wrangler/

CONTRIBUTING.md

@@ -0,0 +1,187 @@
+# Guia de contribucion
+
+Gracias por querer contribuir a Rustlings Web. Este documento explica como participar en el proyecto, ya sea mejorando el codigo, corrigiendo errores o traduciendo el contenido.
+
+---
+
+## Flujo de trabajo general
+
+Este proyecto sigue un flujo basado en ramas:
+
+- `main` — rama de produccion. Solo recibe merges desde `develop`.
+- `develop` — rama de integracion. Todas las pull requests van aqui.
+
+### Pasos para contribuir
+
+1. Haz un fork del repositorio en GitHub.
+2. Clona tu fork localmente:
+   ```
+   git clone https://github.com/RustLangES/rustlings-web.git
+   cd rustlings-web
+   ```
+3. Crea una rama descriptiva desde `develop`:
+   ```
+   git checkout develop
+   git checkout -b feat/nombre-de-tu-cambio
+   ```
+4. Realiza tus cambios y haz commits con mensajes claros.
+5. Sube tu rama a tu fork:
+   ```
+   git push origin feat/nombre-de-tu-cambio
+   ```
+6. Abre una pull request hacia la rama `develop` del repositorio original.
+7. Un mantenedor revisara tu PR. Una vez aprobado, se hara merge a `develop` y, en el siguiente ciclo de release, a `main`.
+
+### Convenciones de nombrado de ramas
+
+| Tipo          | Prefijo     | Ejemplo                         |
+|---------------|-------------|---------------------------------|
+| Nueva funcion | `feat/`     | `feat/agregar-progreso-usuario` |
+| Correccion    | `fix/`      | `fix/nav-buttons-href`          |
+| Contenido     | `content/`  | `content/traduccion-en`         |
+| Documentacion | `docs/`     | `docs/actualizar-readme`        |
+| Refactor      | `refactor/` | `refactor/content-manager`      |
+
+---
+
+## Contribuir con traducciones de contenido
+
+El contenido del curso esta organizado por idioma dentro de `src/content/`:
+
+```
+src/content/
+  fundamentos-de-rust/
+    es/       <- Espanol (existente)
+    en/       <- Ingles (puedes crearlo)
+    [lang]/   <- Cualquier otro idioma futuro
+```
+
+### Agregar un nuevo idioma
+
+1. Crea la carpeta del idioma dentro del track correspondiente:
+   ```
+   src/content/fundamentos-de-rust/[codigo-idioma]/
+   ```
+   Usa codigos de idioma estandar BCP 47: `en`, `pt`, `fr`, `de`, etc.
+
+2. Traduce los archivos `.md` del directorio `es/` y colocalos en la nueva carpeta manteniendo los mismos nombres de archivo.
+
+3. Registra el nuevo idioma en los siguientes tres archivos:
+
+   **`src/content-manager.ts`**
+   ```ts
+   export const supportedLangs = ["es", "en"] as const  // agrega tu idioma
+   ```
+
+   **`astro.config.mjs`**
+   ```js
+   i18n: {
+     defaultLocale: "es",
+     locales: ["es", "en"],  // agrega tu idioma
+   }
+   ```
+
+   **`src/i18n/ui.ts`**
+   ```ts
+   export const languages = {
+     es: "Espanol",
+     en: "English",  // agrega tu idioma
+   }
+
+   export const ui = {
+     es: { ... },
+     en: {
+       "nav.home": "Home",
+       "nav.learn": "Learn",
+       // ... resto de las claves
+     },
+   }
+   ```
+
+4. Abre una pull request hacia `develop` con el prefijo `content/` en el nombre de la rama.
+
+### Estructura de los archivos de contenido
+
+Cada archivo `.md` sigue la convencion `[id].[slug].md`:
+
+```
+1.introduccion-rust.md
+2.sintaxis-esencial.md
+2-1.variables-mutabilidad.md
+2-2.tipos-primitivos.md
+```
+
+El numero antes del punto define el orden en el indice. Los archivos con un guion (`2-1`, `2-2`) son subsecciones del capitulo principal (`2`).
+
+El frontmatter admite las siguientes propiedades:
+
+```yaml
+---
+editor: true          # muestra el editor de codigo (true/false)
+code: |               # codigo inicial en el editor (opcional)
+  fn main() {}
+expectedOutput: ""    # salida esperada para validar el ejercicio (opcional)
+testCode: ""          # codigo de prueba adicional (opcional)
+---
+```
+
+### Corregir contenido existente
+
+Si encuentras un error en el contenido en espanol u otro idioma, puedes abrir una PR directamente editando el archivo `.md` correspondiente en `src/content/fundamentos-de-rust/[lang]/`.
+
+---
+
+## Instalacion y desarrollo local
+
+### 1. Instalar dependencias
+
+```
+npm install
+```
+
+### 2. Instalar Wrangler (CLI de Cloudflare)
+
+```
+npm install -g wrangler
+```
+
+### 3. Configurar base de datos
+
+1. Crea una base de datos D1 en Cloudflare:
+   ```
+   wrangler d1 create rustlings
+   ```
+
+2. Actualiza `wrangler.toml` con tu `database_id` y `database_name`:
+   ```toml
+   [[d1_databases]]
+   binding = "DB"
+   database_name = "tu-nombre-de-db"
+   database_id = "tu-database-id"
+   ```
+
+3. Ejecuta las migraciones:
+   ```
+   wrangler d1 migrations apply --local
+   ```
+
+### 4. Desarrollo
+
+Para desarrollo basico (sin funcionalidades de backend):
+```
+npm run dev
+```
+
+Para desarrollo completo con todas las funcionalidades:
+```
+npm run build
+wrangler dev
+```
+
+El servidor de desarrollo estara disponible en `http://localhost:8787` con Wrangler o `http://localhost:4321` con Astro.
+
+---
+
+## Preguntas
+
+Si tienes dudas sobre como contribuir, abre un issue en el repositorio o consulta en el servidor de Discord del proyecto.