インストール

モジュールをインストールします 

  1. npm install @wordpress/custom-templated-path-webpack-plugin --save-dev

注意: このパッケージは Node.js 12.0.0 以降が必要です。古いバージョンとは互換性がありません。webpack v4 のみで動作します。

使用法

CustomTemplatedPathPlugin のインスタンスを Webpack の設定 plugins エントリに構築し、キーがテンプレートタグ名に対応するオブジェクトを渡します。各キーの値は、元の意図されたパスとアセットに対応するデータを渡された関数です。

次の例では、ビルド出力ファイルの各エントリファイルのベース名を置き換える新しい basename タグを作成します。コンパイルされると、ビルドファイルは build-entry.js として出力されます。 

  1. const { basename } = require( 'path' );
  2. const CustomTemplatedPathPlugin = require( '@wordpress/custom-templated-path-webpack-plugin' );
  4. module.exports = {
  5.    // ...
  7.    entry: './entry',
  9.    output: {
  10.    filename: 'build-[basename].js',
  11.    },
  13.    plugins: [
  14.    new CustomTemplatedPathPlugin( {
  15.    basename( path, data ) {
  16.    let rawRequest;
  18.    const entryModule = get( data, [ 'chunk', 'entryModule' ], {} );
  19.    switch ( entryModule.type ) {
  20.    case 'javascript/auto':
  21.    rawRequest = entryModule.rawRequest;
  22.    break;
  24.    case 'javascript/esm':
  25.    rawRequest = entryModule.rootModule.rawRequest;
  26.    break;
  27.    }
  29.    if ( rawRequest ) {
  30.    return basename( rawRequest );
  31.    }
  33.    return path;
  34.    },
  35.    } ),
  36.    ],
  37. };

詳細な例については、Webpack の独自の TemplatedPathPlugin.js を参照してください。これは基本的なテンプレートタグのセットを実装しています。

このパッケージへの貢献

これは Gutenberg プロジェクトの一部である個別のパッケージです。このプロジェクトはモノレポとして整理されています。特定の目的を持つ複数の自己完結型ソフトウェアパッケージで構成されています。このモノレポ内のパッケージは npm に公開され、WordPress や他のソフトウェアプロジェクトで使用されています。

このパッケージや Gutenberg 全体への貢献について詳しく知りたい場合は、プロジェクトの主要な 貢献者ガイド をお読みください。