Fork me on GitHub

Freemarker is a template engine for Java.


1) Add the pippo-freemarker dependency to your pom.xml:


2) Start writing Freemarker templates in the templates folder of your application.

Note: The default file extension of a Freemarker template is .ftl and it may be omitted from your templates and your Pippo Java code.


This engine includes some useful Pippo integration features and conveniences like…


You can access your translation resources using the i18n method.


You can supply arguments to your MessageFormat translation resources too.

${i18n("", "arg1", "arg2")}
prettytime (relative time)

The pippo-freemarker module supports automatically localized prettytime out-of-the-box and it is very easy to use.

Assuming you are providing a java.util.Date instance to prettyTime…


Will produce something like…

3 days ago

You can also automatically format localized dates using standard Java date format patterns.

${formatTime(now, "short")}
${formatTime(now, "medium")}
${formatTime(now, "long")}
${formatTime(now, "full")}
${formatTime(now, "HH:mm")}
${formatTime(now, "dd-MM-yyyy HH:mm")}
${formatTime(now, "dd-MM-yyyy HH:mm")}
webjarsAt & publicAt

The pippo-freemarker module supports context-aware url generation for your classpath resources using the webjarsAt and publicAt methods.

<!-- Stylesheets -->
<link href="${webjarsAt('bootstrap/3.3.1/css/bootstrap.min.css')}" rel="stylesheet">
<link href="${webjarsAt('font-awesome/4.2.0/css/font-awesome.min.css')}" rel="stylesheet">
<link href="${publicAt('css/style.css')}" rel="stylesheet">

<!-- Scripts -->
<script src="${webjarsAt('jquery/1.11.1/jquery.min.js')}"></script>
<script src="${webjarsAt('bootstrap/3.3.1/js/bootstrap.min.js')}"></script>
<script src="${publicAt('js/main.js')}"></script>

NOTE: Use of these methods require that you have registered a WebjarsResourceRoute and/or a PublicResourceRoute.

public class MyApplication extends Application {

    protected void onInit() {
        // add routes for static content
        // add other routes
Error Templates

The pippo-freemarker module will render special templates for routing problems and exceptions. You may override these templates within your own application (put a file with the same name, to same location, in your application classpath)

  • templates/pippo/404notFound.ftl
  • templates/pippo/500interalError.ftl