diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 3f64990..b90a51c 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -138,6 +138,18 @@ export default defineConfig({ { text: "Guia de Solução de Problemas", link: "/pt/troubleshooting" }, ], } + }, + es: { + label: "Español", + lang: "es", + link: "/es/", + themeConfig: { + nav: [ + { text: "Inicio", link: "/" }, + { text: "Comenzando", link: "/es/get-started" }, + { text: "Guía de solución de problemas", link: "/es/troubleshooting" }, + ], + } } } }); diff --git a/docs/es/get-started.md b/docs/es/get-started.md new file mode 100644 index 0000000..be43954 --- /dev/null +++ b/docs/es/get-started.md @@ -0,0 +1,84 @@ +# Comenzando + +Sky Follower Bridge te ayuda a encontrar y seguir tus conexiones de 𝕏 (Twitter) en Bluesky. + + + +

Este video demuestra la versión de Edge. La última versión de Chrome y las versiones recientes de Firefox pueden comportarse de manera diferente. Un tutorial en video para Chrome estará disponible pronto.

+ +## Instalación + +Sky Follower Bridge está disponible en: + +- [Chrome Web Store](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko) (Recomendado) +- [Complementos de Firefox](https://addons.mozilla.org/en-US/firefox/addon/sky-follower-bridge/) +- [Complementos de Microsoft Edge](https://microsoftedge.microsoft.com/addons/detail/sky-follower-bridge/dpeolmdblhfolkhlhbhlofkkpaojnnbb) + +::: tip +Recomendamos usar la versión de Chrome Web Store ya que siempre está actualizada. Las versiones de otras tiendas pueden retrasarse en las actualizaciones. +::: + +## Uso + +### 1. Navega a 𝕏 (Twitter) + +Visita cualquiera de estas páginas en X: +- Tu página de Seguidos: [x.com/following](https://x.com/following) +- Tu página de Usuarios bloqueados: [x.com/settings/blocked/all](https://x.com/settings/blocked/all) +- La página de Miembros de una Lista pública: `x.com/i/lists//members` + +![following-page](/images/following-page.png) + +### 2. Inicia Sky Follower Bridge + +Presiona `Alt + B` o haz clic en el ícono de la extensión en la barra de herramientas de tu navegador. + +::: tip +Para los usuarios de Firefox, presionar `Alt + B` puede no funcionar. En ese caso, haz clic en el ícono de la extensión en la barra de herramientas del navegador. + +https://support.mozilla.org/en-US/kb/extensions-button +::: + +![Open Extension](/images/open-extension.png) + +### 3. Inicia sesión en Bluesky + +Ingresa tu identificador de Bluesky (o correo electrónico) y [Contraseña de la aplicación](https://bsky.app/settings/app-passwords). + +::: tip +Si encuentras errores de inicio de sesión, consulta la [Guía de solución de problemas](/troubleshooting). +::: + +![enter-credentials](/images/enter-credentials.png) + +### 4. Inicia la búsqueda + +Haz clic en "Buscar usuarios de Bluesky" para comenzar a escanear. La extensión buscará perfiles de Bluesky coincidentes verificando la API de Bluesky. + +![find-bluesky-users](/images/scan-users.png) + +### 5. Revisa los resultados + +Haz clic en "Ver resultados" para ver las posibles coincidencias encontradas en Bluesky. + +![view-results-button](/images/click-results.png) + +Esto abrirá la página de opciones mostrando todos los usuarios de Bluesky detectados. + +![options](/images/options.png) + +### 6. Sigue a los usuarios + +Haz clic en el botón "Seguir" junto a cualquier usuario con el que desees conectarte. + +![follow](/images/click-follow-btn.png) + +o usa el botón "Seguir a todos" para seguir a todos los usuarios detectados de una vez. + +![follow-all](/images/follow-all-btn.png) + +::: warning +Ten en cuenta que el proceso de coincidencia no es perfecto y puede sugerir coincidencias incorrectas ocasionalmente. Siempre verifica el perfil antes de seguir. +::: + +¡Eso es todo! Disfruta conectándote con tu comunidad en Bluesky 🎉 diff --git a/docs/es/index.md b/docs/es/index.md new file mode 100644 index 0000000..ef67f77 --- /dev/null +++ b/docs/es/index.md @@ -0,0 +1,32 @@ +--- +layout: home + +hero: + name: "Sky Follower Bridge" + text: "Conecta tus redes sociales" + tagline: Migra sin problemas tus conexiones sociales de 𝕏 a Bluesky + actions: + - theme: brand + text: Comenzar + link: /es/get-started + - theme: alt + text: Solución de problemas + link: /es/troubleshooting + image: + src: /images/logo.png + alt: Imagen de portada de Sky Follower Bridge + +features: + - icon: 🔍 + title: Detección automática de perfiles + details: Detecta automáticamente usuarios de Bluesky similares a tus seguidos en 𝕏. + - icon: 🚀 + title: Función de seguimiento masivo + details: Ahorra tiempo siguiendo a múltiples usuarios a la vez con nuestro botón "Seguir a todos". + - icon: 📋 + title: Soporte para múltiples listas + details: Funciona con listas de Seguidos, Seguidores, Usuarios bloqueados e incluso listas públicas de 𝕏. + - icon: 🌐 + title: Soporte multiplataforma + details: Disponible en Chrome, Firefox y Microsoft Edge para tu conveniencia. +--- diff --git a/docs/es/troubleshooting.md b/docs/es/troubleshooting.md new file mode 100644 index 0000000..f2f785e --- /dev/null +++ b/docs/es/troubleshooting.md @@ -0,0 +1,118 @@ +# Guía de solución de problemas + +## Errores de autenticación + +### Problemas de inicio de sesión + +**Mensaje de error:** +Error: Invalid identifier or password + +**Lista de verificación:** +1. Entrada de nombre de usuario y contraseña + - Verifica si hay espacios accidentales + - Si copias y pegas, asegúrate de que no se incluyan caracteres adicionales + +2. Formato del nombre de usuario + - Formato correcto: `tu-usuario.bsky.social` + - Error común: `tu-usuario` (falta .bsky.social) + +3. Información de la contraseña + - Recomendamos encarecidamente usar una [Contraseña de la aplicación](https://bsky.app/settings/app-passwords) en lugar de tu contraseña regular + - Formato de la contraseña de la aplicación: `xxxx-xxxx-xxxx-xxxx` (19 caracteres) + +::: tip Consejos útiles +No confundas la Contraseña de la aplicación con el "nombre de la contraseña" que se muestra en la configuración. +Cómo crear una nueva Contraseña de la aplicación: +2. [Navega a la sección de Contraseñas de la aplicación](https://bsky.app/settings/app-passwords) +3. Haz clic en "Agregar Contraseña de la aplicación" +4. Haz clic en "Crear Contraseña de la aplicación" +4. Copia la contraseña generada de 19 caracteres +::: + +--- + +### Se requiere autenticación de dos factores + +**Mensaje de error:** +Error: Two-factor authentication required + +**Solución:** +1. Revisa tu correo electrónico para obtener el código de autenticación +2. Ingresa el código en el campo de entrada de 2FA +3. Intenta iniciar sesión nuevamente + +## Errores de límite de tasa + +**Mensaje de error:** +Error: Rate limit error + +**Solución:** +1. La API de Bluesky tiene los siguientes límites ([documentación oficial](https://docs.bsky.app/docs/advanced-guides/rate-limits)): + - Hasta 5,000 puntos por hora (aproximadamente 1,666 acciones nuevas) + - Hasta 35,000 puntos por día + - Puntos por acción: + - Crear: 3 puntos + - Actualizar: 2 puntos + - Eliminar: 1 punto +2. Si alcanzas el límite, espera hasta que se restablezca +3. Haz clic en el botón "Reiniciar" para intentarlo de nuevo + +::: warning +La versión publicada en Firefox frecuentemente encuentra errores de límite de tasa. Si encuentras un error, intenta en Chrome. +::: + +::: tip +La mayoría de los usuarios no alcanzarán estos límites durante el uso normal. Sin embargo, ten cuidado al realizar acciones masivas como seguir a muchos usuarios o dar me gusta a muchas publicaciones en un corto período. +::: + +## Errores de página + +### Página inválida + +**Mensaje de error:** +Error: Invalid page. please open the 𝕏 following or blocking or list page. + +**Solución:** +Usa la extensión solo en estas páginas de 𝕏 (Twitter): +- Página de seguidos ([x.com/following](https://x.com/following)) +- Página de bloqueados ([x.com/settings/blocked/all](https://x.com/settings/blocked/all)) +- Página de miembros de lista (`x.com/i/lists//members`) + +o verifica los permisos de tu extensión en la página de extensiones. +Los permisos del sitio deben ser como se muestra a continuación: + +permisos del sitio + +## Problemas de escaneo + +### El escaneo se detiene temprano + +El escaneo se detiene antes de llegar al final de la página + +**Solución:** +1. Haz clic en "Reanudar escaneo" para continuar +2. El escaneo se detendrá automáticamente cuando llegue al final de la página +3. Puedes hacer clic en "Detener escaneo y ver resultados" en cualquier momento + +### No se encontraron usuarios + +No se detectaron usuarios de Bluesky después del escaneo + +**Solución:** +1. Asegúrate de haber iniciado sesión correctamente +2. Intenta escanear de nuevo - algunos usuarios pueden no ser detectados en el primer intento +3. Verifica si los usuarios de 𝕏 han vinculado sus cuentas de Bluesky en sus perfiles + +## Otros problemas + +Si encuentras errores inesperados: + +1. Recarga la página +2. Intenta la operación nuevamente +3. Si el problema persiste, puedes: + - [Crear un problema](https://github.com/kawamataryo/sky-follower-bridge/issues) con: + - El mensaje de error exacto + - Lo que estabas intentando hacer + - Tu tipo y versión de navegador + - Cualquier captura de pantalla relevante + - O mencionar a [@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social) en Bluesky