A metalsmith plugin for GatherContent using the hithercontent library.
npm install --save metalsmith-gathercontent
Please note you need to create
_auth.json with a GatherContent API key for this to work.
Also note tests wont work without an
_auth.json present in the project root.
Alternatively, you can use the following environment variables:
If you are using the command-line version of Metalsmith, you can install via npm, and then add the
metalsmith-jstransformer key to your
If you are using the JS Api for Metalsmith, then you can require the module and add it to your
var gatherContent = ;metalsmith;
var gatherContent = ;……
The id of you Gather Content project.
Key value pairs to map variables from the hithercontent output.
Where keys are the keys you want, and the values are what hithercontent is outputting.
This allows you to work with the Gather Content project as is.
All additional keys are stored in a
This plugin uses a "Meta" tab in gathercontent to store collections, and layouts.
Additionally if there are no mappings and a key
Content_Content is present it will be automatically mapped to the
contents property as a buffer.
As per hithercontent, keys within a Gather Content tab will be modified as follow
An array of Gather Content workflow status codes to filter against. This way you can work with only "ready" content. When blank it ingests all content in a project regardless of status code.
More console.logs when set to true
Files and Images
Right now any key with
__image in the index is processed as an image, and downloaded to
src/assets/gathercontent/ similarly for
__file we will likely need to change this. Images that are arrays are stored as arrays.