Spaces:
Sleeping
Sleeping
Download make_user_guide.py from MAALOUFimad02/IAacademy: direct link, hf CLI and curl.
- Browser
- Download file 21.4 kB
-
https://huggingface.co/spaces/MAALOUFimad02/IAacademy/resolve/main/make_user_guide.py
- Command line
-
hf download hf://spaces/MAALOUFimad02/IAacademy/make_user_guide.py
-
curl -L -o make_user_guide.py https://huggingface.co/spaces/MAALOUFimad02/IAacademy/resolve/main/make_user_guide.py
21.4 kB
| """Guide public : uniquement le parcours d’utilisation des apprenants.""" | |
| from pathlib import Path | |
| R=Path(__file__).resolve().parent | |
| page='''<!doctype html><html lang="fr"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>IA Academy — Guide d’utilisation</title><meta http-equiv="Content-Security-Policy" content="default-src 'none'; style-src 'unsafe-inline'; script-src 'unsafe-inline';"><style> | |
| :root{color-scheme:dark;--bg:#091222;--panel:#13223a;--line:#3e5679;--ink:#eef4ff;--muted:#c5d2e8;--mint:#a2eedb;--accent:#b7c9ff}*{box-sizing:border-box}html{scroll-behavior:smooth;scroll-padding-top:20px}body{margin:0;background:var(--bg);color:var(--ink);font:16px/1.85 system-ui,sans-serif}nav{position:fixed;width:245px;inset:0 auto 0 0;background:#0e1b30;border-right:1px solid var(--line);padding:28px 20px;overflow:auto}nav strong{font-size:25px;display:block}nav small{font-size:11px;letter-spacing:2px;color:var(--mint)}nav a{display:block;margin:6px 0;padding:8px 10px;color:#c5d5ef;text-decoration:none;border-radius:9px}nav a:hover{background:#243b60;color:white}a:focus-visible,button:focus-visible,summary:focus-visible{outline:3px solid #c6d3ff;outline-offset:3px}main{max-width:1180px;margin-left:245px;padding:30px 4vw 75px}header{padding:32px;background:linear-gradient(125deg,#1c3357,#34375f);border:1px solid #687ca5;border-radius:20px;position:relative;overflow:hidden}header:after{content:'';position:absolute;right:-50px;top:-75px;width:220px;height:220px;border-radius:50%;background:#c5b4ff13;animation:drift 8s ease-in-out infinite alternate;pointer-events:none}h1{font-size:39px;line-height:1.2;letter-spacing:-1px;margin:15px 0}h2{font-size:26px;line-height:1.4;margin-top:0;color:#f5f8ff}h3{font-size:20px;line-height:1.45;color:#e6edff}p,li{color:var(--muted)}b,strong{color:#f1f6ff}section{padding:28px;margin:24px 0;border:1px solid var(--line);border-radius:17px;background:var(--panel);animation:enter .4s ease-out}a{color:var(--accent);text-underline-offset:4px}.tag{color:var(--mint);font-size:11px;font-weight:800;letter-spacing:2px}.cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(190px,1fr));gap:14px}.mini{padding:18px;background:#0f1c32;border:1px solid #496286;border-radius:13px}.mini .icon{font-size:28px;display:block;margin-bottom:6px}.mini h3{margin:7px 0}.mini p{margin:8px 0}.steps{list-style:none;padding:0;counter-reset:step}.steps>li{padding:12px 0 12px 48px;position:relative;border-bottom:1px solid #3b5274}.steps>li:before{counter-increment:step;content:counter(step);display:grid;place-items:center;position:absolute;left:0;top:14px;width:30px;height:30px;border-radius:9px;background:#40579c;color:white;font-weight:750}.callout{padding:16px 19px;background:#1a3445;border-left:4px solid var(--mint);border-radius:10px;margin:18px 0;color:#d4efe8}.tip{background:#243154;border-color:#b2bfff;color:#dce4ff}.route{display:flex;flex-wrap:wrap;gap:10px;margin:20px 0}.route span{padding:8px 13px;background:#152942;border:1px solid #6481aa;border-radius:40px;font-size:13px;color:#dce8ff}details{border:1px solid #4b668b;border-radius:11px;padding:14px 17px;margin:12px 0}summary{cursor:pointer;font-weight:700;color:#c8d8ff}details p{margin-bottom:4px}code{background:#0a1427;color:#c1f2e4;border-radius:5px;padding:2px 6px;font-size:.92em}table{border-collapse:collapse;width:100%;margin:16px 0}td,th{border:1px solid #496286;padding:12px;text-align:left;vertical-align:top}th{background:#233b5e}td{color:#c9d7ed}.checks label{display:block;padding:10px 4px;border-bottom:1px solid #3b5274}.checks input{accent-color:#9ce7d5;margin-right:10px}button{padding:10px 16px;border:1px solid #93a9db;border-radius:9px;background:#2c4777;color:white;font:inherit;cursor:pointer}.diagram{overflow-x:auto;padding:12px;background:#0a172a;border:1px solid #496286;border-radius:13px}.diagram svg{width:100%;min-width:500px;max-height:225px;display:block}.diagram text{fill:#e5efff;font:14px system-ui}.flow{stroke-dasharray:7 6;animation:flow 2s linear infinite}.footer{font-size:12px;color:#a8bad5}@keyframes flow{to{stroke-dashoffset:-26}}@keyframes drift{to{transform:translate(-45px,35px)}}@keyframes enter{from{opacity:.4;transform:translateY(5px)}to{opacity:1;transform:none}}@media(prefers-reduced-motion:reduce){*{animation:none!important;scroll-behavior:auto!important}}@media(max-width:850px){nav{position:static;width:auto;border-right:0;border-bottom:1px solid var(--line)}nav a{display:inline-block;margin:2px;padding:6px 9px;font-size:14px}main{margin:0;padding:18px}h1{font-size:32px}header,section{padding:21px}.cards{grid-template-columns:1fr}table{display:block;overflow:auto}}@media print{nav,button{display:none}main{margin:0;padding:0}body,section,header{background:white;color:black}p,li,h1,h2,h3,strong,b,td,a{color:black}section{break-inside:avoid}} | |
| </style></head><body><nav><small>LE COMPAGNON DE VOTRE PARCOURS</small><strong>IA Academy</strong><p>Guide d’utilisation</p><a href="#start">01 · Commencer</a><a href="#account">02 · Mon compte</a><a href="#courses">03 · Lire un cours</a><a href="#videos">04 · Regarder les vidéos</a><a href="#practice">05 · Notebooks et Colab</a><a href="#quiz">06 · Quiz et examen</a><a href="#progress">07 · Suivre ma progression</a><a href="#help">08 · Obtenir de l’aide</a><a href="#check">Mon premier parcours</a></nav><main> | |
| <header><div class="tag">VOTRE GUIDE · APPRENDRE À VOTRE RYTHME</div><h1>Un cours. Une expérience.<br>Un pas de plus.</h1><p>Choisissez votre parcours, comprenez les explications en images, pratiquez dans un notebook et vérifiez vos connaissances. Ce guide vous accompagne dans les fonctions de votre espace d’apprentissage.</p><div class="route"><span>Choisir</span><span>Comprendre</span><span>Pratiquer</span><span>Se vérifier</span><span>Progresser</span></div></header> | |
| <section id="start"><div class="tag">01 · TROUVER SON POINT DE DÉPART</div><h2>Commencer avec le bon parcours</h2><p>Vous pouvez consulter les cours sans créer de compte. Un compte permet de conserver votre progression, vos notes, vos réponses et vos travaux.</p><ol class="steps"><li>Ouvrez <b>Explorer & apprendre</b>.</li><li>Choisissez une <b>branche</b>, puis un <b>parcours</b>. Une branche regroupe des sujets proches ; le parcours organise vos leçons dans un ordre guidé.</li><li>Lisez le niveau et les prérequis. Choisissez la première <b>leçon</b> du plan.</li><li>Si vous débutez, commencez par <b>Initiation à l’IA</b>, puis poursuivez avec <b>Python & Data</b>.</li></ol><div class="cards"><div class="mini"><span class="icon">◉</span><h3>Je découvre l’IA</h3><p>Comprenez les mots, les tâches, les données et les limites avant de choisir un outil.</p></div><div class="mini"><span class="icon">▦</span><h3>Je veux pratiquer</h3><p>Travaillez Python, les tableaux, la visualisation et les premiers modèles avec les exemples du cours.</p></div><div class="mini"><span class="icon">⌁</span><h3>Je choisis une spécialité</h3><p>Explorez ensuite le Machine Learning, les réseaux, la vision ou le traitement du langage selon les prérequis.</p></div></div><div class="callout">Si la liste semble vide, effacez votre recherche, vérifiez la branche choisie puis cliquez sur <b>Actualiser le catalogue</b>.</div></section> | |
| <section id="account"><div class="tag">02 · RETROUVER SON TRAVAIL</div><h2>Créer et utiliser mon compte</h2><ol class="steps"><li>Ouvrez <b>Mon espace</b>, puis <b>Créer un compte apprenant</b>.</li><li>Renseignez votre nom affiché, votre adresse email et un mot de passe d’au moins <b>10 caractères</b>.</li><li>Après la création, saisissez vos identifiants dans le formulaire de connexion et cliquez sur <b>Se connecter</b>.</li><li>Pour changer votre mot de passe, ouvrez <b>Changer mon mot de passe</b> et saisissez l’ancien puis le nouveau.</li><li>Sur un ordinateur partagé, utilisez <b>Se déconnecter</b> lorsque vous avez terminé.</li></ol><p>La consultation libre ne conserve pas vos progrès personnels. Connectez-vous avant d’enregistrer des notes, un quiz ou un dépôt.</p><div class="callout tip">Si vous avez oublié votre mot de passe, contactez votre formateur pour demander sa réinitialisation. Aucun bouton de récupération automatique par email n’est prévu dans cette version.</div></section> | |
| <section id="courses"><div class="tag">03 · APPRENDRE EN COMPRENANT</div><h2>Lire un cours et manipuler ses illustrations</h2><p>Dans l’onglet <b>Cours</b>, la lecture guidée présente une séquence à la fois. Chaque séquence relie une idée à un schéma, une formule, un exemple et un exercice.</p><table><tr><th>Action</th><th>Ce qu’elle permet</th></tr><tr><td>Sélectionner une séquence dans la barre du cours</td><td>Rejoindre directement un sujet de la leçon.</td></tr><tr><td><b>Étape suivante</b></td><td>Dérouler l’explication du schéma, un mécanisme à la fois.</td></tr><tr><td><b>Animer les étapes</b></td><td>Lancer puis arrêter le déroulement automatique des étapes.</td></tr><tr><td><b>Tout afficher</b></td><td>Lire toutes les séquences de la leçon à la suite.</td></tr><tr><td><b>Vérifier mon raisonnement</b></td><td>Ouvrir la correction de l’exercice après avoir essayé.</td></tr><tr><td><b>Réduire les animations</b></td><td>Diminuer les mouvements. La préférence de réduction des mouvements du navigateur est également respectée.</td></tr></table><h3>Retrouver les explications complètes</h3><p>Dépliez <b>Cours complet et approfondissements mathématiques</b> pour lire le texte complet et les développements. Dépliez <b>Manipuler le concept · simulateur interactif</b> pour modifier les paramètres d’une illustration disponible. Les schémas emploient des exemples pédagogiques : ils ne représentent pas automatiquement les résultats de votre propre expérience.</p><p>Si le cours est proposé en <b>PDF</b> ou en <b>HTML</b>, son document apparaît dans la leçon. Un téléchargement est proposé pour le document original lorsqu’il est associé. Sur petit écran, certains tableaux ou schémas se parcourent horizontalement.</p><div class="callout">Naviguer dans les séquences ne marque pas automatiquement une leçon comme terminée. À la fin de votre lecture, utilisez <b>Marquer la lecture terminée</b>. Le bouton <b>Leçon suivante →</b> vous fait avancer dans le parcours.</div></section> | |
| <section id="videos"><div class="tag">04 · REGARDER AVEC UN OBJECTIF</div><h2>Utiliser les vidéos de chaque séquence</h2><ol class="steps"><li>Lisez l’explication et la question indiquée sous <b>Pendant la vidéo</b>.</li><li>Cliquez sur <b>Charger la vidéo de cette partie</b>. Le lecteur se charge à ce moment ; certains liens commencent au chapitre utile.</li><li>Utilisez les commandes du lecteur pour mettre en pause, revenir en arrière ou choisir les sous-titres disponibles.</li><li>Revenez à l’exercice : expliquez le mécanisme avec vos propres mots avant de consulter la correction.</li></ol><p>L’onglet <b>Vidéos</b> rassemble aussi les liens associés à la leçon et, lorsqu’elle existe, la vidéo du formateur. Plusieurs séquences peuvent partager une vidéo avec un objectif différent.</p><div class="callout tip">Les vidéos externes sélectionnées sont en anglais ; les cours et exercices sont en français. Les sous-titres et la lecture intégrée dépendent de la vidéo. Si le lecteur ne fonctionne pas, utilisez <b>Ouvrir sur YouTube</b>.</div></section> | |
| <section id="practice"><div class="tag">05 · PASSER DE L’IDÉE AU RÉSULTAT</div><h2>Travailler dans un notebook avec Google Colab</h2><p>Ouvrez <b>Pratique & fichiers</b>. Le notebook apprenant contient un plan, des consignes, des cellules <code>TODO</code>, des contrôles et des interprétations à rédiger. Le code s’exécute dans Colab ou dans votre environnement Jupyter.</p><div class="diagram"><svg viewBox="0 0 650 190" role="img" aria-label="Parcours du notebook : ouvrir, compléter, contrôler, déposer"><rect x="15" y="35" width="140" height="90" rx="13" fill="#233b60" stroke="#829cd1"/><rect x="175" y="35" width="140" height="90" rx="13" fill="#234554" stroke="#93ddcb"/><rect x="335" y="35" width="140" height="90" rx="13" fill="#233b60" stroke="#829cd1"/><rect x="495" y="35" width="140" height="90" rx="13" fill="#234554" stroke="#93ddcb"/><path class="flow" d="M155 80H175 M315 80H335 M475 80H495" stroke="#b7d0ee" stroke-width="3"/><text x="35" y="75">1. Ouvrir</text><text x="35" y="100">dans Colab</text><text x="195" y="75">2. Compléter</text><text x="195" y="100">les cellules</text><text x="355" y="75">3. Exécuter</text><text x="355" y="100">les contrôles</text><text x="515" y="75">4. Déposer</text><text x="515" y="100">le notebook</text><text x="17" y="164">Puis lire le retour du formateur et améliorer votre raisonnement.</text></svg></div><ol class="steps"><li>Cliquez sur <b>Ouvrir mon notebook dans Google Colab</b>. Une connexion Google peut être demandée.</li><li>Enregistrez une copie dans votre espace Google Drive si nécessaire, pour travailler sur votre propre version.</li><li>Lisez les consignes et remplacez les cellules <code>TODO</code>. Exécutez les cellules dans l’ordre, en commençant par les imports.</li><li>Lancez les cellules de contrôle. Une erreur est un indice à comprendre : vérifiez les noms, les formes des tableaux, les unités et les résultats attendus.</li><li>Complétez les cellules d’interprétation. Une sortie numérique seule ne suffit pas : expliquez ce qu’elle signifie et ses limites.</li><li>Dans Colab, utilisez <b>Fichier → Télécharger → Télécharger le fichier .ipynb</b>.</li><li>De retour dans <b>Pratique & fichiers</b>, choisissez votre fichier puis cliquez sur <b>Déposer mon notebook pour validation</b>.</li><li>Cliquez sur <b>Voir mes évaluations de notebooks</b> pour consulter la décision et le commentaire. Si un travail est à reprendre, corrigez-le puis déposez une nouvelle version.</li></ol><p>Après validation du travail par le formateur, utilisez <b>Consulter le corrigé après validation</b>. Le contrôle automatique du dépôt vérifie sa structure et ses sorties enregistrées ; il ne réexécute pas votre code et ne remplace pas l’examen de votre raisonnement.</p><details><summary>Le lien Colab ne charge pas le notebook.</summary><p>Téléchargez le notebook apprenant puis importez-le dans Colab. Vérifiez votre connexion et l’accès à la source. Un notebook doit pouvoir être lu par Colab pour s’ouvrir directement.</p></details><details><summary>À quoi sert l’expérience interactive de régression ?</summary><p>Elle permet de lancer un petit calcul sur des données synthétiques et d’observer les erreurs d’apprentissage. Choisissez le nombre de mises à jour et le pas, puis lancez l’expérience. Le calcul peut attendre une ressource et dépend de votre quota disponible. Il est facultatif et ne remplace pas le travail dans le notebook.</p></details></section> | |
| <section id="quiz"><div class="tag">06 · APPRENDRE DE SES RÉPONSES</div><h2>Un quiz qui avance avec vous</h2><h3>10 questions pour chaque partie</h3><ol class="steps"><li>Dans l’onglet <b>Quiz</b>, lisez la question puis cliquez sur une carte de réponse.</li><li>Cliquez sur <b>Valider et continuer →</b>. Votre réponse est enregistrée et la question suivante s’affiche automatiquement.</li><li>Relisez le retour de la question précédente, affiché au-dessus de la nouvelle question. Les numéros cochés indiquent les réponses déjà validées.</li><li>Cliquez sur un numéro pour revenir à une question. Après la dixième réponse, ouvrez les corrections dans le bilan.</li></ol><p>Le bouton <b>Recommencer le quiz</b> ouvre un nouvel entraînement. Vos réponses ne sont pas validées lorsque vous les sélectionnez seulement : utilisez le bouton de validation. Une connexion est nécessaire pour enregistrer les résultats.</p><h3>50 questions pour l’examen du module</h3><p>Cliquez sur <b>Commencer une nouvelle tentative</b>. Choisissez une réponse puis <b>Valider et continuer →</b> pour avancer. La grille affiche les 50 numéros. Vous pouvez revenir à une réponse et la modifier avant la validation finale ; cliquez ensuite sur <b>Valider et continuer →</b> ou <b>Enregistrer sans avancer</b> pour conserver cette modification.</p><p>Une fois les 50 réponses enregistrées, cliquez sur <b>Terminer et voir mes résultats</b>. Les corrections apparaissent alors dans un bilan dépliable. L’objectif pédagogique est de <b>35 bonnes réponses sur 50</b>, soit 70 %. Ce résultat n’est pas une certification accréditée.</p><div class="callout">Gardez la page ouverte pendant la tentative. Changer de module, actualiser la page ou se déconnecter retire la tentative de l’écran : cette version ne propose pas de bouton pour rouvrir une ancienne tentative. Les réponses déjà enregistrées restent liées à leur compte d’origine.</div><h3>Adapter les animations</h3><p>Le bouton en haut de la plateforme permet de mettre les animations en pause. La préférence de mouvement réduit de votre appareil est également respectée. Les animations n’ont aucune incidence sur la note.</p></section> | |
| <section id="progress"><div class="tag">07 · CONSTRUIRE SES PROPRES REPÈRES</div><h2>Mes notes et ma progression</h2><p>Dans <b>Mes notes</b>, écrivez une définition avec vos mots, une question ou l’interprétation d’un résultat. Cliquez sur <b>Enregistrer mes notes</b> avant de changer de leçon. Ces notes sont liées à votre compte.</p><p>À la fin d’une lecture, utilisez <b>Marquer la lecture terminée</b>. Dans <b>Mon espace</b>, cliquez sur <b>Afficher ma progression</b> pour retrouver le suivi des leçons et des quiz. Le suivi de lecture n’est pas une preuve automatique de maîtrise : utilisez aussi les exercices et les corrections.</p><div class="checks"><label><input type="checkbox"> Je sais expliquer l’idée principale sans recopier.</label><label><input type="checkbox"> J’ai refait le calcul ou l’exemple proposé.</label><label><input type="checkbox"> J’ai compris mes erreurs de quiz.</label><label><input type="checkbox"> J’ai écrit une limite ou une question à approfondir.</label></div><p class="footer">Cette liste est un aide-mémoire local au guide ; elle n’enregistre pas la progression de votre compte.</p></section> | |
| <section id="help"><div class="tag">08 · DÉBLOQUER UNE DIFFICULTÉ</div><h2>Demander de l’aide utilement</h2><p>Dans <b>Mon espace</b>, utilisez <b>Question ou retour au formateur</b>, puis <b>Envoyer au formateur</b>. Indiquez le titre de la leçon, l’étape concernée, ce que vous avez essayé et le message d’erreur utile. Ne transmettez pas votre mot de passe.</p><details><summary>Je ne retrouve pas mes notes ou mes résultats.</summary><p>Vérifiez que vous êtes connecté au même compte, puis ouvrez la bonne leçon ou actualisez votre progression. La lecture libre sans connexion ne conserve pas ce suivi.</p></details><details><summary>Le contenu semble trop grand sur mon téléphone.</summary><p>Parcourez les séquences une à une et faites glisser horizontalement les schémas ou tableaux qui le demandent. Les longs cours et guides peuvent aussi défiler à l’intérieur de leur cadre.</p></details><details><summary>Le PDF ne s’affiche pas.</summary><p>Utilisez le téléchargement du document original et ouvrez-le avec le lecteur de votre appareil.</p></details><details><summary>La validation de l’examen est refusée.</summary><p>Vérifiez que les 50 réponses ont été enregistrées. Une sélection non enregistrée ou un simple changement de question ne compte pas comme une réponse sauvegardée.</p></details></section> | |
| <section id="check"><h2>Mon premier parcours, pas à pas</h2><div class="checks"><label><input type="checkbox"> Je crée mon compte et je me connecte.</label><label><input type="checkbox"> Je choisis une première leçon adaptée à mon niveau.</label><label><input type="checkbox"> Je lis une séquence, manipule le schéma et essaie l’exercice.</label><label><input type="checkbox"> Je regarde la vidéo avec la question de visionnage.</label><label><input type="checkbox"> Je réponds au quiz et relis les corrections.</label><label><input type="checkbox"> Je pratique dans Colab lorsque le notebook est proposé.</label><label><input type="checkbox"> J’enregistre mes notes et marque ma lecture terminée.</label></div><p>Avancez selon votre compréhension. Revenir sur une explication après un exercice difficile fait partie de l’apprentissage.</p><button id="top">Revenir au début</button></section><p class="footer">IA Academy · Guide public d’utilisation · Cours en français, vidéos externes selon disponibilité.</p></main><script>document.querySelector('#top').onclick=()=>window.scrollTo({top:0,behavior:matchMedia('(prefers-reduced-motion: reduce)').matches?'auto':'smooth'});</script></body></html>''' | |
| (R/'Guide_Utilisateur.html').write_text(page,encoding='utf8') | |
| # Remplace également l’ancien nom public : aucune copie du manuel propriétaire. | |
| (R/'Guide_IA_Academy.html').write_text(page,encoding='utf8') | |
| print('Public learner guide generated; legacy public filename now contains learner content only.') | |