Awesome
<h1 align="center"> <br> <a href="https://www.djlint.com"><img src="https://raw.githubusercontent.com/djlint/djLint/master/docs/src/static/img/icon.png" alt="djLint Logo" width="270"></a> <br> </h1> <h3 align="center">🏗️ Maintainers needed, please reach out on discord or email!</h3> <h4 align="center">The missing formatter and linter for HTML templates.</h4> <p align="center"> <a href="https://twitter.com/intent/tweet?text=djLint%20%7C%20The%20missing%20formatter%20and%20linter%20for%20HTML%20templates.&url=https://djlint.com/&hashtags=djlint,html-templates,django,jinja,developers"><img alt="tweet" src="https://img.shields.io/twitter/url/http/shields.io.svg?style=social" /></a> <a href="https://discord.gg/taghAqebzU"> <img src="https://badgen.net/discord/online-members/taghAqebzU?icon=discord&label" alt="Discord Chat"> </a> </p> <p align="center"> <a href="https://codecov.io/gh/djlint/djlint"> <img src="https://codecov.io/gh/djlint/djlint/branch/master/graph/badge.svg?token=eNTG721BAA" alt="Codecov Status"> </a> <a href="https://www.codacy.com/gh/djlint/djlint/dashboard?utm_source=github.com&utm_medium=referral&utm_content=djlint/djlint&utm_campaign=Badge_Grade"> <img src="https://app.codacy.com/project/badge/Grade/dba6338b0e7a4de896b45b382574f369" alt="Codacy Status"> </a> <a href="https://pepy.tech/project/djlint"> <img src="https://pepy.tech/badge/djlint" alt="Downloads"> </a> <a href="https://www.npmjs.com/package/djlint"> <img alt="npm" src="https://img.shields.io/npm/dt/djlint?label=npm%20downloads"> </a> <a href="https://pypi.org/project/djlint/"> <img src="https://img.shields.io/pypi/v/djlint" alt="Pypi Download"> </a> </p> <h4 align="center"><a href="https://www.djlint.com">How to use</a> • <a href="https://www.djlint.com/ru/">Как пользоваться</a> • <a href="https://www.djlint.com/fr/">Utilisation</a></h4> <h4 align="center">What lang are you using?</h4> <p align="center"> <a href="https://djlint.com/docs/languages/django/">Django</a> • <a href="https://djlint.com/docs/languages/jinja/">Jinja</a> • <a href="https://djlint.com/docs/languages/nunjucks/">Nunjucks</a> • <a href="https://djlint.com/docs/languages/twig/">Twig</a> • <a href="https://djlint.com/docs/languages/handlebars/">Handlebars</a> • <a href="https://djlint.com/docs/languages/mustach/">Mustache</a> • <a href="https://djlint.com/docs/languages/golang/">GoLang</a> • <a href="https://djlint.com/docs/languages/angular/">Angular</a> </p> <p align="center"> <img src="https://github.com/djlint/djLint/blob/aa9097660d4a2e840450de5456f656c42bc7dd34/docs/src/static/img/demo-min.gif" alt="demo" width="600"> </p>🤔 For What?
Once upon a time all the other programming languages had a formatter and linter. Css, javascript, python, the c suite, typescript, ruby, php, go, swift, and you know the others. The cool kids on the block.
HTML templates were left out there on their own, in the cold, unformatted and unlinted :( The dirty corner in your repository. Something had to change.
djLint is a community build project to and add consistency to html templates.
✨ How?
Grab it with pip
pip install djlint
Or with the npm experimental install - Note, this requires python and pip to be on your system path.
npm i djlint
Lint your project
djlint . --extension=html.j2 --lint
Check your format
djlint . --extension=html.j2 --check
Fix my format!
djlint . --extension=html.j2 --reformat
💙 Like it?
Add a badge to your projects readme.md
:
[![Code style: djlint](https://img.shields.io/badge/html%20style-djlint-blue.svg)](https://www.djlint.com)
Add a badge to your readme.rst
:
.. image:: https://img.shields.io/badge/html%20style-djlint-blue.svg
:target: https://www.djlint.com
Looks like this:
🛠️ Can I help?
Yes!
Would you like to add a rule to the linter? Take a look at the linter docs and source code
Are you a regex pro? Benchmark and submit a pr with improved regex for the linter rules
⚠️ Help Needed! ⚠️ Good with python? djLint was an experimental project and is catching on with other devs. Help out with a rewrite of the formatter to improve speed and html style for edge cases. Contribute on the 2.0 branch