Added project-documentation
[juplo-dialect] / src / site / xhtml / index.xhtml
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
3  <head>
4  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5  </head>
6  <body>
7   <h1>${project.name}</h1>
8   <h2>${project.description}</h2>
9   <p>
10     The Juplo Thymeleaf-Dialect collects some usefull utils, that we found were missing in the thymeleaf-distribution.
11     The following attribute-processors are added by the dialect:
12   </p>
13   <ul>
14     <li>
15       The <strong>juplo:active</strong> substitutes an <code>&lt;a&gt;</code>-tag by an <code>&lt;strong&gt;</code>-tag, if its parameter evaluates to <code>true</code>.
16        The content of the tag and all attributes, that are also valid in the context of an <code>&lt;strong&gt;</code>-tag are kept.
17     </li>
18     <li>
19       The <strong>juplo:inactive</strong> substitutes an <code>&lt;a&gt;</code>-tag by an <code>&lt;span&gt;</code>-tag, if its parameter evaluates to <code>true</code>.
20        The content of the tag and all attributes, that are also valid in the context of an <code>&lt;span&gt;</code>-tag are kept.
21     </li>
22     <li>
23       The <strong>juplo:variables</strong> parses JSON-data, that must contain an object as root-element and imports the key/value-pairs of this object as node-local variables.
24     </li>
25   </ul>
26   <p>
27     <strong>juplo:active</strong> and <strong>juplo:inactive</strong> are very usefull, if you build a complex navigation-logic like a deep menu or a breadcrumb-path and do not want, that links to the current page appear in the markup.
28     <strong>juplo:variables</strong> can be used to make variables available to a thymeleaf-template, when it is not possible or desirable, to change or add a controller to do so.
29   </p>
30   <p>
31     This thymeleaf-dialect was developed as a part of the project
32     <a href="http://yourshouter.com/projekte/crowdgest%C3%BCtzte-veranstaltungs-suchmaschine.html">Entwicklung einer crowdgestützten Suchmaschine für Veranstaltungs- und Locationdaten</a>.
33     As one of the winners of the
34     <a href="http://yourshouter.com/referenzen/leitmarktwettbewerb-createmedia-nrw.html">CreateMedia.NRW</a>-contest,
35     the project is promoted by the
36     <a href="http://yourshouter.com/partner/mweimh-nrw.html">ministerium for economy, energy, industry, medium-sized bussinesses and handcraft for the state of North-Rhine Westphalia</a>
37     in the course of the
38     <a href="http://yourshouter.com/partner/efre--europ%C3%A4ischer-fonds-f%C3%BCr-regionale-entwicklung.html">OP EFRE.NRW 2014 — 2020</a>.
39   </p>
40   <h2>Releases</h2>
41   <ul>
42     <li><a href="${project.url}">current version</a></li>
43     <li>${project.version} (this version)</li>
44   </ul>
45  </body>
46 </html>