approximations_function/TROUBLESHOOTING_GITHUB_PAGES.md

🔧 Guide de dépannage - GitHub Pages

Votre situation actuelle

Username: tittank1802
Repository: test
Status: Push réussi ✅, mais GitHub Pages pas accessible

---

✅ Étapes pour activer GitHub Pages

Méthode 1: Via l'interface web (Recommandé)

1. Allez sur votre repository:

   https://github.com/tittank1802/test
   

2. Cliquez sur "Settings" (en haut à droite du repository)

3. Dans le menu de gauche, cherchez et cliquez sur "Pages"

4. Sous "Source":

   • Branch: Sélectionnez main (ou master)
   • Folder: Sélectionnez / (root)

5. Cliquez sur "Save"

6. Attendez 2-5 minutes

7. Rafraîchissez la page - Vous verrez:

   Your site is published at https://tittank1802.github.io/test/
   

Méthode 2: Via GitHub CLI

# Si vous avez GitHub CLI installé
gh api repos/tittank1802/test/pages \
  -X POST \
  -f source[branch]=main \
  -f source[path]=/

---

⚠️ Problèmes courants et solutions

1. Repository privé

Symptôme: GitHub Pages n'apparaît pas dans Settings
Solution:

• Le repository doit être Public pour GitHub Pages (compte gratuit)
• Allez dans Settings → "Change repository visibility" → "Make public"

2. "Pages" n'apparaît pas dans le menu

Symptôme: Pas d'option "Pages" dans Settings
Cause: Repository privé sur compte gratuit
Solutions:

• Rendre le repository public, OU
• Passer à GitHub Pro (payant), OU
• Utiliser une alternative (voir ci-dessous)

3. Erreur 404 sur le site

Symptôme: Le lien donne "404 Not Found"
Solutions:

• Attendez 5-10 minutes (premier déploiement)
• Vérifiez que index.html existe à la racine
• Vérifiez l'URL (doit être en minuscules)
• Consultez l'onglet "Actions" pour voir les erreurs

4. Site vide ou cassé

Symptôme: La page charge mais rien ne s'affiche
Solutions:

• Ouvrez la console du navigateur (F12)
• Vérifiez les erreurs JavaScript
• Assurez-vous que mesh_interactive_2d.html et mesh_interactive_3d.html existent

---

🔍 Vérifications à faire

Vérification 1: Repository public ?

# Allez sur: https://github.com/tittank1802/test
# En haut à gauche, voyez-vous "Public" ou "Private" ?

Vérification 2: Fichiers présents ?

cd /root/test
git add mesh_interactive_2d.html mesh_interactive_3d.html
git commit -m "Add mesh visualizations"
git push

Vérification 3: GitHub Actions

1. Allez sur: https://github.com/tittank1802/test/actions
2. Vérifiez s'il y a des erreurs

---

🎯 Solutions alternatives (si GitHub Pages ne fonctionne pas)

Alternative 1: GitHub Gist + htmlpreview.github.io

Avantages: Gratuit, fonctionne avec repository privé, ultra rapide

Étape par étape:

1. Créer un Gist:

   • Allez sur https://gist.github.com/
   • Collez le contenu de index.html
   • Nom: index.html
   • Créez "Public gist"

2. Cliquez sur "Raw" pour obtenir l'URL brute

3. Utilisez htmlpreview.github.io:

   https://htmlpreview.github.io/?https://gist.githubusercontent.com/tittank1802/GIST-ID/raw/index.html
   

4. Répétez pour les autres fichiers

Alternative 2: raw.githack.com

Avantages: Plus rapide que htmlpreview, fonctionne avec repos privés (si lien partagé)

https://raw.githack.com/tittank1802/test/main/index.html
https://raw.githack.com/tittank1802/test/main/mesh_interactive_2d.html
https://raw.githack.com/tittank1802/test/main/mesh_interactive_3d.html

Alternative 3: Netlify Drop

Avantages: Très simple, glisser-déposer

1. Allez sur https://app.netlify.com/drop
2. Glissez-déposez votre dossier /root/test
3. Netlify génère une URL instantanément
4. Gratuit et sans compte nécessaire !

Alternative 4: Vercel

Avantages: Intégration Git, domaine gratuit

# Installer Vercel CLI
npm install -g vercel

# Déployer
cd /root/test
vercel

# Suivre les instructions

Alternative 5: Hébergement local partagé

Si vous voulez juste partager rapidement:

# Déjà en cours d'exécution !
python visualize_http_server.py
# Accessible sur: http://localhost:8000/viewer.html

Puis utilisez ngrok pour partager:

# Installer ngrok
snap install ngrok

# Partager
ngrok http 8000

# Vous obtenez une URL publique comme:
# https://abc123.ngrok.io

---

📋 Checklist de dépannage

Cochez ce que vous avez essayé:

• Repository est public ?
• Settings → Pages accessible ?
• Source configurée à main branch et / folder ?
• Attendu 5-10 minutes ?
• Fichiers HTML poussés sur GitHub ?
• Vérifié l'onglet Actions pour erreurs ?
• Testé les URLs alternatives ci-dessus ?

---

🆘 Commandes de diagnostic

Vérifier le status du repository

cd /root/test
git status
git remote -v

Pousser les fichiers HTML manquants

cd /root/test
git add mesh_interactive_2d.html mesh_interactive_3d.html
git add mesh_2d_*.png mesh_3d_*.png  # Images optionnelles
git commit -m "Add visualization files"
git push

Vérifier la taille des fichiers

ls -lh *.html
# Si > 100 MB, GitHub rejettera

---

💡 Prochaines étapes recommandées

1. Essayez d'abord: Rendre le repository public si privé
2. Si ça ne marche pas: Utilisez raw.githack.com (le plus simple)
3. Pour du long terme: Netlify ou Vercel
4. Pour partager rapidement: ngrok + serveur local

---

📞 Besoin d'aide supplémentaire ?

Dites-moi:

1. Le repository est-il public ou privé ?
2. Voyez-vous l'option "Pages" dans Settings ?
3. Y a-t-il des erreurs dans l'onglet Actions ?

Je pourrai vous guider plus précisément !