NPM スクリプト
OpenTelemetry ウェブサイトのビルド、配信、検証、メンテナンスのための NPM スクリプト。
スクリプトの定義はリポジトリルートの package.json にあります。
スクリプトを実行するには、npm run SCRIPT_NAME を使用してください。
命名規則
- 内部スクリプト
- 名前が
_ で始まるスクリプトは内部ヘルパーであり、直接実行することを想定していません。 NAME::pre および NAME::post スクリプトも同様です。
これらは NAME の明示的に呼び出される前処理・後処理ステップです。
- デフォルトと
:all スクリプトバリアントcheck、fix、test スクリプトは、各アクションでもっとも一般的に必要とされるサブスクリプトを実行します。*:all バリアント check:all、fix:all、test:all は、より広範なサブスクリプトセットを実行します。
各バリアントのテーブルエントリにスコープが記載されています。
依存関係のインストールと更新
ビルドと配信
| スクリプト | 説明 |
|---|
build:full | サイトのフルビルドを実行します。詳細は Build kinds を参照。 |
build:lean | サイトのリーンビルドを実行します。詳細は Build kinds を参照。 |
build:preview | ミニファイ付きのフルビルド（例: Netlify プレビュー用）。 |
build:production | ミニファイ付きのプロダクション Hugo ビルド。 |
build | サイトをビルドします。デフォルトはリーンです。Build kinds を参照。 |
clean | make clean を実行します。 |
serve:hugo | インメモリレンダリングで Hugo サーバーを起動します。 |
serve | Hugo 開発サーバーを起動します（デフォルト、フルレンダリング）。 |
チェック
| スクリプト | 説明 |
|---|
check:all | すべてのチェックスクリプトを順番に実行します。 |
check:code-excerpts | コード抜粋をチェックし、更新が必要な場合は失敗します。 |
check:codeowners | CODEOWNERS のロケールセクションがレジストリと一致することを検証します。 |
check:collector-sync | collector-sync チェックを実行します。 |
check:expired | 期限切れのコンテンツ（フロントマターに基づく）をリストします。 |
check:filenames | ファイル名の検証と廃止されたファイル/フォルダの検出。 |
check:format | Prettier と prose-wrap のチェック。 |
check:i18n | ローカリゼーションフロントマター（default_lang_commit）を検証します。 |
check:l10n | ローカリゼーションチェックを実行します。 |
check:links:diff | 変更されたファイルのみの Lychee リンクチェック。 |
check:links:internal | オフラインリンクチェック（内部リンクのみ）。最初にリーンビルドを実行。 |
check:links | Lychee でサイト全体をリンクチェック。最初にリーンビルドを実行。 |
check:markdown:specs | tmp/ 内の仕様フラグメントの Markdown lint。 |
check:markdown | Markdown lint（コンテンツおよびプロジェクト）。 |
check:registry | data/registry/ 配下のレジストリ YAML を検証します。 |
check:spelling | コンテンツ、データ、レイアウト Markdown に対する cspell。 |
check:text | コンテンツとデータに対する textlint。 |
check | もっとも一般的に必要なチェックスクリプトを順番に実行します。 |
修正
| スクリプト | 説明 |
|---|
fix | もっとも一般的に必要な修正スクリプトを実行します。 |
fix:code-excerpts | コード抜粋を更新します。 |
fix:codeowners | レジストリから CODEOWNERS ロケールセクションを再生成します。 |
fix:all | すべての修正スクリプトを実行します。 |
fix:format | Prettier を適用し、末尾の空白を削除します。 |
fix:format:staged | ステージングされたファイルのみをフォーマットします。 |
fix:i18n | i18n フロントマターを追加/修正します（fix:i18n:new、fix:i18n:status）。 |
fix:l10n | ローカリゼーションの修正を適用します。 |
fix:link-cache | リンクチェックを実行し、コミット済みの .lycheecache を更新します。 |
fix:link-cache:double-check | ブラウザプローブで失敗したリンクを再検証します。 |
fix:link-cache:refresh | もっとも古いキャッシュエントリをプルーンし、fix:link-cache を実行します。 |
fix:markdown | Markdown lint の問題と末尾の空白を修正します。 |
fix:submodule | サブモジュールの更新、再ピン、リビジョンの一覧表示。 |
fix:filenames | ファイルのリネームと廃止されたファイル/フォルダの削除。 |
fix:dict | cspell ワードリストをソートし、フロントマターを正規化します。 |
fix:expired | check:expired で報告されたファイルを削除します。 |
fix:text | –fix 付きで textlint を実行します。 |
fix:collector-sync:lint | –fix 付きで collector-sync 内の ruff を実行します。 |
format | Prettier write のエイリアス（コンテンツおよび nowrap パス）。 |
サブモジュールとコンテンツ
| スクリプト | 説明 |
|---|
code-excerpts | コード抜粋を更新します。非推奨: fix:code-excerpts または check:code-excerpts を使用。 |
cp:spec | 仕様コンテンツ（content-modules）をコピーします。 |
get:submodule | git サブモジュールを初期化/更新します（スキップするには GET=no を設定）。 |
pin:submodule | サブモジュールのリビジョンをピンします（任意の PIN_SKIP）。 |
schemas:update | OpenTelemetry 仕様サブモジュールとコンテンツを更新します。 |
update:submodule | サブモジュールを最新のリモートに更新し、タグを取得します。 |
テストと CI
| スクリプト | 説明 |
|---|
diff:check | ワーキングツリーにコミットされていない変更がある場合に警告します。 |
diff:fail | ワーキングツリーに変更がある場合に失敗します（例: ビルド後）。 |
fix-and-test:all | すべての修正（i18n を含む）を実行し、その後チェック。リンクチェックは1回。 |
is:clean | Git のワーキングツリーに未追跡ファイルを含む変更がある場合に失敗します。 |
netlify-build:preview | Netlify デプロイプレビューをビルドします。 |
netlify-build:production | Netlify プロダクションサイトをビルドします。 |
test-and-fix | 修正スクリプト（i18n/link-cache/submodule を除く）を実行し、その後チェック。 |
test:all | test:base を実行し、その後 test:compound-tests。 |
test:base | 基本テスト（check と同じ）。 |
test:collector-sync | collector-sync テスト。 |
test:compound-tests | 複合 test:*-* スクリプトを実行します。 |
test:double-check:live | double-check プローブのライブスモークチェック。 |
test:edge-functions:live | 任意の node:test ライブスイート。--help をサポート。 |
test:edge-functions | netlify/edge-functions/**/*.test.ts に対する Node テストランナー。 |
test:local-tools | scripts/**/*.test.mjs に対する Node テストランナー。 |
test:local-tools:lychee | test:local-tools の lychee バイナリスライス。バイナリ不在時はスキップされます。 |
test:public | ビルドされたサイトに対して tests/public/ チェックを実行します。 |
test | もっとも一般的に必要なテストを実行します。 |
ユーティリティ
| スクリプト | 説明 |
|---|
all | 指定されたすべてのスクリプトを実行し、失敗があっても続行。いずれかが失敗した場合は非ゼロで終了。 |
generate:config:links | lychee.base.toml とページフロントマターから git 無視の lychee.toml を生成します。 |
locale-auto-merge | ロケール自動マージヘルパー CLI（--help）。 |
log:build、log:check:links | 対応するスクリプトを実行し、出力を tmp/ に tee し、スクリプトの終了コードを伝搬します。 |
seq | 指定されたスクリプト名を順番に実行します。最初の失敗で終了。 |