Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

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

Aperta
#109 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
4/5
Tempo stimato
3-5 giorni
Idoneità per principianti
52/100
Tipo di issue
Bug
Chiarezza
Abbastanza chiara
Stato di attività
Attiva
Stack tecnologico
html

Direzione di ricerca

Inizia eseguendo djlint --lint *.html con .djlintrc, poi esamina come MegaLinter invoca HTML_DJLINT e confronta il relativo insieme di regole con il comando locale. Esamina CLAUDE.md, .djlintrc e sitemap.html; il lavoro è completato quando il comportamento locale e quello della CI sono intenzionali e documentati, e H006 e H031 sono stati corretti oppure esplicitamente ignorati.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

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

Lingua principale
HTML
Stelle
0
Fork
0
Merge medio
9h 52m
PR unite (30g)
59

Guida per i contributori

Nessuna guida per i contributori indicizzata per questo repository

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di laywill/laywill.github.io

Tutte le issue di laywill/laywill.github.io

Issue simili

Altre issue su DevOps

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.