You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@sling.apache.org by gi...@apache.org on 2021/07/22 18:27:35 UTC
[sling-site] branch asf-site updated: Automatic website deployment
from
https://ci-builds.apache.org/job/Sling/job/modules/job/sling-site/job/master/226/
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 <bu...@apache.org>
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>