fix: add docs

This commit is contained in:
kawamataryo
2024-11-17 11:07:34 +09:00
parent 8dbd0dc2e0
commit 8752cb0923
11 changed files with 740 additions and 2 deletions

84
docs/pt/get-started.md Normal file
View File

@@ -0,0 +1,84 @@
# Introdução
O Sky Follower Bridge ajuda você a encontrar e seguir suas conexões do 𝕏 (Twitter) no 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;">Este vídeo demonstra a versão Edge. A versão mais recente do Chrome e as versões recentes do Firefox podem se comportar de maneira diferente. Um tutorial em vídeo para o Chrome está chegando em breve.</p>
## Instalação
O Sky Follower Bridge está disponível em:
- [Chrome Web Store](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko) (Recomendado)
- [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
Recomendamos usar a versão do Chrome Web Store, pois está sempre atualizada. As versões de outras lojas podem estar atrasadas nas atualizações.
:::
## Uso
### 1. Navegue para 𝕏 (Twitter)
Visite uma destas páginas no X:
- Sua página de Seguindo: [x.com/following](https://x.com/following)
- Sua página de Usuários Bloqueados: [x.com/settings/blocked/all](https://x.com/settings/blocked/all)
- A página de Membros de uma Lista Pública: `x.com/i/lists/<list_id>/members`
![following-page](/images/following-page.png)
### 2. Inicie o Sky Follower Bridge
Pressione `Alt + B` ou clique no ícone da extensão na barra de ferramentas do navegador.
::: tip
Para usuários do Firefox, pressionar `Alt + B` pode não funcionar. Nesse caso, clique no ícone da extensão na barra de ferramentas do navegador.
https://support.mozilla.org/en-US/kb/extensions-button
:::
![Open Extension](/images/open-extension.png)
### 3. Faça login no Bluesky
Digite seu identificador do Bluesky (ou e-mail) e [App password](https://bsky.app/settings/app-passwords).
::: tip
Se você encontrar erros de login, consulte o [Guia de Solução de Problemas](/troubleshooting).
:::
![enter-credentials](/images/enter-credentials.png)
### 4. Inicie a Pesquisa
Clique em "Find Bluesky Users" para começar a varredura. A extensão procurará perfis Bluesky correspondentes verificando a API do Bluesky.
![find-bluesky-users](/images/scan-users.png)
### 5. Revise os Resultados
Clique em "View Results" para ver as correspondências potenciais encontradas no Bluesky.
![view-results-button](/images/click-results.png)
Isso abrirá a página de opções mostrando todos os usuários Bluesky detectados.
![options](/images/options.png)
### 6. Siga os Usuários
Clique no botão "Follow" ao lado de qualquer usuário que você gostaria de se conectar.
![follow](/images/click-follow-btn.png)
ou use o botão "Follow All" para seguir todos os usuários detectados de uma vez.
![follow-all](/images/follow-all-btn.png)
::: warning
Observe que o processo de correspondência não é perfeito e pode ocasionalmente sugerir correspondências incorretas. Sempre verifique o perfil antes de seguir.
:::
É isso! Aproveite para se conectar com sua comunidade no Bluesky 🎉

32
docs/pt/index.md Normal file
View File

@@ -0,0 +1,32 @@
---
layout: home
hero:
name: "Sky Follower Bridge"
text: "Conecte suas Redes Sociais"
tagline: Migre suas conexões sociais do 𝕏 para o Bluesky sem esforço
actions:
- theme: brand
text: Get Started
link: /pt/get-started
- theme: alt
text: Troubleshooting
link: /pt/troubleshooting
image:
src: /images/logo.png
alt: Imagem de Capa do Sky Follower Bridge
features:
- icon: 🔍
title: Correspondência Automática de Perfis
details: Detecte automaticamente usuários do Bluesky semelhantes aos seus seguidos no 𝕏.
- icon: 🚀
title: Recurso de Seguir em Massa
details: Economize tempo seguindo vários usuários de uma vez com nosso botão "Follow All".
- icon: 📋
title: Suporte a Múltiplas Listas
details: Funciona com listas de Seguindo, Bloqueados e até mesmo listas públicas do 𝕏.
- icon: 🌐
title: Suporte a Múltiplos Navegadores
details: Disponível no Chrome, Firefox e Microsoft Edge para sua conveniência.
---

118
docs/pt/troubleshooting.md Normal file
View File

@@ -0,0 +1,118 @@
# Guia de Solução de Problemas
## Erros de Autenticação
### Problemas de Login
**Mensagem de Erro:**
<span class="error-message">Error: Invalid identifier or password</span>
**Lista de Verificação:**
1. Entrada de Nome de Usuário e Senha
- Verifique se há espaços acidentais
- Se copiar e colar, certifique-se de que não há caracteres extras incluídos
2. Formato do Nome de Usuário
- Formato correto: `your-username.bsky.social`
- Erro comum: `your-username` (falta .bsky.social)
3. Informações de Senha
- Recomendamos fortemente o uso de um [App Password](https://bsky.app/settings/app-passwords) em vez de sua senha regular
- Formato do App Password: `xxxx-xxxx-xxxx-xxxx` (19 caracteres)
::: tip Dicas Úteis
Não confunda o App Password com o "password name" mostrado nas configurações.
Como criar um novo App Password:
2. [Navegue para a seção App Passwords](https://bsky.app/settings/app-passwords)
3. Clique em "Add App Password"
4. Clique em "Create App Password"
4. Copie a senha gerada de 19 caracteres
:::
---
### Autenticação de Dois Fatores Necessária
**Mensagem de Erro:**
<span class="error-message">Error: Two-factor authentication required</span>
**Solução:**
1. Verifique seu e-mail para o código de autenticação
2. Insira o código no campo de entrada 2FA
3. Tente fazer login novamente
## Erros de Limite de Taxa
**Mensagem de Erro:**
<span class="error-message">Error: Rate limit error</span>
**Solução:**
1. A API do Bluesky tem os seguintes limites ([documentação oficial](https://docs.bsky.app/docs/advanced-guides/rate-limits)):
- Até 5.000 pontos por hora (aproximadamente 1.666 novas ações)
- Até 35.000 pontos por dia
- Pontos por ação:
- Criar: 3 pontos
- Atualizar: 2 pontos
- Excluir: 1 ponto
2. Se você atingir o limite, aguarde até que o limite seja redefinido
3. Clique no botão "Restart" para tentar novamente
::: warning
A versão publicada no Firefox frequentemente encontra erros de limite de taxa. Se você encontrar um erro, tente no Chrome.
:::
::: tip
A maioria dos usuários não atingirá esses limites durante o uso normal. No entanto, tenha cuidado ao realizar ações em massa, como seguir muitos usuários ou curtir muitas postagens em um curto período.
:::
## Erros de Página
### Página Inválida
**Mensagem de Erro:**
<span class="error-message">Error: Invalid page. please open the 𝕏 following or blocking or list page.</span>
**Solução:**
Use a extensão apenas nestas páginas do 𝕏 (Twitter):
- Página de Seguindo ([x.com/following](https://x.com/following))
- Página de Bloqueio ([x.com/settings/blocked/all](https://x.com/settings/blocked/all))
- Página de Membros da Lista (`x.com/i/lists/<list_id>/members`)
ou verifique as permissões da extensão na página de extensões.
As permissões do site devem ser como abaixo:
<img src="/images/site_permissions.png" alt="site permissions" width="500"/>
## Problemas de Varredura
### Varredura Para Cedo
A varredura para antes de chegar ao final da página
**Solução:**
1. Clique em "Resume Scanning" para continuar
2. A varredura parará automaticamente quando chegar ao final da página
3. Você pode clicar em "Stop Scanning and View Results" a qualquer momento
### Nenhum Usuário Encontrado
Nenhum usuário do Bluesky detectado após a varredura
**Solução:**
1. Certifique-se de que você está logado corretamente
2. Tente varrer novamente - alguns usuários podem não ser detectados na primeira passagem
3. Verifique se os usuários do 𝕏 vincularam suas contas do Bluesky em seus perfis
## Outros Problemas
Se você encontrar erros inesperados:
1. Recarregue a página
2. Tente a operação novamente
3. Se o problema persistir, você pode:
- [Criar um problema](https://github.com/kawamataryo/sky-follower-bridge/issues) com:
- A mensagem de erro exata
- O que você estava tentando fazer
- O tipo e a versão do seu navegador
- Quaisquer capturas de tela relevantes
- Ou mencionar [@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social) no Bluesky