javalin / website

Javalin website source code
https://javalin.io
36 stars 87 forks source link

Jte tutorial provides invalid/confusing examples #241

Open dzikoysk opened 12 months ago

dzikoysk commented 12 months ago
  1. Let’s try to render our first template. Create the directory src/main/jte in your project. In this directory create a file hello.jte and enter the following:

It should reflect changes from https://github.com/javalin/javalin-rendering/issues/23

  1. private fun createTemplateEngine(): TemplateEngine { return if (isDevSystem) { val codeResolver = DirectoryCodeResolver(Path.of("src", "main", "jte")) TemplateEngine.create(codeResolver, ContentType.Html) } else { TemplateEngine.createPrecompiled(Path.of("jte-classes"), ContentType.Html) } }

Explain the difference between DirectoryCodeResolver/ResourceCodeResolver that is a key part for dev env. Explain that DirectoryCodeResolver handles relative path to local fs that depends on current workdir of app process (it may be needed once the src/resources/templates will become the default dir for jte renderer https://github.com/javalin/javalin-rendering/issues/23)

  1. Mention Gradle plugin:

https://github.com/casid/jte/blob/main/DOCUMENTATION.md#gradle

  1. Bump Jte version