steve/tok-to-insta-follower-bridge
1
0
Fork 0
mirror of https://github.com/snachodog/tok-to-insta-follower-bridge.git synced 2025-04-09 21:51:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

docs: add Korea

Browse Source
This commit is contained in:
kawamataryo 2024-12-10 22:22:51 +09:00
parent f113d054ca
commit 2dd2820029
4 changed files with 280 additions and 0 deletions

15
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" },
],
}
}
}
});

101
docs/ko/get-started.md Normal file

@ -0,0 +1,101 @@
# 시작하기
Sky Follower Bridge는 𝕏(Twitter)에서 팔로우하는 사용자와 유사한 Bluesky 사용자를 찾아 팔로우하는 데 도움을 줍니다.
<iframe width="100%" height="315" src="https://www.youtube.com/embed/CnjjfSxm0G0?si=N2OFp15PPiZZezEN" 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>
## 설치
Sky Follower Bridge는 다음에서 사용할 수 있습니다:
<ul class="install-list">
<li>
<img src="/images/icon-chrome.svg" width="20" height="20">
<a href="https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko">Chrome Web Store</a>(추천⭐)
</li>
<li>
<img src="/images/icon-firefox.svg" width="20" height="20">
<a href="https://addons.mozilla.org/en-US/firefox/addon/sky-follower-bridge/">Firefox Add-ons</a>
</li>
<li>
<img src="/images/icon-edge.svg" width="20" height="20">
<a href="https://microsoftedge.microsoft.com/addons/detail/sky-follower-bridge/dpeolmdblhfolkhlhbhlofkkpaojnnbb">Microsoft Edge Add-ons</a>
</li>
<li>
<img src="/images/icon-safari.svg" width="20" height="20">
<a href="https://apps.apple.com/us/app/sky-follower-bridge/id6738878242?mt=12">Safari Web Extension</a> <span>Thanks to <a href="https://bsky.app/profile/knotbin.xyz">@knotbin.xyz</a></span>
</li>
</ul>
::: 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/<list_id>/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에서 커뮤니티와의 연결을 즐기세요 🎉

32
docs/ko/index.md Normal file

@ -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에서 사용 가능합니다.
---

132
docs/ko/troubleshooting.md Normal file

@ -0,0 +1,132 @@
# 문제 해결 가이드
## 인증 오류
### 로그인 문제
**오류 메시지:**
<span class="error-message">Error: Invalid identifier or password</span>
**체크리스트:**
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단계 인증 문제
**오류 메시지:**
<span class="error-message">Error: Two-factor authentication required</span>
**해결 방법:**
1. 인증 코드가 포함된 이메일 확인
2. 2FA 입력 필드에 코드 입력
3. 다시 로그인 시도
::: warning
Firefox 버전은 2FA를 지원하지 않습니다. Firefox 버전에서는 2FA를 비활성화하세요.
:::
## 속도 제한 오류
**오류 메시지:**
<span class="error-message">Error: Rate limit error</span>
**해결 방법:**
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
일반적인 사용에서는 대부분의 사용자가 이러한 제한에 도달하지 않습니다. 단, 짧은 시간 동안 많은 사용자를 팔로우하거나 많은 게시물에 좋아요를 누를 경우 주의하세요.
:::
## 페이지 오류
### 잘못된 페이지
**오류 메시지:**
<span class="error-message">Error: Invalid page. please open the 𝕏 following or blocking or list page.</span>
**해결 방법:**
이 확장 프로그램은 다음 𝕏(Twitter) 페이지에서만 사용할 수 있습니다:
- 팔로잉 페이지 ([x.com/following](https://x.com/following))
- 차단 페이지 ([x.com/settings/blocked/all](https://x.com/settings/blocked/all))
- 리스트 멤버 페이지 (`x.com/i/lists/<list_id>/members`)
또는 확장 프로그램 페이지에서 확장 프로그램 권한을 확인하세요.
사이트 권한은 다음과 같이 설정되어 있어야 합니다:
<img src="/images/site_permissions.png" alt="사이트 권한" width="500"/>
## 스캔 문제
### View Detected Users 버튼이 작동하지 않음
어떤 이유로 View Detected Users 버튼이 작동하지 않을 수 있습니다.
**해결 방법:**
1. 확장 프로그램 아이콘을 우클릭하고 "옵션" 선택
2. 결과 페이지가 표시됩니다
<img src="/images/click-option.png" alt="옵션 클릭" width="500"/>
### 스캔이 중간에 중지됨
스캔이 페이지 하단에 도달하기 전에 중지됨
**해결 방법:**
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)에 언급