diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index ca6c7c0..d0a283c 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -90,6 +90,18 @@ export default defineConfig({ { text: "トラブルシューティング", link: "/ja/troubleshooting" }, ], } + }, + it: { + label: "Italiano", + lang: "it", + link: "/it/", + themeConfig: { + nav: [ + { text: "Home", link: "/" }, + { text: "Iniziare", link: "/it/get-started" }, + { text: "Risoluzione dei problemi", link: "/it/troubleshooting" }, + ], + } } } }); diff --git a/docs/it/get-started.md b/docs/it/get-started.md new file mode 100644 index 0000000..491068c --- /dev/null +++ b/docs/it/get-started.md @@ -0,0 +1,84 @@ +# Iniziare + +Sky Follower Bridge ti aiuta a trovare e seguire le tue connessioni su 𝕏 (Twitter) su Bluesky. + + + +

Questo video dimostra la versione Edge. La versione più recente di Chrome e le versioni recenti di Firefox potrebbero comportarsi diversamente. Un tutorial video per Chrome è in arrivo.

+ +## Installazione + +Sky Follower Bridge è disponibile su: + +- [Chrome Web Store](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko) (Consigliato) +- [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 +Consigliamo di utilizzare la versione del Chrome Web Store poiché è sempre aggiornata. Le versioni di altri store potrebbero essere in ritardo con gli aggiornamenti. +::: + +## Utilizzo + +### 1. Naviga su 𝕏 (Twitter) + +Visita una di queste pagine su X: +- La tua pagina dei seguiti: [x.com/following](https://x.com/following) +- La tua pagina degli utenti bloccati: [x.com/settings/blocked/all](https://x.com/settings/blocked/all) +- La pagina dei membri di una lista pubblica: `x.com/i/lists//members` + +![following-page](/images/following-page.png) + +### 2. Avvia Sky Follower Bridge + +Premi `Alt + B` o fai clic sull'icona dell'estensione nella barra degli strumenti del browser. + +::: tip +Per gli utenti di Firefox, premere `Alt + B` potrebbe non funzionare. In tal caso, fai clic sull'icona dell'estensione nella barra degli strumenti del browser. + +https://support.mozilla.org/en-US/kb/extensions-button +::: + +![Open Extension](/images/open-extension.png) + +### 3. Accedi a Bluesky + +Inserisci il tuo handle di Bluesky (o email) e [App password](https://bsky.app/settings/app-passwords). + +::: tip +Se incontri errori di accesso, consulta la [Guida alla risoluzione dei problemi](/troubleshooting). +::: + +![enter-credentials](/images/enter-credentials.png) + +### 4. Avvia la Ricerca + +Clicca su "Find Bluesky Users" per iniziare la scansione. L'estensione cercherà profili Bluesky corrispondenti controllando l'API di Bluesky. + +![find-bluesky-users](/images/scan-users.png) + +### 5. Rivedi i Risultati + +Clicca su "View Results" per vedere le potenziali corrispondenze trovate su Bluesky. + +![view-results-button](/images/click-results.png) + +Questo aprirà la pagina delle opzioni mostrando tutti gli utenti Bluesky rilevati. + +![options](/images/options.png) + +### 6. Segui gli Utenti + +Clicca sul pulsante "Follow" accanto a qualsiasi utente con cui desideri connetterti. + +![follow](/images/click-follow-btn.png) + +oppure usa il pulsante "Follow All" per seguire tutti gli utenti rilevati contemporaneamente. + +![follow-all](/images/follow-all-btn.png) + +::: warning +Si noti che il processo di corrispondenza non è perfetto e potrebbe occasionalmente suggerire corrispondenze errate. Verifica sempre il profilo prima di seguire. +::: + +Ecco fatto! Goditi la connessione con la tua comunità su Bluesky 🎉 diff --git a/docs/it/index.md b/docs/it/index.md new file mode 100644 index 0000000..2fed687 --- /dev/null +++ b/docs/it/index.md @@ -0,0 +1,32 @@ +--- +layout: home + +hero: + name: "Sky Follower Bridge" + text: "Collega le tue reti sociali" + tagline: Migra senza problemi le tue connessioni sociali da 𝕏 a Bluesky + actions: + - theme: brand + text: Iniziare + link: /it/get-started + - theme: alt + text: Risoluzione dei problemi + link: /it/troubleshooting + image: + src: /images/logo.png + alt: Immagine di copertina di Sky Follower Bridge + +features: + - icon: 🔍 + title: Rilevamento automatico dei profili + details: Rileva automaticamente gli utenti Bluesky simili ai tuoi seguiti su 𝕏. + - icon: 🚀 + title: Funzione di seguito in massa + details: Risparmia tempo seguendo più utenti contemporaneamente con il nostro pulsante "Follow All". + - icon: 📋 + title: Supporto per liste multiple + details: Funziona con le liste di seguiti, bloccati e persino con le liste pubbliche di 𝕏. + - icon: 🌐 + title: Supporto multi-browser + details: Disponibile su Chrome, Firefox e Microsoft Edge per la tua comodità. +--- diff --git a/docs/it/troubleshooting.md b/docs/it/troubleshooting.md new file mode 100644 index 0000000..bcee982 --- /dev/null +++ b/docs/it/troubleshooting.md @@ -0,0 +1,118 @@ +# Guida alla risoluzione dei problemi + +## Errori di autenticazione + +### Problemi di accesso + +**Messaggio di errore:** +Error: Invalid identifier or password + +**Lista di controllo:** +1. Inserimento di nome utente e password + - Controlla eventuali spazi accidentali + - Se copi e incolli, assicurati che non ci siano caratteri extra + +2. Formato del nome utente + - Formato corretto: `tuo-username.bsky.social` + - Errore comune: `tuo-username` (manca .bsky.social) + +3. Informazioni sulla password + - Consigliamo vivamente di utilizzare una [App Password](https://bsky.app/settings/app-passwords) invece della tua password normale + - Formato della password dell'app: `xxxx-xxxx-xxxx-xxxx` (19 caratteri) + +::: tip Suggerimenti utili +Non confondere la App Password con il "password name" mostrato nelle impostazioni. +Come creare una nuova App Password: +2. [Vai alla sezione App Passwords](https://bsky.app/settings/app-passwords) +3. Clicca su "Add App Password" +4. Clicca su "Create App Password" +4. Copia la password generata di 19 caratteri +::: + +--- + +### Autenticazione a due fattori richiesta + +**Messaggio di errore:** +Error: Two-factor authentication required + +**Soluzione:** +1. Controlla la tua email per il codice di autenticazione +2. Inserisci il codice nel campo di input 2FA +3. Prova ad accedere di nuovo + +## Errori di limite di velocità + +**Messaggio di errore:** +Error: Rate limit error + +**Soluzione:** +1. L'API di Bluesky ha i seguenti limiti ([documentazione ufficiale](https://docs.bsky.app/docs/advanced-guides/rate-limits)): + - Fino a 5.000 punti all'ora (circa 1.666 nuove azioni) + - Fino a 35.000 punti al giorno + - Punti per azione: + - Creazione: 3 punti + - Aggiornamento: 2 punti + - Eliminazione: 1 punto +2. Se raggiungi il limite, attendi fino al reset del limite +3. Clicca sul pulsante "Restart" per riprovare + +::: warning +La versione pubblicata su Firefox incontra frequentemente errori di limite di velocità. Se incontri un errore, prova su Chrome. +::: + +::: tip +La maggior parte degli utenti non raggiungerà questi limiti durante l'uso normale. Tuttavia, fai attenzione quando esegui azioni in massa come seguire molti utenti o mettere mi piace a molti post in breve tempo. +::: + +## Errori di pagina + +### Pagina non valida + +**Messaggio di errore:** +Error: Invalid page. please open the 𝕏 following or blocking or list page. + +**Soluzione:** +Usa l'estensione solo su queste pagine di 𝕏 (Twitter): +- Pagina dei seguiti ([x.com/following](https://x.com/following)) +- Pagina dei bloccati ([x.com/settings/blocked/all](https://x.com/settings/blocked/all)) +- Pagina dei membri della lista (`x.com/i/lists//members`) + +o controlla i permessi dell'estensione nella pagina delle estensioni. +I permessi del sito dovrebbero essere come di seguito: + +site permissions + +## Problemi di scansione + +### La scansione si interrompe presto + +La scansione si interrompe prima di raggiungere il fondo della pagina + +**Soluzione:** +1. Clicca su "Resume Scanning" per continuare +2. La scansione si fermerà automaticamente quando raggiunge il fondo della pagina +3. Puoi cliccare su "Stop Scanning and View Results" in qualsiasi momento + +### Nessun utente trovato + +Nessun utente Bluesky rilevato dopo la scansione + +**Soluzione:** +1. Assicurati di aver effettuato correttamente l'accesso +2. Prova a scansionare di nuovo - alcuni utenti potrebbero non essere rilevati al primo passaggio +3. Controlla se gli utenti di 𝕏 hanno collegato i loro account Bluesky nei loro profili + +## Altri problemi + +Se incontri errori inaspettati: + +1. Ricarica la pagina +2. Prova di nuovo l'operazione +3. Se il problema persiste, puoi: + - [Creare un problema](https://github.com/kawamataryo/sky-follower-bridge/issues) con: + - Il messaggio di errore esatto + - Cosa stavi cercando di fare + - Il tipo e la versione del tuo browser + - Eventuali screenshot pertinenti + - Oppure menzionare [@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social) su Bluesky