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.
{
"user": "[email protected]",
"akey": "XXXXXXXXXXXXXXXXXXXXXXXX"
}Alternatively, you can use the following environment variables:
GATHERCONTENT_USERGATHERCONTENT_AKEY
If you are using the command-line version of Metalsmith, you can install via npm, and then add the metalsmith-jstransformer key to your metalsmith.json file:
{
"plugins": {
"metalsmith-gathercontent": {}
}
}If you are using the JS Api for Metalsmith, then you can require the module and add it to your .use() directives:
var gatherContent = require('metalsmith-gathercontent');
metalsmith.use(gatherContent());var gatherContent = require('metalsmith-gathercontent');
…
.use(gatherContent({
authPath: '_auth.json',
projectId: 152172,
mappings: {
id: 'id',
slug: '_name',
title: 'Content_Title',
hero__image: 'Content_Hero-Image',
tier: 'tier',
summary: 'Content_Summary',
contents: 'Content_Content',
parentId: '_parent_id',
article__image_gallery: 'Content_Image-Gallery'
},
status: [
922006
]
}))
…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 fullData object.
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 TabName_KeyName
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
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.
MIT