Freemarker Template Formatter

Freemarker Template Formatter verwerkt FTL-bronbestanden om een consistente, leesbare lay-out te produceren zonder de semantiek van de sjablonen te wijzigen. Het richt zich op ontwikkelaars en templating-teams die grote codebases met veel bijdragers beheren. De tool accepteert ruwe Freemarker-sjablonen, analyseert structurele elementen zoals directives, macro-definities en geneste blokken, en past een uniforme stijl toe op witruimte, inspringing en regelafbrekingen. Door deze aspecten te normaliseren worden diffs makkelijker te beoordelen en wijzigingen minder foutgevoelig, vooral in CI-pijplijnen of bij het onboarden van nieuwe teamleden.
Het gebruikt een Freemarker-tekst parser om blokken zoals <#if>, <#list> en <#macro> te identificeren, hun inhoud te behouden terwijl omringende witruimte wordt herschikt. De formatter ondersteunt configureerbare inspringingsbreedtes (2 of 4 spaties), een maximale regellengte en optionele attribuut-wrapping. Het behoudt opmerkingen, tekenreeks-literals en interpolatie-uitdrukkingen en wijzigt runtime-uitdrukkingen niet. Gevorderde gebruikers kunnen attribuut wrapping in- of uitschakelen, beslissen of lege regels behouden blijven en een side-by-side diff genereren voor beoordeling.
Toepassingsgevallen omvatten pre-commit opmaak, CI-controles en bulkopschoning van verouderde sjablonen over services. Het hulpmiddel is vooral waardevol voor Java-gebaseerde webapps die Freemarker gebruiken voor server-side rendering, waardoor consistente sjablonen over modules heen mogelijk zijn en merge-conflicten verminderen. De unieke waarde ligt in domeinspecifieke opmaak die Freemarker-semantiek respecteert terwijl pragmatische standaardwaarden en optionele aanpassingen worden geboden.