FAQ

よくある質問とその回答をまとめています。

一般

Guidebook Cloudとは何ですか?

Guidebook Cloudは、GitHubリポジトリと連携してMarkdownドキュメントを自動的にビルド・公開するホスティングサービスです。HonKit/GitBook互換のドキュメントをサポートしています。

既存のHonKit/GitBookプロジェクトは使えますか?

はい、そのまま使用できます。Guidebook CloudはHonKit/GitBook互換の形式をサポートしています。README.mdSUMMARY.mdがあれば、特別な設定なしでビルドできます。

アカウント

ログインできません

以下を確認してください:

  1. 正しいアカウント(GitHub/Google)を使用しているか
  2. ブラウザのCookieが有効か
  3. シークレットブラウジングモードではないか

問題が解決しない場合は、ブラウザのCookieをクリアして再度お試しください。

パスワードを忘れました

Guidebook CloudはソーシャルログインGitHub/Googleを使用しているため、パスワードはありません。各サービスのアカウントでログインしてください。

アカウントを削除したい

現在、セルフサービスでのアカウント削除には対応していません。

組織

複数の組織に所属できますか?

はい、1つのアカウントで複数の組織に所属できます。コンソールのヘッダーから組織を切り替えられます。

組織のスラッグを変更したい

スラッグは変更できません。新しいスラッグで組織を作成し、データを移行する必要があります。

組織から退会したい

  1. 組織のメンバーページを開く
  2. 自分のアカウントの「退会」をクリック
  3. 確認ダイアログで「退会」をクリック

注意: 最後のOwnerは退会できません。

リポジトリ

リポジトリが表示されません

以下を確認してください:

  1. GitHub Appがインストールされているか
  2. 対象リポジトリへのアクセスが許可されているか
  3. GitHubの権限設定を確認

ビルドが失敗します

よくある原因:

  1. SUMMARY.mdが見つからない: ドキュメントパスが正しいか確認
  2. 構文エラー: SUMMARY.mdのMarkdown構文を確認
  3. ファイルが見つからない: SUMMARY.mdで参照しているファイルが存在するか確認

ビルドログで詳細なエラーメッセージを確認できます。

ビルドに時間がかかります

ビルド時間は、ドキュメントのサイズと複雑さによって異なります。通常は1-2分で完了します。

5分以上かかる場合は、ビルドがタイムアウトしている可能性があります。ドキュメントのサイズを確認してください。

プライベートリポジトリは使えますか?

はい、使用できます。GitHub Appに該当リポジトリへのアクセス権を付与してください。

アクセス制御

ドキュメントにアクセスできません

以下を確認してください:

  1. 組織のメンバーか
  2. 該当リポジトリへのアクセス権があるか
  3. アクセスルール(IPアドレス制限)を満たしているか

社外からアクセスできません

IPアドレス制限が設定されている可能性があります。VPNを使用するか、管理者にIPアドレスの追加を依頼してください。

チーム

チームに追加できません

追加するユーザーが組織のメンバーであることを確認してください。組織外のユーザーはチームに追加できません。

チームを削除するとどうなりますか?

チームを削除しても、メンバーの組織メンバーシップは維持されます。チーム経由のリポジトリアクセス権のみが失われます。

その他

データはどこに保存されますか?

ドキュメントデータはCloudflare R2に保存されます。メタデータはCloudflare D1データベースに保存されます。