eleventy-load-file
v0.1.0
Published
Emit files to the Eleventy output directory using eleventy-load
Downloads
143
Readme
eleventy-load-file
Emit files to the Eleventy output directory using eleventy-load.
Getting Started
Firstly, you'll need to install eleventy-load (if you haven't already) and eleventy-load-file. You'll probably want to use eleventy-load-file in combination with eleventy-load-html, so we'll install that as well.
npm install --save-dev eleventy-load eleventy-load-file eleventy-load-html
Then you can set up eleventy-load-file using a rule in your eleventy-load options.
module.exports = function (eleventyConfig) {
eleventyConfig.addPlugin(require("eleventy-load"), {
rules: [
{
test: /\.html$/,
loaders: [
{
loader: require("eleventy-load-html"),
},
],
},
{
test: /\.(png|jpe?g|gif)$/,
loaders: [
{
loader: require("eleventy-load-file"),
options: {
name: "[name].[hash:16].[ext]",
},
},
],
},
],
});
};
Options
| Name | Type | Default | Description |
| ------------------------------- | -------- | ----------------------- | ------------------------------------------ |
| name
| String
| "[hash].[ext]"
| Filename template for the emitted file |
| outputPath
| String
| this.config.outputDir
| Path where the emitted file will be placed |
| publicPath
| String
| "assets"
| Public path for the emitted file |
name
Type: String
Default: "[hash].[ext]"
Filename template for the emitted file which can include placeholders, see the list of placeholders below.
"[name].[hash:16].[ext]" // styles.c0c108d2da16f77a.css
outputPath
Type: String
Default: this.config.outputDir
Path where the emitted file will be placed. This defaults to the Eleventy project's output directory.
publicPath
Type: String
Default: "assets"
Public path for the emitted file within the output directory. By default, the file will be saved into an assets
folder, so the URL returned from eleventy-load-file will resemble /assets/styles.c0c108d2da16f77a.css
.
Placeholders
The following placeholders are replaced in the name
option:
[ext]
the extension of the resource[name]
the basename of the resource[hash]
or[hash:N]
the hash of the content of the resource, lengthN
defaults to 8 characters