Class_generator/PORTABLE_SETUP.txt
StillHammer ab84bbbc71 Reduce game sizes and fix Mario level display
- Reduce RiverRun game height from 100vh to 75vh for better screen fit
- Reduce AdventureReader game height from 100vh to 75vh
- Fix Mario level number display (was showing currentLevel + 1 twice)
  - Updated HUD level display in Renderer.js
  - Updated finish line flag level display in Renderer.js
- Add portable setup files and documentation
- Add new game modules: SentenceInvaders, ThematicQuestions
- Add new content: wte2 book, sbs chapters 2-3, wte2-2 chapter
- Update various game modules for improved compatibility

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-18 16:22:33 +08:00

106 lines
5.0 KiB
Plaintext

═══════════════════════════════════════════════════════════════
CLASS GENERATOR - PORTABLE EDITION SETUP
═══════════════════════════════════════════════════════════════
📋 PRÉREQUIS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
• Clé USB ou disque externe (minimum 150 MB libre)
• Windows 10 (pas besoin de droits admin!)
• PAS besoin d'internet pour utiliser (seulement pour setup initial)
🔧 INSTALLATION (À FAIRE UNE SEULE FOIS SUR TON PC)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. TÉLÉCHARGER NODE.JS PORTABLE
────────────────────────────────────────────────────────────
Option A - Automatique (recommandé):
• Double-cliquer sur: DOWNLOAD_NODEJS.bat
• Attendre le téléchargement automatique
• ✅ Terminé!
Option B - Manuel:
• Aller sur: https://nodejs.org/en/download/
• Télécharger: "Windows Binary (.zip)" - version LTS
• Extraire le fichier ZIP
• Renommer le dossier en "nodejs-portable"
• Copier le dossier "nodejs-portable" dans ce dossier
2. VÉRIFIER LA STRUCTURE
────────────────────────────────────────────────────────────
Ton dossier doit ressembler à ça:
Class_generator/
├── nodejs-portable/ ← Le dossier Node.js
│ ├── node.exe ← Important!
│ ├── npm
│ └── node_modules/
├── src/
├── content/
├── START_PORTABLE.bat ← Lance ça!
├── server.js
└── package.json
3. PREMIER LANCEMENT
────────────────────────────────────────────────────────────
• Double-cliquer sur: START_PORTABLE.bat
• La première fois, ça va installer dotenv (~10 secondes)
• Ensuite le serveur démarre!
🚀 UTILISATION EN COURS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Brancher ta clé USB
2. Double-cliquer sur START_PORTABLE.bat
3. Ouvrir le navigateur: http://localhost:8080
4. Utiliser l'application!
⚠️ LIMITATIONS SANS INTERNET
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Sans connexion internet, ces features ne marcheront PAS:
• ❌ AI exercises (OpenAI/DeepSeek API)
• ❌ LLM scoring
• ❌ Translation API
• ❌ Online content loading
Ce qui MARCHE hors-ligne:
• ✅ Interface principale
• ✅ Navigation
• ✅ Contenu local (fichiers JSON dans content/)
• ✅ Jeux sans AI
• ✅ Flashcards locaux
• ✅ Sauvegarde locale (dossier saves/)
📦 TAILLE TOTALE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Projet actuel: 42 MB
Node.js portable: ~50 MB
node_modules: 1 MB
─────────────────────────────
TOTAL: ~95 MB
💡 DÉPANNAGE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Problème: "Node.js portable not found!"
→ Solution: Vérifier que le dossier "nodejs-portable" existe
et contient node.exe
Problème: "Port 8080 already in use"
→ Solution: Ouvrir le Gestionnaire des tâches
Arrêter tous les processus "node.exe"
Relancer START_PORTABLE.bat
Problème: Page blanche dans le navigateur
→ Solution: Vérifier que l'URL est bien http://localhost:8080
(pas https!)
Problème: AI ne fonctionne pas
→ Solution: Normal sans internet! Utiliser les jeux locaux
═══════════════════════════════════════════════════════════════
Créé le 2025-10-18 | Class Generator 2.0 Portable Edition
═══════════════════════════════════════════════════════════════