41 lines
2.2 KiB
Markdown
41 lines
2.2 KiB
Markdown
|
<p align="center"><img src="https://www.11ty.dev/img/logo-github.svg" width="200" height="200" alt="eleventy Logo"></p>
|
|||
|
|
|
|||
|
|
# eleventy-img
|
|||
|
|
|
|||
|
|
Requires Node 18+
|
|||
|
|
|
|||
|
|
Low level utility to perform build-time image transformations for both vector and raster images. Output multiple sizes, save multiple formats, cache remote images locally. Uses the [sharp](https://sharp.pixelplumbing.com/) image processor.
|
|||
|
|
|
|||
|
|
You maintain full control of your HTML. Use with `<picture>` or `<img>` or CSS `background-image`, or others! Works great to add `width` and `height` to your images!
|
|||
|
|
|
|||
|
|
## [The full `eleventy-img` documentation is on 11ty.dev](https://www.11ty.dev/docs/plugins/image/).
|
|||
|
|
|
|||
|
|
* _This is a plugin for the [Eleventy static site generator](https://www.11ty.dev/)._
|
|||
|
|
* Find more [Eleventy plugins](https://www.11ty.dev/docs/plugins/).
|
|||
|
|
* Please star [Eleventy on GitHub](https://github.com/11ty/eleventy/), follow [@eleven_ty](https://twitter.com/eleven_ty) on Twitter, and support [11ty on Open Collective](https://opencollective.com/11ty)
|
|||
|
|
|
|||
|
|
[](https://www.npmjs.com/package/@11ty/eleventy-img) [](https://github.com/11ty/eleventy-img/issues)
|
|||
|
|
|
|||
|
|
## Installation
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
npm install --save-dev @11ty/eleventy-img
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
_[The full `eleventy-img` documentation is on 11ty.dev](https://www.11ty.dev/docs/plugins/image/)._
|
|||
|
|
|
|||
|
|
## Tests
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
npm run test
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- We use the [ava JavaScript test runner](https://github.com/avajs/ava) ([Assertions documentation](https://github.com/avajs/ava/blob/master/docs/03-assertions.md))
|
|||
|
|
- ℹ️ To keep tests fast, thou shalt try to avoid writing files in tests.
|
|||
|
|
|
|||
|
|
## Community Roadmap
|
|||
|
|
|
|||
|
|
- [Top Feature Requests](https://github.com/11ty/eleventy-img/issues?q=label%3Aneeds-votes+sort%3Areactions-%2B1-desc+label%3Aenhancement) (Add your own votes using the 👍 reaction)
|
|||
|
|
- [Top Bugs 😱](https://github.com/11ty/eleventy-img/issues?q=is%3Aissue+is%3Aopen+label%3Abug+sort%3Areactions-%2B1-desc) (Add your own votes using the 👍 reaction)
|
|||
|
|
- [Newest Bugs 🙀](https://github.com/11ty/eleventy-img/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
|
