This is an automated email from the ASF dual-hosted git repository.
git-site-role pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/sling-site.git
The following commit(s) were added to refs/heads/asf-site by this push:
new f4de46e Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/226/
f4de46e is described below
commit f4de46e6a82cca7670e820fcaff141ecd9e77281
Author: jenkins <[email protected]>
AuthorDate: Thu Jul 22 18:27:32 2021 +0000
Automatic website deployment from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/226/
---
documentation/bundles/scripting/scripting-htl.html | 27 ++++++++++++++++++----
1 file changed, 22 insertions(+), 5 deletions(-)
diff --git a/documentation/bundles/scripting/scripting-htl.html
b/documentation/bundles/scripting/scripting-htl.html
index c53630e..b0dadf6 100644
--- a/documentation/bundles/scripting/scripting-htl.html
+++ b/documentation/bundles/scripting/scripting-htl.html
@@ -120,7 +120,7 @@
</li>
</ul>
</nav><script src='/res/jquery-3.2.1.min.js'
type='text/javascript'></script><script src='/res/tocjs-1-1-2.js'
type='text/javascript'></script><script
type='text/javascript'>$(document).ready(function() {
$('#generatedToC').toc({'selector':'h1[class!=title],h2,h3','ulClass':'menu-list'});
} );</script><div class="content is-marginless">
-<div class="row"><div><section><p>The Apache Sling HTL Scripting Engine, <a
href="https://issues.apache.org/jira/browse/SLING-6028";>formerly known as
Sightly</a>, is the reference implementation of the <a
href="https://github.com/Adobe-Marketing-Cloud/htl-spec";>HTML Template
Language</a>.</p>
+<div class="row"><div><section><p>The Apache Sling HTL Scripting Engine, <a
href="https://issues.apache.org/jira/browse/SLING-6028";>formerly known as
Sightly</a>, is the reference implementation of the <a
href="https://github.com/Adobe-Marketing-Cloud/htl-spec";>HTML Template Language
1.4</a>.</p>
<p><!-- TODO reactivate TOC once JBake moves to flexmark-java -->
</p>
<h1><a href="#modules" id="modules">Modules</a></h1>
@@ -134,7 +134,7 @@
<li><a
href="https://github.com/apache/sling-org-apache-sling-scripting-sightly-repl";><code>org.apache.sling.scripting.sightly.repl</code></a>
- HTL Read-Eval-Print Loop Environment (REPL), useful for quickly prototyping
scripts</li>
<li><a
href="https://github.com/apache/sling-htl-maven-plugin";><code>htl-maven-plugin</code></a>
- M2Eclipse compatible HTL Maven Plugin that provides support for validating
HTML Template Language scripts from projects during build time</li>
</ol>
-<h1><a href="#the-use-api" id="the-use-api">The Use-API</a></h1>
+<h2><a href="#the-use-api" id="the-use-api">The Use-API</a></h2>
<p>The <a
href="https://github.com/Adobe-Marketing-Cloud/htl-spec/blob/1.2/SPECIFICATION.md#4-use-api";>HTML
Template Language Specification</a> explicitly defines two ways of
implementing support for business logic objects:</p>
<ol>
<li>
@@ -170,8 +170,25 @@ use(['dep1.js', 'dep2.js'], function (Dep1, Dep2) {
</li>
</ol>
<p>The HTL implementation from Sling provides the basic POJO support through
the <a
href="https://github.com/apache/sling-org-apache-sling-scripting-sightly-compiler-java/blob/master/src/main/java/org/apache/sling/scripting/sightly/pojo/Use.java";><code>org.apache.sling.scripting.sightly.pojo.Use</code></a>
interface and the <a
href="https://github.com/apache/sling-org-apache-sling-scripting-sightly/blob/master/src/main/java/org/apache/sling/scripting/sightly/impl/engine/extension/use/Jav
[...]
-<p>However, the Sling implementation provides a few extensions to the
Use-API.</p>
-<h2><a href="#sling-specific-use-api-extensions"
id="sling-specific-use-api-extensions">Sling-specific Use-API
Extensions</a></h2>
+<h1><a href="#extensions-of-the-htl-specification"
id="extensions-of-the-htl-specification">Extensions of the HTL
Specification</a></h1>
+<p>The Sling HTL Scripting engine fully complies with the <a
href="https://github.com/adobe/htl-spec/blob/1.4/SPECIFICATION.md";>HTML
Template Language Specification 1.4</a>. In addition it adds some extensions
which are not part of the specification.</p>
+<h2><a href="#expression-options" id="expression-options">Expression
Options</a></h2>
+<h3><a href="#format-date" id="format-date">Format Date</a></h3>
+<p>In addition to the regular patterns defined in <a
href="https://github.com/adobe/htl-spec/blob/1.4/SPECIFICATION.md#1222-dates";>HTL
Spec 1.2.2.2</a> the following special formatting patterns are supported (<a
href="https://issues.apache.org/jira/browse/SLING-9983";>SLING-9983</a>) for
formatting dates only (disregarding time) in a decent format for the used
locale. <em>The result depends on the JDK version though, as it changed
fundamentally with <a href="https://openjdk.java.net/jeps/ [...]
+<table>
+<thead>
+<tr><th>Pattern </th><th> Description </th><th> Example (for Locale
en_US)</th></tr>
+</thead>
+<tbody>
+<tr><td><code>short</code> </td><td> A short representation of the date
(disregarding time), typically numeric </td><td> 10/26/85</td></tr>
+<tr><td><code>medium</code> </td><td> A medium representation of the date
(disregarding time), with some detail </td><td> Oct 26, 1985</td></tr>
+<tr><td><code>long</code> </td><td> A long representation of the date
(disregarding time), with lots of detail </td><td> October 26, 1985</td></tr>
+<tr><td><code>full</code> </td><td> The full represenation of the date
(disregarding time), with the most detail </td><td> Saturday, October 26,
1985</td></tr>
+<tr><td><code>default</code> </td><td> Is equal to <code>medium</code>
</td><td> Oct 26, 1985</td></tr>
+</tbody>
+</table>
+<h2><a href="#use-api-extensions" id="use-api-extensions">Use-API
Extensions</a></h2>
+<p>The Sling implementation provides a few extensions to the Use-API.</p>
<p>A full HTL installation provides the following Use Providers, in the order
of their priority (the higher the service ranking value, the higher the
priority):</p>
<table>
<thead>
@@ -542,7 +559,7 @@ use // the use function
</div><footer class="footer">
<div class="content has-text-centered is-small">
<div class="revisionInfo">
- Last modified by <span class="author">Radu
Cotescu</span> on <span class="comment">Thu Apr 1 12:19:29 2021 +0200</span>
+ Last modified by <span class="author">Konrad
Windszus</span> on <span class="comment">Thu Jul 22 20:24:45 2021 +0200</span>
</div> <p>
Apache Sling, Sling, Apache, the Apache feather logo,
and the Apache Sling project logo are trademarks of The Apache Software
Foundation. All other marks mentioned may be trademarks or registered
trademarks of their respective owners.
</p><p>
