Imports required AMP HTML custom-elements into source files.
npm install amphtml-autoscriptA Gulp plugin for automating the import of required custom-element tags in AMPHTML files.
Install package with NPM and add it to your development dependencies:
``
npm install --save-dev amphtml-autoscript
1. Add placeholder to your source files:
`html
${ampjs}
`
2. Incorporate the package in your gulpfile:
`js
const autoScript = require('amphtml-autoscript').create();
gulp.task('tag', () => {
return gulp.src('*.html')
.pipe(autoScript())
.pipe(gulp.dest('dist/'));
});
`
3. Generated AMP HTML now includes any required custom-element tags:
`html
`
Options can be passed to .create(options) to change the operation in the following ways:
`javascript`
{
// Alternative placeholder to replace, e.g. [AMPJS], ${ampjs}, <
placeholder: '...',
// Mode to operate in, either autoScript.MODES.PLACEHOLDER or autoScript.MODES.HEADER_INSERTION
// either replacing a string, or placing the elements at the end of the
mode: autoScript.MODES.
// Force the update of the AMP components map, which will otherwise not be fetched again.
updateComponentsMap: true,
// Force use of 'latest' for all components
forceLatest: true
}
Under normal operation, the component version will be read from components.json, part of the
module. This will not update unless forced using the options above.
To specify a version local to your project, create a amp-versions.json file
in your build working directory, specifying desired versions e.g.
`json`
{
"amp-carousel": "0.2"
}
NOTE: versions in amp-versions.json will take precedence over forceLatest.
* Updated to reflect changes in amphtml-validator error category reporting.
* Updated version dependencies.
* Added forceLatest and local component versions override.
* Added file to store snapshot of component versions.
* Fixed bug in callback usage that caused stream write errors
* Moved to using validator.
* Added HEADER_INSERTION` mode.