49 lines
2.6 KiB
Markdown
49 lines
2.6 KiB
Markdown
|
<p align="center"><img src="https://www.11ty.io/img/logo-github.png" alt="eleventy Logo"></p>
|
|||
|
|
|||
|
# eleventy 🕚⚡️
|
|||
|
|
|||
|
A simpler static site generator. An alternative to Jekyll. Written in JavaScript. Transforms a directory of templates (of varying types) into HTML.
|
|||
|
|
|||
|
Works with HTML, Markdown, Liquid, Nunjucks, Handlebars, Mustache, EJS, Haml, Pug, and JavaScript Template Literals.
|
|||
|
|
|||
|
## ➡ [Documentation](https://www.11ty.io/docs/)
|
|||
|
|
|||
|
- Please star [this repo on GitHub](https://github.com/11ty/eleventy/)!
|
|||
|
- Follow us on Twitter [@eleven_ty](https://twitter.com/eleven_ty)
|
|||
|
- Support [11ty on Open Collective](https://opencollective.com/11ty)
|
|||
|
- [11ty on npm](https://www.npmjs.com/org/11ty)
|
|||
|
- [11ty on GitHub](https://github.com/11ty)
|
|||
|
- [11ty/eleventy on Travis CI](https://travis-ci.org/11ty/eleventy)
|
|||
|
|
|||
|
[![npm Version](https://img.shields.io/npm/v/@11ty/eleventy.svg?style=for-the-badge)](https://www.npmjs.com/package/@11ty/eleventy) [![GitHub issues](https://img.shields.io/github/issues/11ty/eleventy.svg?style=for-the-badge)](https://github.com/11ty/eleventy/issues) [![code style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=for-the-badge)](https://github.com/prettier/prettier) [![npm Downloads](https://img.shields.io/npm/dt/@11ty/eleventy.svg?style=for-the-badge)](https://www.npmjs.com/package/@11ty/eleventy)
|
|||
|
|
|||
|
## Installation
|
|||
|
|
|||
|
```
|
|||
|
npm install @11ty/eleventy --save-dev
|
|||
|
```
|
|||
|
|
|||
|
Read our [Getting Started guide](https://www.11ty.io/docs/getting-started/).
|
|||
|
|
|||
|
## 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.
|
|||
|
- [Code Coverage Statistics](https://github.com/11ty/eleventy/blob/master/docs/coverage.md)
|
|||
|
- [Benchmark for Performance Regressions](https://github.com/11ty/eleventy-benchmark)
|
|||
|
|
|||
|
## Major Roadmapped Features
|
|||
|
|
|||
|
- [Top Feature Requests](https://github.com/11ty/eleventy/issues?q=label%3Aneeds-votes+sort%3Areactions-%2B1-desc) (Add your own votes using the 👍 reaction)
|
|||
|
- [Documentation Requests](https://github.com/11ty/eleventy/issues?utf8=%E2%9C%93&q=is%3Aissue+sort%3Areactions-%2B1-desc+is%3Aclosed+label%3Adocumentation+label%3Aneeds-votes) (Add your own votes using the 👍 reaction)
|
|||
|
- [Top Bugs 😱](https://github.com/11ty/eleventy/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/issues?q=is%3Aopen+is%3Aissue+label%3Abug)
|
|||
|
|
|||
|
## Plugins
|
|||
|
|
|||
|
See the [official docs on plugins](https://www.11ty.io/docs/plugins/).
|