fix: add docs

2025-04-10 14:11:22 -06:00 · 2024-11-17 10:58:57 +09:00 · 2024-11-17 10:58:57 +09:00 · 8dbd0dc2e0
commit 8dbd0dc2e0
parent 5b90cd424a
4 changed files with 246 additions and 0 deletions
--- 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" },
+        ],
+      }
    }
  }
 });
--- a/docs/it/get-started.md
+++ 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.
+
+<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;">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.</p>
+
+## 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/<list_id>/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 🎉 
--- a/docs/it/index.md
+++ 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à.
+--- 
--- a/docs/it/troubleshooting.md
+++ b/docs/it/troubleshooting.md
@ -0,0 +1,118 @@
+# Guida alla risoluzione dei problemi
+
+## Errori di autenticazione
+
+### Problemi di accesso
+
+**Messaggio di errore:**  
+<span class="error-message">Error: Invalid identifier or password</span>
+
+**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:**  
+<span class="error-message">Error: Two-factor authentication required</span>
+
+**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:**  
+<span class="error-message">Error: Rate limit error</span>
+
+**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:**  
+<span class="error-message">Error: Invalid page. please open the 𝕏 following or blocking or list page.</span>
+
+**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/<list_id>/members`)
+
+o controlla i permessi dell'estensione nella pagina delle estensioni.
+I permessi del sito dovrebbero essere come di seguito:
+
+<img src="/images/site_permissions.png" alt="site permissions" width="500"/>
+
+## 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