From 71b8f7425b0b43be53c353ccbc08b9de10ed69d0 Mon Sep 17 00:00:00 2001 From: kawamataryo Date: Sun, 17 Nov 2024 10:49:08 +0900 Subject: [PATCH] add: docs for japan --- docs/.vitepress/config.mts | 19 ++++++ docs/ja/get-started.md | 84 +++++++++++++++++++++++++ docs/ja/index.md | 32 ++++++++++ docs/ja/troubleshooting.md | 122 +++++++++++++++++++++++++++++++++++++ 4 files changed, 257 insertions(+) create mode 100644 docs/ja/get-started.md create mode 100644 docs/ja/index.md create mode 100644 docs/ja/troubleshooting.md diff --git a/docs/.vitepress/config.mts b/docs/.vitepress/config.mts index 324f9d8..ca6c7c0 100644 --- a/docs/.vitepress/config.mts +++ b/docs/.vitepress/config.mts @@ -73,4 +73,23 @@ export default defineConfig({ copyright: 'Copyright © 2024 Ryo Kawamata' }, }, + + locales: { + root: { + label: 'English', + lang: 'en' + }, + ja: { + label: '日本語', + lang: 'ja', + link: '/ja/', + themeConfig: { + nav: [ + { text: "Home", link: "/" }, + { text: "使い方", link: "/ja/get-started" }, + { text: "トラブルシューティング", link: "/ja/troubleshooting" }, + ], + } + } + } }); diff --git a/docs/ja/get-started.md b/docs/ja/get-started.md new file mode 100644 index 0000000..9a242b8 --- /dev/null +++ b/docs/ja/get-started.md @@ -0,0 +1,84 @@ +# はじめに + +スカイフォローブリッジは、あなたの𝕏（Twitter）接続をBlueskyで見つけてフォローするのを助けます。 + + + +

このビデオはEdgeバージョンを示しています。最新のChromeバージョンと最近のFirefoxバージョンでは動作が異なる場合があります。Chromeのビデオチュートリアルは近日公開予定です。

+ +## インストール + +スカイフォローブリッジは以下で利用可能です： + +- [Chrome Web Store](https://chrome.google.com/webstore/detail/sky-follower-bridge/behhbpbpmailcnfbjagknjngnfdojpko)（推奨） +- [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 +Chrome Web Storeバージョンを使用することをお勧めします。常に最新の状態です。他のストアバージョンは更新が遅れる場合があります。 +::: + +## 使用方法 + +### 1. 𝕏（Twitter）に移動 + +𝕏の以下のページにアクセスしてください： +- あなたのフォロー中のページ: `x.com//following` +- ブロックしたユーザーのページ: `x.com/settings/blocked/all` +- 公開リストのメンバーのページ: `x.com/i/lists//members` + +![following-page](/images/following-page.png) + +### 2. スカイフォローブリッジを起動 + +`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 +ログインエラーが発生した場合は、[トラブルシューティングガイド](/ja/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/ja/index.md b/docs/ja/index.md new file mode 100644 index 0000000..8c930b4 --- /dev/null +++ b/docs/ja/index.md @@ -0,0 +1,32 @@ +--- +layout: home + +hero: + name: "Sky Follow Bridge" + text: "Connect your social networks" + tagline: Seamlessly migrate your social connections from 𝕏 to Bluesky + actions: + - theme: brand + text: 使い方 + link: /ja/get-started + - theme: alt + text: トラブルシューティング + link: /ja/troubleshooting + image: + src: /images/logo.png + 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/ja/troubleshooting.md b/docs/ja/troubleshooting.md new file mode 100644 index 0000000..17c4c3c --- /dev/null +++ b/docs/ja/troubleshooting.md @@ -0,0 +1,122 @@ +# トラブルシューティングガイド + +## 認証エラー + +### ログインの問題 + +**エラーメッセージ:** +Error: Invalid identifier or password + +**チェックリスト:** +1. ユーザー名とパスワードの入力 + - 余分なスペースがないか確認 + - コピー＆ペーストする場合、余分な文字が含まれていないか確認 + +2. ユーザー名の形式 + - 正しい形式: `your-username.bsky.social` + - よくある間違い: `your-username`（.bsky.socialが欠落） + +3. パスワード情報 + - 通常のパスワードではなく、[AppPassword](https://bsky.app/settings/app-passwords)を使用することを強くお勧めします + - アプリパスワードの形式: `xxxx-xxxx-xxxx-xxxx`（19文字） + +::: tip 役立つヒント +AppPasswordを設定の「パスワード名」と混同しないでください。 +新しいAppPasswordを作成する方法: +1. [AppPasswordセクションに移動](https://bsky.app/settings/app-passwords) +2. 「AppPasswordを追加」をクリック +3. 「AppPasswordを作成」をクリック +4. 生成された19文字のパスワードをコピー +::: + +--- + +### 二要素認証の問題 + +**エラーメッセージ:** +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)）: + - 1時間あたり最大5,000ポイント（約1,666の新しいアクション） + - 1日あたり最大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`) + +または、拡張機能ページで拡張機能の権限を確認してください。 +サイトの権限は以下のように設定されている必要があります： + +サイトの権限 + +## スキャンの問題 + +### スキャンが途中で停止 + +スキャンがページの下部に到達する前に停止する + +**解決策:** +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)に言及