diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 19fcc78..0d97853 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -181,6 +181,21 @@ export default defineConfig({ { text: "Guía de solución de problemas", link: "/es/troubleshooting" }, ], } + }, + ko: { + label: "한국어", + lang: "ko", + link: "/ko/", + title: 'Sky Follower Bridge: 무료 X에서 Bluesky로 팔로워 이동 도구', + description: '무료 브라우저 확장 프로그램으로 X, Twitter, Threads에서 Bluesky로 팔로워를 쉽게 이동할 수 있습니다.', + themeConfig: { + siteTitle: "Sky Follower Bridge", + nav: [ + { text: "홈", link: "/" }, + { text: "시작하기", link: "/ko/get-started" }, + { text: "문제 해결", link: "/ko/troubleshooting" }, + ], + } } } }); diff --git a/docs/ko/get-started.md b/docs/ko/get-started.md new file mode 100644 index 0000000..da80d4b --- /dev/null +++ b/docs/ko/get-started.md @@ -0,0 +1,101 @@ +# 시작하기 + +Sky Follower Bridge는 𝕏(Twitter)에서 팔로우하는 사용자와 유사한 Bluesky 사용자를 찾아 팔로우하는 데 도움을 줍니다. + + + +## 설치 + +Sky Follower Bridge는 다음에서 사용할 수 있습니다: + + + +::: tip +Chrome Web Store 버전을 사용하는 것이 좋습니다. 항상 최신 상태를 유지하며, 다른 스토어 버전은 업데이트가 지연될 수 있습니다. +::: + +::: warning +Sky Follower Bridge는 데스크톱 브라우저에서만 사용할 수 있습니다. 모바일 브라우저는 지원되지 않습니다. +::: + +## 사용 방법 + +### 1. 𝕏(Twitter)로 이동 + +𝕏의 다음 페이지에 접속하세요: +- 팔로잉 페이지: [x.com/following](https://x.com/following) +- 차단된 사용자 페이지: [x.com/settings/blocked/all](https://x.com/settings/blocked/all) +- 공개 리스트 멤버 페이지: `x.com/i/lists//members` + +![following-page](/images/following-page.png) + +### 2. Sky Follower Bridge 실행 + +`Alt + B`를 누르거나 브라우저 툴바의 확장 프로그램 아이콘을 클릭하세요. + +::: tip +Firefox 사용자의 경우 `Alt + B`가 작동하지 않을 수 있습니다. 이 경우 브라우저 툴바의 확장 프로그램 아이콘을 클릭하세요. + +https://support.mozilla.org/en-US/kb/extensions-button +::: + +![Open Extension](/images/open-extension.png) + +### 3. Bluesky 로그인 + +Bluesky 핸들(또는 이메일)과 [앱 비밀번호](https://bsky.app/settings/app-passwords)를 입력하세요. + +::: tip +로그인 오류가 발생한 경우 [문제 해결 가이드](/ko/troubleshooting)를 참조하세요. +::: + +![enter-credentials](/images/enter-credentials.png) + +### 4. 검색 시작 + +"Find Bluesky users"를 클릭하여 스캔을 시작하세요. 확장 프로그램이 Bluesky API를 확인하여 일치하는 Bluesky 프로필을 검색합니다. + +![find-bluesky-users](/images/scan-users.png) + +### 5. 결과 확인 + +"Show results"를 클릭하여 Bluesky에서 발견된 가능한 일치 항목을 확인하세요. + +![view-results-button](/images/click-results.png) + +이렇게 하면 감지된 모든 Bluesky 사용자를 표시하는 옵션 페이지가 열립니다. + +![options](/images/options.png) + +### 6. 사용자 팔로우 + +연결하고 싶은 사용자 옆의 "Follow" 버튼을 클릭하세요. + +![follow](/images/click-follow-btn.png) + +또는 "Follow all" 버튼을 사용하여 감지된 모든 사용자를 한 번에 팔로우할 수 있습니다. + +![follow-all](/images/follow-all-btn.png) + +::: warning +매칭 프로세스는 완벽하지 않으며 때때로 잘못된 매칭을 제안할 수 있습니다. 팔로우하기 전에 반드시 프로필을 확인하세요. +::: + +이제 완료되었습니다! Bluesky에서 커뮤니티와의 연결을 즐기세요 🎉 diff --git a/docs/ko/index.md b/docs/ko/index.md new file mode 100644 index 0000000..3640aa5 --- /dev/null +++ b/docs/ko/index.md @@ -0,0 +1,32 @@ +--- +layout: home + +hero: + name: "Sky Follow Bridge" + text: "Connect your social networks" + tagline: 𝕏에서 Bluesky로 소셜 네트워크를 원활하게 이전 + actions: + - theme: brand + text: 사용 방법 + link: /ko/get-started + - theme: alt + text: 문제 해결 + link: /ko/troubleshooting + image: + src: /images/logo.webp + alt: Sky Follow Bridge cover image + +features: + - icon: 🔍 + title: 자동 프로필 매칭 + details: 𝕏에서 팔로우하는 사용자와 유사한 Bluesky 사용자를 자동으로 감지합니다. + - icon: 🚀 + title: 일괄 팔로우 기능 + details: "모두 팔로우" 버튼으로 여러 사용자를 한 번에 팔로우하여 시간을 절약하세요. + - icon: 📋 + title: 다중 리스트 지원 + details: 팔로우, 팔로워, 차단된 사용자 리스트, 그리고 공개 𝕏 리스트도 지원합니다. + - icon: 🌐 + title: 크로스 브라우저 지원 + details: Chrome, Firefox, Microsoft Edge에서 사용 가능합니다. +--- diff --git a/docs/ko/troubleshooting.md b/docs/ko/troubleshooting.md new file mode 100644 index 0000000..908f425 --- /dev/null +++ b/docs/ko/troubleshooting.md @@ -0,0 +1,132 @@ +# 문제 해결 가이드 + +## 인증 오류 + +### 로그인 문제 + +**오류 메시지:** +Error: Invalid identifier or password + +**체크리스트:** +1. 사용자 이름과 비밀번호 입력 + - 불필요한 공백이 없는지 확인 + - 복사 붙여넣기 시 불필요한 문자가 포함되지 않았는지 확인 + +2. 사용자 이름 형식 + - 올바른 형식: `your-username.bsky.social` + - 일반적인 실수: `your-username`(.bsky.social 누락) + +3. 비밀번호 정보 + - 일반 비밀번호가 아닌 [앱 비밀번호](https://bsky.app/settings/app-passwords)를 사용하는 것을 강력히 권장합니다 + - 앱 비밀번호 형식: `xxxx-xxxx-xxxx-xxxx`(19자) + +::: tip 유용한 힌트 +앱 비밀번호를 설정의 "비밀번호 이름"과 혼동하지 마세요. +새 앱 비밀번호 생성 방법: +1. [앱 비밀번호 섹션으로 이동](https://bsky.app/settings/app-passwords) +2. "앱 비밀번호 추가" 클릭 +3. "앱 비밀번호 생성" 클릭 +4. 생성된 19자 비밀번호 복사 +::: + +--- + +### 2단계 인증 문제 + +**오류 메시지:** +Error: Two-factor authentication required + +**해결 방법:** +1. 인증 코드가 포함된 이메일 확인 +2. 2FA 입력 필드에 코드 입력 +3. 다시 로그인 시도 + +::: warning +Firefox 버전은 2FA를 지원하지 않습니다. Firefox 버전에서는 2FA를 비활성화하세요. +::: + +## 속도 제한 오류 + +**오류 메시지:** +Error: Rate limit error + +**해결 방법:** +1. Bluesky API에는 다음과 같은 제한이 있습니다([공식 문서](https://docs.bsky.app/docs/advanced-guides/rate-limits)): + - 시간당 최대 5,000포인트(약 1,666개의 새로운 작업) + - 일일 최대 35,000포인트 + - 작업별 포인트: + - 생성: 3포인트 + - 업데이트: 2포인트 + - 삭제: 1포인트 +2. 제한에 도달한 경우 제한이 재설정될 때까지 대기 +3. "Restart" 버튼을 클릭하여 재시도 + +::: warning +Firefox에서 공개된 버전은 속도 제한 오류가 자주 발생합니다. 오류가 발생하면 Chrome에서 시도해보세요. +::: + +::: tip +일반적인 사용에서는 대부분의 사용자가 이러한 제한에 도달하지 않습니다. 단, 짧은 시간 동안 많은 사용자를 팔로우하거나 많은 게시물에 좋아요를 누를 경우 주의하세요. +::: + +## 페이지 오류 + +### 잘못된 페이지 + +**오류 메시지:** +Error: Invalid page. please open the 𝕏 following or blocking or list page. + +**해결 방법:** +이 확장 프로그램은 다음 𝕏(Twitter) 페이지에서만 사용할 수 있습니다: +- 팔로잉 페이지 ([x.com/following](https://x.com/following)) +- 차단 페이지 ([x.com/settings/blocked/all](https://x.com/settings/blocked/all)) +- 리스트 멤버 페이지 (`x.com/i/lists//members`) + +또는 확장 프로그램 페이지에서 확장 프로그램 권한을 확인하세요. +사이트 권한은 다음과 같이 설정되어 있어야 합니다: + +사이트 권한 + +## 스캔 문제 + +### View Detected Users 버튼이 작동하지 않음 + +어떤 이유로 View Detected Users 버튼이 작동하지 않을 수 있습니다. + +**해결 방법:** +1. 확장 프로그램 아이콘을 우클릭하고 "옵션" 선택 +2. 결과 페이지가 표시됩니다 + +옵션 클릭 + +### 스캔이 중간에 중지됨 + +스캔이 페이지 하단에 도달하기 전에 중지됨 + +**해결 방법:** +1. "Resume"을 클릭하여 계속 +2. 스캔은 페이지 하단에 도달하면 자동으로 중지됩니다 +3. 언제든지 "Stop and show results"를 클릭할 수 있습니다 + +### 사용자를 찾을 수 없음 + +스캔 후 Bluesky 사용자가 감지되지 않음 + +**해결 방법:** +1. 올바르게 로그인되어 있는지 확인 +2. 다시 스캔 시도 - 일부 사용자는 첫 번째 시도에서 감지되지 않을 수 있습니다 +3. 𝕏 사용자가 프로필에 Bluesky 계정을 연결했는지 확인 + +## 기타 문제 + +예기치 않은 오류가 발생한 경우: + +1. 페이지 새로고침 +2. 작업 재시도 +3. 문제가 해결되지 않는 경우 다음 중 하나를 수행: + - [이슈 생성](https://github.com/kawamataryo/sky-follower-bridge/issues): + - 정확한 오류 메시지 + - 시도한 작업 + - 브라우저 종류와 버전 + - 관련 스크린샷 + - 또는 Bluesky에서 [@kawamataryo.bsky.social](https://bsky.app/profile/kawamataryo.bsky.social)에 언급