The generated manifest file contains information about the source images and generated formats. It allows you to explicitly choose which values you would like to export from the accompanying image metadata.
To learn more about the metadata object, see the conceptual overview.
Manifest generation is disabled by default. To enable it, you must specify a
manifest object in
the configuration. The best way to understand is with an example.
The above manifest will output the source hash (limited to 8 characters) and the width, height, format and path of each exported format.
It would also be possile to specify
x: source.hash:8 under the format key, however it would be
wasteful, as every format would include a copy of the hash. The source key allows you to extract
common information that is relevant for all generated formats.
The manifest file depends on the pipeline. Considering a simple pipeline that exports a single JPEG and WebP format for each source, a possible manifest file would be:
The manifest is designed to be as compact as possible, and completely coustomizable. The above is
would be useful, as it provides the source image hash (which never changes, as long as the file
contents never change), regardless of where you put it, and provides some basic information which
can be used to construct a responsive
The following metadata keys are always populated and can be used for the manifest. Other available keys depend on the configured pipeline.
- format, width, height, channels, hash: populated by @ipp/core
- path: the path to the image, relative to the output directory