This is an automated email from the ASF dual-hosted git repository.
olli pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/sling-site.git
The following commit(s) were added to refs/heads/master by this push:
new 52fb94a improve scripting documentation
52fb94a is described below
commit 52fb94af47f26e917c4e0329dd2d4e04e97820af
Author: Oliver Lietz <[email protected]>
AuthorDate: Sun Sep 22 13:46:08 2019 +0200
improve scripting documentation
---
.../content/documentation/bundles/scripting.md | 26 ++++++++++++++--------
1 file changed, 17 insertions(+), 9 deletions(-)
diff --git a/src/main/jbake/content/documentation/bundles/scripting.md
b/src/main/jbake/content/documentation/bundles/scripting.md
index 58d9c1a..3da6627 100644
--- a/src/main/jbake/content/documentation/bundles/scripting.md
+++ b/src/main/jbake/content/documentation/bundles/scripting.md
@@ -6,24 +6,32 @@ tags=scripts
[TOC]
-Sling Scripting allows the easy development and usage of different scripting
(aka templating) engines.
+## Sling Scripting Engines
+
+Sling Scripting is build around Java Scripting API (JSR 223). It allows the
easy development and usage of different scripting (aka templating) engines.
The script engines are managed in `SlingScriptEngineManager` ([Scripting
Core](https://github.com/apache/sling-org-apache-sling-scripting-core)).
-# Sling Scripting Engines
+| Engine | Language Name | Language Version | Names | Extensions | Mime Types
| GitHub Repo(s) | Documentation |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| [FreeMarker](https://freemarker.apache.org) | `FreeMarker` |
`freemarker.template.Configuration#getVersion().toString()` |
`FreeMarker`<br>`freemarker`<br>(configurable) | `ftl`<br>(configurable) |
`text/x-freemarker`<br>(configurable) |
[sling-org-apache-sling-scripting-freemarker](https://github.com/apache/sling-org-apache-sling-scripting-freemarker)
| |
+| [Groovy
(GString)](http://docs.groovy-lang.org/docs/next/html/documentation/template-engines.html#_gstringtemplateengine)
| `Groovy GString` | `org.codehaus.groovy.util.ReleaseInfo#getVersion()` |
`GString`<br>`gstring`<br>(configurable) | `gst`<br>(configurable) |
(configurable) |
[sling-org-apache-sling-scripting-groovy](https://github.com/apache/sling-org-apache-sling-scripting-groovy)
| |
+| [HTL](https://github.com/adobe/htl-spec) | `The HTL Templating Language` |
`1.4` | `htl`<br>`HTL`<br>`sightly` | `html` | |
[sling-org-apache-sling-scripting-sightly](https://github.com/apache/sling-org-apache-sling-scripting-sightly)
| [Scripting HTL](/documentation/bundles/scripting/scripting-htl.html) |
+| Java | `Java Servlet Compiler` | `1.5`| `java`<br>`Java` | `java` | |
[sling-org-apache-sling-scripting-java](https://github.com/apache/sling-org-apache-sling-scripting-java)
| |
+| JavaScript | `ECMAScript` | `partial ECMAScript 2015 support` |
`rhino`<br>`Rhino`<br>`javascript`<br>`JavaScript`<br>`ecmascript`<br>`ECMAScript`
| `esp`<br>`ecma` |
`text/ecmascript`<br>`text/javascript`<br>`application/ecmascript`<br>`application/javascript`
|
[sling-org-apache-sling-scripting-javascript](https://github.com/apache/sling-org-apache-sling-scripting-javascript)
| |
+| [JSP](https://projects.eclipse.org/projects/ee4j.jsp) | `Java Server Pages`
| `2.1` | `jsp`<br>`JSP` | `jsp`<br>`jspf`<br>`jspx` | |
[sling-org-apache-sling-scripting-jsp](https://github.com/apache/sling-org-apache-sling-scripting-jsp)
| [Scripting JSP](/documentation/bundles/scripting/scripting-jsp.html) |
+| [Thymeleaf](https://www.thymeleaf.org) | `Thymeleaf` | `version` from
[`/org/thymeleaf/thymeleaf.properties`](https://github.com/thymeleaf/thymeleaf/blob/3.0-master/src/main/resources/org/thymeleaf/thymeleaf.properties)
| `Thymeleaf`<br>`thymeleaf`<br>(configurable) | `html`<br>(configurable) |
`text/html`<br>(configurable) |
[sling-org-apache-sling-scripting-thymeleaf](https://github.com/apache/sling-org-apache-sling-scripting-thymeleaf)
| [Scripting Thymeleaf](/documentation/bundle [...]
+
+Several more engines are available but experimental or no longer maintained:
-*
[Freemarker](https://github.com/apache/sling-org-apache-sling-scripting-freemarker)
-* [Groovy](https://github.com/apache/sling-org-apache-sling-scripting-groovy)
-* [HTL](/documentation/bundles/scripting/scripting-htl.html)
-* [Java](https://github.com/apache/sling-org-apache-sling-scripting-java)
-*
[JavaScript](https://github.com/apache/sling-org-apache-sling-scripting-javascript)
-* [JSP](/documentation/bundles/scripting/scripting-jsp.html)
+* ESX
* JST
* Python
* Ruby
* Scala
-* [Thymeleaf](/documentation/bundles/scripting/scripting-thymeleaf.html)
* Velocity
* XProc
+## Scripting variables
+
See also [Scripting
variables](https://cwiki.apache.org/confluence/display/SLING/Scripting+variables)
and [Adding New Scripting
Variables](https://cwiki.apache.org/confluence/display/SLING/Adding+New+Scripting+Variables).
