共通の書式
workerディレクティブは以下の形式で記述します。
cmd
実行するworkerディレクティブ名を指定します。
型
スカラー(文字列)
値
| ディレクティブ名 | ディレクティブ名を指定します。省略できません。 |
例
worker:
scripts:
- cmd: optimizeargs
実行するworkerディレクティブのオプションを指定します。
型
シーケンス(マッピング) または マッピング
値
オプションは指定したworkerディレクティブにより異なります。各workerディレクティブを参照してください。
例
worker:
scripts:
- cmd: optimize
args:
ie11: true
ie11_ab: trueapply
実行するworkerディレクティブを適用するパス、または、条件を指定します。
複数指定した場合はOR条件になります。
型
シーケンス(文字列)
値
| パス | workerディレクティブを適用するパス、または、条件を正規表現で指定します。 デフォルトは、PST設定ファイルのglobal_excludeに指定したパス以外の全てのリソースに対して有効となります。 |
例
worker:
scripts:
- cmd: optimize
apply:
- ^/wp-contentexclude
実行するworkerディレクティブの適用を除外するパス、または、条件を指定します。
複数指定した場合はOR条件になります。
型
シーケンス(文字列)
値
| パス | workerディレクティブの適用を除外するパス、または、条件を指定します。 デフォルトは、PST設定ファイルのglobal_excludeに指定したパス以外の全てのリソースに対して有効となります。 |
例
worker:
scripts:
- cmd: optimize
exclude:
- /wp-content/pluginsworker > images ディレクティブ
optimize
画像のリソース最適化の方法を設定します。
args
最適化の方法を複数記述できます。複数記述した場合は、先にマッチした条件が適用されます。オプションの指定がない場合、リソース最適化を行いません。
型
シーケンス(マッピング)
args > formats
画像のリソース最適化を適用するフォーマットを指定します。指定がない場合は画像のリソース最適化を行いません。
型
シーケンス(文字列)
値
| png | pngファイルを対象に画像の最適化を行います。 |
| jpg | jpg/jpegファイルを対象に画像の最適化を行います。 |
| gif | gifファイルを対象に画像の最適化を行います。 |
| webp | 最適化したファイルとしてWebPファイルを出力します。 |
| jp2 | 最適化ファイルとしてJPEG2000ファイルを出力します。 |
| jxr | 最適化ファイルとしてJXRファイルを出力します。 |
args > resize
画像の最大解像度を指定します。縦、あるいは横の値が指定した値を越える場合、指定した最大解像度に収まるようにアスペクト比を維持して縮小します。画像を縮小することでファイルサイズが小さくなります。指定がない場合はリサイズしません。
型
スカラー(文字列)
値
| 横ピクセルx縦ピクセル | 解像度を指定します。 |
args > quality
画像圧縮レベルを指定します。低い値ほど圧縮されてファイルサイズが小さくなりますが、画質が劣化します。指定がない場合は変更しません。
型
スカラー(数値)
値
| 画像圧縮レベル | 1から100の値を指定します。 |
args > strip
画像に含まれるメタデータやコメントを削除します。画像表示に直接関係しないデータを減らすことで、ファイルサイズが小さくなります。指定がない場合は変更しません。
型
スカラー(ブール)
値
| true | メタデータやコメントを削除します。 |
| false | メタデータやコメントを削除しません。 |
args > gif_lossy
GIF画像を圧縮する際、許容する圧縮アーティファクトを指定します。値を大きくすると、ファイルサイズが小さくなりますが、圧縮アーティファクトが多くなります。指定がない場合は変更しません。
型
スカラー(数値)
値
| 圧縮アーティファクト | 30から200の値を指定します。 |
args > webp_lossy
WebP画像の画像圧縮レベルを指定します。低い値ほど圧縮されてファイルサイズが小さくなりますが、画質が劣化します。指定がない場合は変更しません。
型
スカラー(数値)
値
| 画像圧縮レベル | 1から100の値を指定します。 |
例
worker:
images:
- cmd: optimize
args:
formats:
- png
- jpg
- gif
- webp
resize: 1920x1080
quality: 80
strip: true
gif_lossy: 80
webp_lossy: 75
apply: .
exclude: /wp-content/uploads/2019/worker > scripts ディレクティブ
optimize
スクリプトのリソース最適化の方法を設定します。
args
最適化の方法を複数記述できます。複数記述した場合は、先にマッチした条件が適用されます。オプションの指定がない場合、リソース最適化を行いません。
型
シーケンス(マッピング)
args > ie11
IE11向けの最適化を有効にします。
型
スカラー(ブール)
値
| true | 有効にします。 |
| false | 無効にします。 デフォルトは無効です。 |
args > ie11_ab
IE11向けの最適化を有効にした際、A/Bテストを有効にして、よりファイルサイズが小さくなる方を適用します。
型
スカラー(ブール)
値
| true | 有効にします。 |
| false | 無効にします。 デフォルトは無効です。 |
例
worker:
scripts:
- cmd: optimize
args:
ie11: true
ie11_ab: true
apply: .
exclude: /wp-content/themes/twentytwenty/worker > stylesheets ディレクティブ
optimize
スタイルシートのリソース最適化の方法を設定します。
args
最適化の方法を複数記述できます。複数記述した場合は、先にマッチした条件が適用されます。オプションの指定がない場合、リソース最適化を行いません。
型
シーケンス(マッピング)
args > ie11
IE11向けの最適化を有効にします。
型
スカラー(ブール)
値
| true | 有効にします。 |
| false | 無効にします。 デフォルトは無効です。 |
args > ie11_ab
IE11向けの最適化を有効にした際、A/Bテストを有効にして、よりファイルサイズが小さくなる方を適用します。
型
スカラー(ブール)
値
| true | 有効にします。 |
| false | 無効にします。 デフォルトは無効です。 |
例
worker:
stylesheets:
- cmd: optimize
args:
ie11: true
ie11_ab: true
apply: .
exclude: /wp-content/themes/twentytwenty/