Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

djlint run locally reports 54 findings that MegaLinter's HTML_DJLINT never surfaces

Abierto
#109 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
4/5
Tiempo estimado
3-5 días
Aptitud para principiantes
52/100
Tipo de issue
Error
Claridad
Bastante claro
Estado de actividad
Activo
Stack tecnológico
html

Línea de trabajo

Empieza ejecutando djlint --lint *.html con .djlintrc; después, revisa cómo MegaLinter invoca HTML_DJLINT y compara su conjunto de reglas con el comando local. Revisa CLAUDE.md, .djlintrc y sitemap.html; se considera terminado cuando el comportamiento local y el de CI sean deliberados y estén documentados, y H006 y H031 se hayan corregido o se hayan ignorado explícitamente.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

Found incidentally while checking whether an inline onerror on a script tag would trip an HTML rule (#94 / #108). Not caused by that change - it reproduces identically on master.

What happens

Running djlint over the pages the way .djlintrc configures it:

$ djlint --lint *.html
...
Linted 16 files, found 54 errors.

54 findings, all pre-existing:

  • H006 (53) - Img tag should have height and width attributes, on essentially every <img> on the site, banner/spotlight heroes and gallery thumbs alike.
  • H031 (1) - Consider adding meta keywords, on sitemap.html only. Every other page has the meta tag; sitemap.html does not.

MegaLinter is green on master and green on #108, so HTML_DJLINT as MegaLinter invokes it is evidently not running --lint, or is running it with a different rule set. Verified by exporting masters HTML plus .djlintrc to a clean directory and linting there: same 54, same set.

Why it is worth a look

Two separate things, and they want separating:

  1. The gate does not do what the docs imply. CLAUDE.md says the pre-commit hooks are the fast local subset and "full linting is MegaLinter in CI". Anyone who takes that at face value, runs djlint locally to check their HTML before pushing, and gets 54 errors will either assume they broke something or conclude djlint is noise and stop running it. Whichever HTML_DJLINT is actually doing, the discrepancy should be deliberate and written down.
  2. H006 is not purely cosmetic. Missing intrinsic dimensions on the hero and gallery images means the browser cannot reserve space before the image decodes, which is layout shift on exactly the sections #85, #87 and #92 were about. The .image containers may already be sized in CSS, in which case the finding is genuinely moot here and the rule should be added to the ignore list in .djlintrc next to H021 and H023, with the reason - rather than left to fail silently for whoever runs the tool by hand.

Suggested outcome

Establish which mode MegaLinter runs HTML_DJLINT in, then either bring the local invocation into line with it or record why they differ. Separately, decide H006 on its merits - fix the dimensions, or ignore the rule with a stated reason. H031 on sitemap.html is a one-line fix or a one-line ignore either way.

Refs #94, #108

Lenguaje dominante
HTML
Estrellas
0
Forks
0
Merge medio
9 h 52 min
PR fusionados (30 d)
59

Guía de contribución

No hay ninguna guía de contribución indexada para este repositorio

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de laywill/laywill.github.io

Todos los issues de laywill/laywill.github.io

Issues similares

Más issues de DevOps

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.