fix: add docs

2025-09-13 07:23:32 -06:00 · 2024-11-17 11:07:34 +09:00
parent 8dbd0dc2e0
commit 8752cb0923
11 changed files with 740 additions and 2 deletions
--- a/docs/fr/get-started.md
+++ b/docs/fr/get-started.md
@@ -0,0 +1,84 @@
+# Commencer
+
+Sky Follower Bridge vous aide à trouver et suivre vos connexions 𝕏 (Twitter) sur Bluesky.
+
+<iframe width="100%" height="315" src="https://www.youtube.com/embed/pVqoDv-1uac?si=jKDFFcKQXh61jBdL" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe>
+
+<p style="color: gray; font-size: 0.8em; line-height: 1.4;">Cette vidéo démontre la version Edge. La dernière version de Chrome et les versions récentes de Firefox peuvent se comporter différemment. Un tutoriel vidéo pour Chrome arrive bientôt.</p>
+
+## Installation
+
+Sky Follower Bridge est disponible sur :
+
+- [Chrome Web Store](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko) (Recommandé)
+- [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/sky-follower-bridge/)
+- [Microsoft Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/sky-follower-bridge/dpeolmdblhfolkhlhbhlofkkpaojnnbb)
+
+::: tip
+Nous recommandons d'utiliser la version du Chrome Web Store car elle est toujours à jour. Les versions des autres magasins peuvent être en retard dans les mises à jour.
+:::
+
+## Utilisation
+
+### 1. Naviguez vers 𝕏 (Twitter)
+
+Visitez l'une de ces pages sur X :
+- Votre page de suivi : [x.com/following](https://x.com/following)
+- Votre page des utilisateurs bloqués : [x.com/settings/blocked/all](https://x.com/settings/blocked/all)
+- La page des membres d'une liste publique : `x.com/i/lists/<list_id>/members`
+
+![following-page](/images/following-page.png)
+
+### 2. Lancez Sky Follower Bridge
+
+Appuyez sur `Alt + B` ou cliquez sur l'icône de l'extension dans la barre d'outils de votre navigateur.
+
+::: tip
+Pour les utilisateurs de Firefox, appuyer sur `Alt + B` peut ne pas fonctionner. Dans ce cas, cliquez sur l'icône de l'extension dans la barre d'outils du navigateur.
+
+https://support.mozilla.org/en-US/kb/extensions-button
+:::
+
+![Open Extension](/images/open-extension.png)
+
+### 3. Connectez-vous à Bluesky
+
+Entrez votre identifiant Bluesky (ou email) et [App password](https://bsky.app/settings/app-passwords).
+
+::: tip
+Si vous rencontrez des erreurs de connexion, veuillez consulter le [Guide de dépannage](/troubleshooting).
+:::
+
+![enter-credentials](/images/enter-credentials.png)
+
+### 4. Commencez la recherche
+
+Cliquez sur "Find Bluesky Users" pour commencer le scan. L'extension recherchera des profils Bluesky correspondants en vérifiant l'API de Bluesky.
+
+![find-bluesky-users](/images/scan-users.png)
+
+### 5. Consultez les résultats
+
+Cliquez sur "View Results" pour voir les correspondances potentielles trouvées sur Bluesky.
+
+![view-results-button](/images/click-results.png)
+
+Cela ouvrira la page des options affichant tous les utilisateurs Bluesky détectés.
+
+![options](/images/options.png)
+
+### 6. Suivez les utilisateurs
+
+Cliquez sur le bouton "Follow" à côté de tout utilisateur avec lequel vous souhaitez vous connecter.
+
+![follow](/images/click-follow-btn.png)
+
+ou utilisez le bouton "Follow All" pour suivre tous les utilisateurs détectés en une seule fois.
+
+![follow-all](/images/follow-all-btn.png)
+
+::: warning
+Veuillez noter que le processus de correspondance n'est pas parfait et peut occasionnellement suggérer des correspondances incorrectes. Vérifiez toujours le profil avant de suivre.
+:::
+
+C'est tout ! Profitez de la connexion avec votre communauté sur Bluesky 🎉 
--- a/docs/fr/index.md
+++ b/docs/fr/index.md
@@ -0,0 +1,32 @@
+---
+layout: home
+
+hero:
+  name: "Sky Follower Bridge"
+  text: "Reliez vos réseaux sociaux"
+  tagline: Migrez sans effort vos connexions sociales de 𝕏 à Bluesky
+  actions:
+    - theme: brand
+      text: Get Started
+      link: /fr/get-started
+    - theme: alt
+      text: Troubleshooting
+      link: /fr/troubleshooting
+  image:
+    src: /images/logo.png
+    alt: Image de couverture de Sky Follower Bridge
+
+features:
+  - icon: 🔍
+    title: Correspondance automatique des profils
+    details: Détectez automatiquement les utilisateurs de Bluesky similaires à vos suivis sur 𝕏.
+  - icon: 🚀
+    title: Fonction de suivi en masse
+    details: Gagnez du temps en suivant plusieurs utilisateurs à la fois avec notre bouton "Follow All".
+  - icon: 📋
+    title: Support de plusieurs listes
+    details: Fonctionne avec les listes de suivis, de bloqués et même les listes publiques de 𝕏.
+  - icon: 🌐
+    title: Support multi-navigateurs
+    details: Disponible sur Chrome, Firefox et Microsoft Edge pour votre commodité.
+--- 
--- a/docs/fr/troubleshooting.md
+++ b/docs/fr/troubleshooting.md
@@ -0,0 +1,118 @@
+# Guide de dépannage
+
+## Erreurs d'authentification
+
+### Problèmes de connexion
+
+**Message d'erreur :**  
+<span class="error-message">Error: Invalid identifier or password</span>
+
+**Liste de contrôle :**
+1. Saisie du nom d'utilisateur et du mot de passe
+   - Vérifiez les espaces accidentels
+   - Si vous copiez et collez, assurez-vous qu'aucun caractère supplémentaire n'est inclus
+
+2. Format du nom d'utilisateur
+   - Format correct : `your-username.bsky.social`
+   - Erreur courante : `your-username` (manque .bsky.social)
+
+3. Informations sur le mot de passe
+   - Nous recommandons fortement d'utiliser un [App Password](https://bsky.app/settings/app-passwords) au lieu de votre mot de passe habituel
+   - Format du mot de passe de l'application : `xxxx-xxxx-xxxx-xxxx` (19 caractères)
+
+::: tip Conseils utiles
+Ne confondez pas le App Password avec le "password name" affiché dans les paramètres.
+Comment créer un nouveau App Password :
+2. [Accédez à la section App Passwords](https://bsky.app/settings/app-passwords)
+3. Cliquez sur "Add App Password"
+4. Cliquez sur "Create App Password"
+4. Copiez le mot de passe généré de 19 caractères
+:::
+
+---
+
+### Authentification à deux facteurs requise
+
+**Message d'erreur :**  
+<span class="error-message">Error: Two-factor authentication required</span>
+
+**Solution :**
+1. Vérifiez votre email pour le code d'authentification
+2. Entrez le code dans le champ de saisie 2FA
+3. Essayez de vous reconnecter
+
+## Erreurs de limite de taux
+
+**Message d'erreur :**  
+<span class="error-message">Error: Rate limit error</span>
+
+**Solution :**
+1. L'API de Bluesky a les limites suivantes ([documentation officielle](https://docs.bsky.app/docs/advanced-guides/rate-limits)) :
+   - Jusqu'à 5 000 points par heure (environ 1 666 nouvelles actions)
+   - Jusqu'à 35 000 points par jour
+   - Points par action :
+     - Création : 3 points
+     - Mise à jour : 2 points
+     - Suppression : 1 point
+2. Si vous atteignez la limite, attendez que la limite se réinitialise
+3. Cliquez sur le bouton "Restart" pour réessayer
+
+::: warning
+La version publiée sur Firefox rencontre fréquemment des erreurs de limite de taux. Si vous rencontrez une erreur, essayez sur Chrome.
+:::
+
+::: tip
+La plupart des utilisateurs ne dépasseront pas ces limites lors d'une utilisation normale. Cependant, soyez prudent lorsque vous effectuez des actions en masse comme suivre de nombreux utilisateurs ou aimer de nombreux posts en peu de temps.
+:::
+
+## Erreurs de page
+
+### Page invalide
+
+**Message d'erreur :**  
+<span class="error-message">Error: Invalid page. please open the 𝕏 following or blocking or list page.</span>
+
+**Solution :**
+Utilisez l'extension uniquement sur ces pages 𝕏 (Twitter) :
+- Page de suivi ([x.com/following](https://x.com/following))
+- Page de blocage ([x.com/settings/blocked/all](https://x.com/settings/blocked/all))
+- Page des membres de la liste (`x.com/i/lists/<list_id>/members`)
+
+ou vérifiez les permissions de votre extension sur la page des extensions.
+Les permissions du site devraient être comme ci-dessous :
+
+<img src="/images/site_permissions.png" alt="site permissions" width="500"/>
+
+## Problèmes de scan
+
+### Le scan s'arrête trop tôt
+
+Le scan s'arrête avant d'atteindre le bas de la page
+
+**Solution :**
+1. Cliquez sur "Resume Scanning" pour continuer
+2. Le scan s'arrêtera automatiquement lorsqu'il atteindra le bas de la page
+3. Vous pouvez cliquer sur "Stop Scanning and View Results" à tout moment
+
+### Aucun utilisateur trouvé
+
+Aucun utilisateur Bluesky détecté après le scan
+
+**Solution :**
+1. Assurez-vous que vous êtes correctement connecté
+2. Essayez de scanner à nouveau - certains utilisateurs peuvent ne pas être détectés au premier passage
+3. Vérifiez si les utilisateurs de 𝕏 ont lié leurs comptes Bluesky dans leurs profils
+
+## Autres problèmes
+
+Si vous rencontrez des erreurs inattendues :
+
+1. Rechargez la page
+2. Essayez à nouveau l'opération
+3. Si le problème persiste, vous pouvez :
+   - [Créer un problème](https://github.com/kawamataryo/sky-follower-bridge/issues) avec :
+     - Le message d'erreur exact
+     - Ce que vous essayiez de faire
+     - Le type et la version de votre navigateur
+     - Toutes captures d'écran pertinentes
+   - Ou mentionner [@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social) sur Bluesky