I'm developing a Java-servlet based project and I'm a newbie in this platform. I usually use Django, that has an awesome default template engine. Is there something similar for Java?
PS: Template inheritance is a must (to prevent repetition). There are several libraries like mustache which do not give this feature.
Rythm Template Engine should be exactly the thing you want. Not sure why you said the doc is not up to the mark.
Check out http://rythmengine.org/doc/template_guide.md#inheritance and play with the inheritance feature at http://fiddle.rythmengine.org/#/editor/886606b3a7034088b991855bef8f89da
Disclaimer: I am the author of Rythm
First you might want to have a read of This SO article that talks about the templating engines that are there and why to use which of them, that should get you started.
I personally have used the tiles framework and was very satisfied with it. You write your snippets and have a template to combine the parts (header, footer, navi, whatever) in always the same way.
The different tiles are regular JSP files and thus the integration is simple if you are used to JSP (which you will be if you work with Java, Servlets and JSP shortly)
I should notice that my experience with this is a bit dusted :) I didn't code for the web in years.
Chunk Templates provides support for this type of thing with {% exec %} like so:
base_template.chtml
<html>
<head>
</head>
<body>
{$body}
</body>
</html>
widget_detail.chtml
{% exec base_template %}
{$body=}
...
{=}
{% endexec %}
Here's a more interesting example where the base template provides some defaults that you can override from the servlet or in an exec:
base_template2.chtml
<html>
<head>
<title>{$page_title:Widget Emporium}</title>
</head>
<body>
{$top_nav:.include top_nav}
{$left_nav:.include left_nav}
{$body}
{$footer:.include footer}
</body>
</html>
top_nav.chtml
<div class="top_nav">
...
</div>
left_nav.chtml
<div class="left_nav">
...
<div>
footer.chtml
<div class="footer">
...
<div>
special_page.chtml - suppress all nav and use alternate footer
{% exec base_template2 %}
{$body=}
...
{=}
{$page_title = Special Page}
{$top_nav=}{=}
{$left_nav=}{=}
{$footer=}{% include special_footer %}{=}
{% endexec %}
exec also supports json and xml for tag value assignment.
For simpler things, Chunk syntax is quite similar to Django/jinja2. Filters are applied with pipes in the same way: {$tag|filter} and Chunk tags are written as {$tag} or {% $tag %} rather than {{ tag }} but you get used to it pretty quickly.
If-else branching in particular should look very familiar to anyone coming from Django:
{% if (...) %}
true-case
{% else %}
false-case
{% endif %}
Disclaimer: I am the author/maintainer for Chunk. The project is open-source and on GitHub.
base.htmland at the place where content is not same for all files, you say{{block body}}. Then, in another file, saylogin.html, if you're using template inheritance, you only need to say{extends base.html}and then{{start bodyblock}} Your new content {{end bodyblock}}. This will render the static as well as dynamic content. You can invoke any file from another file. – Ranveer Oct 22 '14 at 12:18