トラブルシューティングとよくある質問

このページはLocalizeflowの使用に関する一般的な問題や質問と、その解決策をまとめています。

初めてご利用の場合は、まずGetting startedとHow Localizeflow worksをお読みください。

インストールとアクセスの問題

組織にGitHubアプリをインストールできません

GitHubの組織では、Localizeflow GitHubアプリをインストールするには組織オーナーの権限が必要です。

解決策

• 組織のオーナーにInstall and manage the GitHub Appに従ってアプリをインストールしてもらってください。
• インストール後、オーナーはLocalizeflowサイドバーのTeamsページからあなたを招待できます。

欲しいリポジトリがLocalizeflowに表示されません

+ Connect repositoriesリストにリポジトリが見えない場合:

• GitHubでアプリにそのリポジトリへのアクセス権がない可能性があります。
• リポジトリがアプリがインストールされたアカウントや組織とは別のアカウントや組織にある可能性があります。

解決策

1. GitHubでLocalizeflow GitHubアプリの設定を確認します。
2. 以下を確認してください:
   • アプリは正しいアカウントまたは組織にインストールされている。
   • リポジトリがアプリの許可されたリポジトリに含まれている。
3. Localizeflowに戻り、+ Connect repositoriesを再度試してください。

翻訳プルリクエストが表示されない

自動化を有効にしたがプルリクエストが作成されなかった

考えられる理由:

• ソース言語ファイルに関連する変更がなかった。
• include/excludeパスがファイルに一致していない。
• 自動化が一時停止または無効になっている。

解決策

1. 翻訳設定に期待するフォルダが含まれているか確認してください（例: docs/en/**、blog/en/**、または**/*.md）。
2. リポジトリで自動化が有効になっていることを確認します。
3. ソースファイルに小さなテスト変更を加え、設定されたブランチにプッシュします。
4. 少し待ってから翻訳プルリクエストが表示されるか確認してください。

一部のファイルのみが翻訳される

特定のファイルが翻訳プルリクエストに含まれていない場合:

• 設定で除外されている可能性がある。
• パスがincludeパターンに一致していない可能性がある。

解決策

• includeおよびexcludeパターンを見直してください。
• 重要なファイルが明示的にincludeパターンに含まれ、誤ってexcludeされていないことを確認してください。

静的ドキュメントの問題

静的ドキュメントプロジェクトに既に翻訳済みのフォルダがある（例：docs/ko）

古い翻訳フォルダが存在すると、Localizeflowはそれらを追加のソースコンテンツと見なす場合があります。 これにより、翻訳が重複したり、差分が混乱したりする可能性があります。

解決策

1. 自動化を有効にする前に、以下のような古いまたは手動で管理された翻訳フォルダを削除します:
   • docs/ko、docs/ja
   • blog/ko、blog/ja
   • i18n/* や類似の出力フォルダ
2. 元のコンテンツを言語別のソースフォルダに移動します。例:
   • docs/en/**
   • blog/en/**
3. 翻訳設定を更新してこれらの新しいソースパスを含めます。

詳細はStatic documentation sitesをご覧ください。

権限と協力

チームメンバーがLocalizeflowでプロジェクトを見られない

メンバーがリポジトリや設定を見られない場合:

• 正しいLocalizeflowワークスペースに招待されていない可能性があります。
• GitHubリポジトリへのアクセス権がない可能性があります。

解決策

1. LocalizeflowのTeamsページに行き、メンバーがあなたのワークスペースのメンバーであることを確認します。
2. そうでなければ、メールで招待するか招待リンクを共有してください。
3. 関連するGitHubリポジトリに対する適切な権限も持っていることを確認してください。

一般的な質問

翻訳を一時的に停止できますか？

はい。大きな構造変更を行う場合やノイズを減らしたい場合は、リポジトリの自動化を無効化または一時停止できます。 自動化が停止されている間は、Localizeflowは新しい翻訳プルリクエストを作成しません。

翻訳を手動で編集したらどうなりますか？

翻訳ファイルはいつでも直接編集できます。 それらの変更がマージされると、リポジトリの履歴の一部になります。 Localizeflowは翻訳を現在のソースコンテンツに合わせて維持することに重点を置き、あなたの変更を任意に上書きしません。

デプロイやCI/CDの設定を変更する必要はありますか？

ほとんどの場合、必要ありません。 LocalizeflowはGitHubのブランチとプルリクエストを通じて動作します。 CI/CDパイプラインがリポジトリの内容からビルドしていれば、翻訳プルリクエストをマージ後にLocalizeflowが生成した翻訳ファイルも自動的に含まれます。

Localizeflowはfrontmatterをどう扱いますか？

LocalizeflowはMarkdownファイルのfrontmatterフィールドをインテリジェントに扱います:

• 翻訳する項目: title、description、excerptなどのユーザー向けテキスト
• 保持する項目: slug、id、date、author、tags、order、sectionなどの技術的フィールド
• パスを調整する項目: image、cover、og_imageなどの画像パスは、翻訳ファイルの正しい場所を指すよう自動的に更新されます

例：

元ファイル（docs/en/getting-started.md）:

---
title: Getting Started
description: Learn how to get started with our platform
slug: getting-started
section: introduction
order: 1
sidebar_position: 1
image: ../images/hero.png
date: 2024-01-15
author: john-doe
tags: [tutorial, beginner]
---

翻訳ファイル（docs/ko/getting-started.md）:

---
title: 시작하기                                    # ← Translated
description: 우리 플랫폼 시작 방법 알아보기           # ← Translated
slug: getting-started                            # ← Preserved
section: introduction                            # ← Preserved
order: 1                                         # ← Preserved
sidebar_position: 1                              # ← Preserved
image: ../images/hero.png                        # ← Preserved (same depth)
date: 2024-01-15                                # ← Preserved
author: john-doe                                # ← Preserved
tags: [tutorial, beginner]                      # ← Preserved
---

これは自動で行われるため、特別な設定は不要です。

特定のフィールドに対してカスタムfrontmatter処理が必要な場合はお問い合わせください。プロジェクトごとに設定可能です。