📚 كيفية استخدام ملفات JSON

بعد إنشاء ملف JSON باستخدام المولد أو بعد استرجاع ملفاتك القديمة، إليك الطرق المختلفة لاستخدامها مع نظام "إيجاد الخطأ".

🚀 الطريقة 1: الوضع التلقائي (موصى به)

الأفضل للمبتدئين ولمن لديه عدة ملفات JSON

✅ المميزات:

سهل جداً - لا يحتاج برمجة
تحميل جميع التمارين تلقائياً
التنقل بين التمارين بأزرار
إحصائيات شاملة لجميع التمارين

⚠️ يحتاج:

تعديل بسيط في ملف JavaScript

رتب ملفاتك في مجلد واحد

mon-site/
└── trouve-erreur/
├── TrouveErreurUltimate.html
├── Find_error_engine.js
└── exercices/
├── erreur-div2.json
├── erreur-div3.json
├── erreur-pgcd.json
└── erreur-ppcm.json

💡 نصيحة: ضع جميع ملفات JSON في مجلد "exercices" لسهولة التنظيم

افتح ملف Find_error_engine.js

ابحث عن السطر 52 تقريباً، ستجد:

exerciseFiles = [
    'erreur-div2.json',
    'erreur-div3.json',
    'erreur-div4.json',
    'erreur-div5.json',
    'erreur-div9.json',
    'erreur-div10.json',
    'erreur-confusion.json',
    'erreur-premiers.json',
    'erreur-pgcd.json',
    'erreur-ppcm.json'
];
            

استبدل القائمة بأسماء ملفاتك

إذا كانت ملفاتك في مجلد "exercices"، اكتب:

exerciseFiles = [
    'exercices/erreur-div2.json',
    'exercices/erreur-div3.json',
    'exercices/erreur-pgcd.json',
    'exercices/erreur-ppcm.json',
    'exercices/mon-exercice-1.json',
    'exercices/mon-exercice-2.json'
];
            

⚠️ مهم جداً:

تأكد من كتابة المسار الصحيح للملفات!
إذا كانت الملفات في نفس المجلد مع HTML، لا تحتاج "exercices/"

احفظ الملف وافتح TrouveErreurUltimate.html

الآن فقط افتح TrouveErreurUltimate.html في المتصفح

✅ تم!

سيتم تحميل جميع تمارينك تلقائياً مع:

✓ أزرار التنقل بين التمارين
✓ شريط التقدم
✓ الإحصائيات الشاملة
✓ حفظ النتائج

🎯 الطريقة 2: تمرين واحد فقط (بدون تعديل الكود)

مثالي لتجربة تمرين واحد أو لإنشاء صفحة مخصصة

✅ المميزات:

لا يحتاج تعديل الكود أبداً
يمكن مشاركة رابط مباشر للتمرين
مثالي للاختبارات

ضع ملف JSON في نفس المجلد

mon-site/
└── trouve-erreur/
├── TrouveErreurUltimate.html
├── Find_error_engine.js
└── mon-exercice.json

افتح بإضافة ?exercise= في الرابط

بدلاً من فتح الملف مباشرة، استخدم هذا الرابط:

TrouveErreurUltimate.html?exercise=mon-exercice.json

أو إذا كان في مجلد:

TrouveErreurUltimate.html?exercise=exercices/mon-exercice.json

💡 نصيحة: يمكنك إنشاء صفحة HTML بسيطة تحتوي على روابط لجميع تمارينك

📋 الطريقة 3: إنشاء صفحة فهرس (الأكثر احترافية)

للحصول على موقع منظم مع قائمة بجميع التمارين

أنشئ ملف index.html

أنشئ ملف جديد باسم index.html في نفس المجلد:

<!DOCTYPE html>
<html lang="ar" dir="rtl">
<head>
    <meta charset="UTF-8">
    <title>قائمة تمارين إيجاد الخطأ</title>
    <style>
        body {
            font-family: 'Segoe UI', 'Cairo', sans-serif;
            background: linear-gradient(135deg, #667eea, #764ba2);
            padding: 40px;
        }
        .container {
            max-width: 800px;
            margin: 0 auto;
            background: white;
            border-radius: 15px;
            padding: 40px;
        }
        h1 {
            color: #667eea;
            text-align: center;
        }
        .exercise-list {
            list-style: none;
            padding: 0;
        }
        .exercise-item {
            background: #f8f9fa;
            margin: 15px 0;
            border-radius: 10px;
            overflow: hidden;
        }
        .exercise-item a {
            display: block;
            padding: 20px;
            text-decoration: none;
            color: #333;
            transition: all 0.3s;
        }
        .exercise-item a:hover {
            background: #667eea;
            color: white;
            transform: translateX(-10px);
        }
        .level {
            display: inline-block;
            padding: 5px 15px;
            border-radius: 20px;
            font-size: 0.9rem;
            margin-left: 10px;
        }
        .facile { background: #28a745; color: white; }
        .moyen { background: #ffc107; color: #333; }
        .difficile { background: #dc3545; color: white; }
    </style>
</head>
<body>
    <div class="container">
        <h1>📚 تمارين إيجاد الخطأ</h1>
        <ul class="exercise-list">
            <li class="exercise-item">
                <a href="TrouveErreurUltimate.html?exercise=exercices/erreur-div2.json">
                    <span class="level facile">⭐ سهل</span>
                    خطأ في قاعدة القسمة على 2
                </a>
            </li>
            <li class="exercise-item">
                <a href="TrouveErreurUltimate.html?exercise=exercices/erreur-pgcd.json">
                    <span class="level moyen">⭐⭐ متوسط</span>
                    خطأ في PGCD
                </a>
            </li>
            <!-- أضف المزيد من التمارين هنا -->
        </ul>
    </div>
</body>
</html>
            

افتح index.html في المتصفح

الآن لديك صفحة احترافية تعرض جميع تمارينك مع:

✓ مستوى الصعوبة لكل تمرين
✓ عنوان واضح
✓ تصميم جميل
✓ سهولة التنقل

🌐 الطريقة 4: استخدام ملف exercices-index.json (متقدم)

للمواقع الكبيرة مع العديد من التمارين

استخدم المحلل لإنشاء ملف الفهرس

افتح json-analyzer-trouve-erreur.html وحمّل جميع ملفاتك، ثم:

اضغط على زر "إنشاء ملف index.json"
سيتم تحميل ملف exercices-index.json
ضعه مع ملفاتك الأخرى

عدّل Find_error_engine.js

في دالة loadExerciseConfig() (حوالي السطر 41)، أضف هذا الكود:

async function loadExerciseConfig() {
    try {
        // تحميل الفهرس
        const response = await fetch('exercices-index.json');
        const index = await response.json();
        
        // استخراج أسماء الملفات
        exerciseFiles = index.map(item => item.file);
        globalStats.totalExercises = exerciseFiles.length;
        
        // تحميل أول تمرين
        await loadExercise(exerciseFiles[0]);
    } catch (error) {
        console.error('خطأ في تحميل الفهرس:', error);
    }
}
            

⚠️ تحذير:

هذه الطريقة تحتاج خادم ويب محلي أو رفع الملفات على موقع.

🐛 حل المشاكل الشائعة

المشكلة 1: "Fichier non trouvé" أو خطأ 404

تحقق من أن اسم الملف مكتوب بشكل صحيح
تأكد من وجود الملف في المسار الصحيح
انتبه للأحرف الكبيرة والصغيرة

المشكلة 2: الصفحة فارغة

افتح Console في المتصفح (F12)
ابحث عن رسائل الخطأ باللون الأحمر
تحقق من صحة ملف JSON باستخدام المحلل

المشكلة 3: CORS Error

استخدم خادم محلي مثل Live Server
أو ارفع الملفات على موقع
لا يمكن فتح الملفات مباشرة من file:// في بعض الحالات

🔗 روابط سريعة

الطريقة التلقائية تمرين واحد صفحة الفهرس المحلل المولد

🎉 نصيحة أخيرة

للمبتدئين: ابدأ بالطريقة 1 (الوضع التلقائي)
للمتقدمين: استخدم الطريقة 3 (صفحة الفهرس) للمظهر الاحترافي
للاختبار السريع: استخدم الطريقة 2 (تمرين واحد)

الآن أنت جاهز! 🚀
ملفات JSON الخاصة بك يمكن استخدامها بسهولة في أي من الطرق الأربعة أعلاه.