コンテンツフック(Content Hook)
コンテンツフックは、コンテンツ処理の名前付きの段階をつなぎます。設定の解決から、コンテンツの読み込み、post parsed、post processed、コンテンツグラフ、マニフェストの作成、診断までが対象です。
処理の段階
コンテンツ処理のパイプラインは、フックを次の順に並べます:setup → buildStart → config resolved → public locations resolved → content loaded → Markdown/HTML pipeline → post parsed → post processed → content graph → manifest created → diagnostics → build end。
フックの使い方
本当に必要な段階にだけフックを使ってください。後の段階の情報を前の段階で作り直すのは避けてください。たとえばonContentLoadedの中でマニフェストの情報を組み立て直さないでください。各フックが受け取るデータは段階ごとに増えます。onConfigResolvedはconfigを、onContentLoadedは生のコンテンツを、onPostParsedは解析済みのASTを、onPostProcessedは処理済みのHTMLを受け取り、onManifestCreatedは完全なマニフェストにアクセスできます。