Adrien Ufferte
130 lines
4.0 KiB
Markdown
130 lines
4.0 KiB
Markdown
|
||
|
||
# 📖 Kalulu — Aprende a leer de forma inteligente
|
||
|
||
## 🌍 Idiomas disponibles
|
||
|
||
- 🇬🇧 [English](README.md)
|
||
- 🇫🇷 [Français](README.fr.md)
|
||
- 🇧🇷 [Português (Brasil)](README.pt-br.md)
|
||
|
||
---
|
||
|
||
## 📚 Contenido
|
||
|
||
- [🧠 ¿Por qué Kalulu?](#por-qué-kalulu)
|
||
- [✨ Funcionalidades](#funcionalidades)
|
||
- [🚀 Primeros pasos](#primeros-pasos)
|
||
- [1. Clonar el repositorio](#1-clonar-el-repositorio)
|
||
- [2. Instalar Godot Engine](#2-instalar-godot-engine)
|
||
- [🧩 Addons integrados](#-addons-integrados)
|
||
- [🤝 ¿Quieres ayudar?](#-quieres-ayudar-)
|
||
- [❓ FAQ](#faq)
|
||
|
||
---
|
||
|
||
## 🧠 ¿Por qué Kalulu?
|
||
|
||
**Kalulu** no es solo un juego: es una herramienta educativa basada en investigaciones científicas que enseña a leer a los niños mediante el método de decodificación.
|
||
|
||
Cada lección sigue una progresión lógica basada en datos lingüísticos extraídos de la literatura infantil.
|
||
|
||
- 🎯 **Objetivo**: Hacer que aprender a leer sea divertido y efectivo
|
||
- 🌟 **Basado en ciencia**: Desarrollado con investigaciones en neurociencia y educación
|
||
- 👶 **Público objetivo**: Niños, pero útil para cualquier principiante en la lectura
|
||
- 🔎 **Investigaciones publicadas**: Se han publicado varios artículos sobre el diseño de Kalulu y los resultados de lectura, léelos aquí:
|
||
https://www.tandfonline.com/doi/pdf/10.1080/00220973.2023.2173129
|
||
https://hal.science/hal-03015914/document
|
||
https://hal.science/hal-03702075/document
|
||
|
||
---
|
||
|
||
## ✨ Funcionalidades
|
||
|
||
- Lecciones interactivas de lectura grafema-fonema
|
||
- Progresión adaptativa de dificultad
|
||
- Interfaz amigable para niños con visuales atractivos
|
||
|
||
---
|
||
|
||
## 🚀 Primeros pasos
|
||
|
||
### 1. 📥 Clonar el repositorio
|
||
|
||
```bash
|
||
# Clona tu fork del repositorio
|
||
git clone https://github.com/TU_USUARIO/Kalulu-Frontend.git
|
||
# O bien
|
||
git clone git@github.com:YOUR_USERNAME/Kalulu-Frontend.git
|
||
|
||
cd Kalulu-Frontend
|
||
```
|
||
|
||
🔁 _Reemplaza `TU_USUARIO` con tu nombre de usuario._
|
||
|
||
---
|
||
|
||
### 2. 🎮 Instalar Godot Engine
|
||
|
||
- Descarga desde [godotengine.org](https://godotengine.org/)
|
||
- Elige tu sistema operativo y abre el editor
|
||
|
||
---
|
||
|
||
## 🧩 Addons integrados
|
||
|
||
- 🔄 **EnvironmentSwitcher** – Cambia entre entornos fácilmente
|
||
- 📤 **export_tool_manager** – Facilita exportar a múltiples plataformas
|
||
- ✅ **godot-form-validator** – Plugin para validar formularios en Godot 4
|
||
- 🗃️ **godot-sqlite** – Soporte SQLite
|
||
|
||
> ⚠️ Debe descargarse manualmente desde el AssetLib.
|
||
|
||
---
|
||
|
||
## 🤝 ¿Quieres ayudar?
|
||
|
||
¡Tu colaboración es bienvenida!
|
||
|
||
1. **Configura el proyecto**
|
||
Consulta la [sección de Primeros pasos](#primeros-pasos) para aprender a bifurcar y clonar el repositorio.
|
||
|
||
2. **Crea una nueva rama**
|
||
```bash
|
||
git checkout -b feature/nombre-de-tu-funcion
|
||
```
|
||
|
||
3. **Haz tus cambios**
|
||
Implementa tus mejoras o correcciones.
|
||
|
||
4. **Confirma y sube tus cambios**
|
||
```bash
|
||
git add .
|
||
git commit -m "Describe tus cambios"
|
||
git push origin feature/nombre-de-tu-funcion
|
||
```
|
||
|
||
5. **Abre una Pull Request**
|
||
Ve a tu repositorio bifurcado en GitHub y haz clic en **Compare & pull request** para enviar tus cambios.
|
||
|
||
Asegúrate de que tu código siga nuestras convenciones de codificación e incluya las pruebas o actualizaciones de documentación necesarias cuando corresponda.
|
||
|
||
---
|
||
|
||
## ❓ FAQ
|
||
|
||
### 📱 ¿Está Kalulu disponible en móviles?
|
||
|
||
¡Sí! Kalulu está disponible para:
|
||
|
||
- [](https://play.google.com/store/apps/details?id=org.godotengine.kalulu)
|
||
- [](https://apps.apple.com/fr/app/kalulu-education/id1639075967)
|
||
|
||
### 💻 ¿Está Kalulu disponible en escritorio?
|
||
|
||
¡Sí! Las versiones para Windows, Mac y Linux están disponibles en la sección [Releases](https://github.com/Excello-Recherche-Education/Kalulu-Frontend/releases).
|
||
|
||
### 🌐 ¿Está Kalulu disponible directamente en la web?
|
||
|
||
¡Estamos trabajando en ello, mantente atento!
|