build/serve/check などは、現在のディレクトリを基準に docs/ (見つからなければ src/)を探すか、--projectRoot=<path> を指定 した場合はそれを基準に探します。プロジェクトのルートフォルダー内 でコマンドを実行するか、--projectRoot を指定してください。

bxSites build --projectRoot=/path/to/my-docs

bxSites doctor を実行すると、設定ローダーが拒否した正確なキー/ 行が確認できます。よくある原因: YAML のインデントでタブとスペース が混在している、JSON に余分なカンマがある、配列を期待するキー (nav や i18n.locales など)が単なる文字列として書かれている、 などです。キーの完全なリファレンスは 設定 を参照してください。

build、serve、search-index はこれら 4 つの BoxLang モジュー ルをすべて必要とします。bx-sites 自体をインストールすると、 box.json の依存関係として自動的にインストールされます (install-bx-module bx-sites または box install bx-sites)

• このエラーが表示される場合は、インストールが完了していないか、 依存関係なしでモジュールが手動で登録された可能性があります。プロ ジェクトのルートで box install を再実行するとすべて解決されま す。どのモジュールが(もしあれば)まだ不足しているかは bxSites doctor で確認できます。

独自の theme/ フォルダーは layout.bxm と page.bxm の両方を 提供する必要があります - どちらが不足しているかは doctor が 報告します。完全な契約についてはテーマを参照 するか、ゼロから書く代わりに bxSites theme:new を実行して動作 する組み込みテーマを出発点としてエクスポートしてください。

serve は docs/、bxsites.yaml/.json、およびプロジェクトレベ ルの theme/ オーバーライドを監視します - それ以外の場所での変更 (たとえば実際のプロジェクトではなくモジュールのチェックアウト内の resources/ 配下のファイルを編集した場合など)は再ビルドをトリガ ーしません。実際の変更が反映されない場合は、serve を停止し、 bxSites clean を実行して古いビルドキャッシュをクリアしてから、 bxSites serve を再度実行してください。

build は、対応するソースページがもう存在しない、以前にビルドさ れた出力を削除しません。build の前に bxSites clean を実行して site/ とビルドキャッシュを完全に削除し、ゼロから再ビルドしてく ださい。CI のステップが成功と報告しているのにデプロイされたサイト に反映されない場合は、実際のビルドステップのログを確認して Error: がないか探してください - 一部の CI 設定では、クラッシュ したビルドでも紛らわしい成功ステータスを返すことがあります。

これは想定どおりの動作であり、バグではありません: あるロケールで は、使用可能になるためにすべてのページが翻訳されている必要はあり ません。docs/i18n/<code>/ に存在しないページも、想定される URL でビルドされ、デフォルトロケールの内容がページ上部の小さな通知と ともに表示されます。詳しくは 国際化(i18n)を参照してください。

i18n:status はロケールごとのページの存在のみをチェックし、 ページごとの内容の一致は確認しません - ロケールのコピーが存在して いても、後からデフォルトロケールのページに追加されたセクションが 抜けている可能性があります。疑わしい場合は、ロケールのファイルを デフォルトロケールの対応するファイルと直接比較してください。