hugo-template-dev について
Hugo テンプレート開発向けのスキルで、テンプレート変更、製品固有の動作、新しい shortcode に必要な確認事項と資料を示します。既存パターンの確認と、ビルド後の実行時検証を重視します。
主な機能
- 01変更内容別の検証要件
- 02実行時 Cypress テストのガイド
- 03データ駆動の製品コンテキスト
- 04Shortcode の文書化とテスト
活用シーン
- 01Hugo テンプレートや partial の変更
- 02製品固有のテンプレート動作の実装
- 03テストと文書を伴う shortcode の追加
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ influxdata/ docs-v2 --skill hugo-template-devインストール後、Claude Code で/hugo-template-devを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/product-data.mdruntime-testing.mdshortcodes.md詳細
Hugo テンプレートの開発
| 変更 | 必要な証拠 | 参照 |
|---|---|---|
| テンプレートまたはパーシャル | Hugo のビルドと実行時の Cypress カバレッジ | references/runtime-testing.md |
| 製品固有の動作 | データ駆動型の製品コンテキスト。マジック値は使わない | references/product-data.md |
| 新しいショートコード | サンプルページ、ドキュメント、Cypress の動作テスト | references/shortcodes.md |
前提条件:周辺のパターンとページカスケードを確認してください。data/products.yml と製品コンテキストのパーシャルで情報を取得できる場合は、ハードコードされた製品名、バージョン、URL セグメントを条件分岐に使わないでください。ビルドだけでは、実行時の動作を証明できません。
npx hugo --quiet
node cypress/support/run-e2e-specs.js <content-file>
該当する場合に限り、ルート固有のリファレンスを読み込んでください。
コメント
Markdown 対応