You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@velocity.apache.org by cb...@apache.org on 2021/03/08 18:28:59 UTC
[velocity-site] branch main updated (ac2f3d8 -> 0b47800)
This is an automated email from the ASF dual-hosted git repository.
cbrisson pushed a change to branch main
in repository https://gitbox.apache.org/repos/asf/velocity-site.git.
from ac2f3d8 [site] Update changelogs tags
new 565064a [site] Prepare download page for new releases; fix VELOCITY-936
new 56ecd8e [site] Document dockerized site building
new 0b47800 [site] Some style tweaks
The 3 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
src/content/css/site.css | 23 +++-
src/content/download.mdtext | 226 +++++++++++++++++++++++----------------
src/content/site-building.mdtext | 47 +++++++-
3 files changed, 197 insertions(+), 99 deletions(-)
[velocity-site] 02/03: [site] Document dockerized site building
Posted by cb...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
cbrisson pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/velocity-site.git
commit 56ecd8e22dbfdee544cbc9bf26460f9bbcd42c3d
Author: Claude Brisson <cl...@renegat.net>
AuthorDate: Mon Mar 8 19:28:30 2021 +0100
[site] Document dockerized site building
---
src/content/site-building.mdtext | 47 +++++++++++++++++++++++++++++++++++-----
1 file changed, 42 insertions(+), 5 deletions(-)
diff --git a/src/content/site-building.mdtext b/src/content/site-building.mdtext
index b04916b..dd733a7 100644
--- a/src/content/site-building.mdtext
+++ b/src/content/site-building.mdtext
@@ -13,15 +13,52 @@ In short: This repository is only interesting for you if you
+ want to re-create the Apache Velocity site on your local computer or intranet.
+ are an [Apache Velocity committer](/who-we-are.html) and want to update the site.
-### Editing the Site
+### Editing the site
-Apache Velocity uses the [Apache Content Management System](http://www.apache.org/dev/cms.html) to manage its site.
+Most of the site sources are in plain markdown, more specifically in [python-markdown](https://python-markdown.github.io/).
-The site is not *hosted* by the CMS (it's planned to move it to pelican), so it still has to be build locally.
+### Building the site with docker
+
+This method is by far the easiest one.
+
+1. Clone the site sources
+
+If you are a Velocity commiter, you will want to directly edit the site sources:
+
+ :::shell
+ git clone https://github.com/apache/velocity-site.git
+
+If you are a contributor, you should first fork the site sources to your github account, and use:
+
+ :::shell
+ git clone --single-branch --branch master git@github.com:[YOUR_GITHUB_ID]/velocity-site.git
+
+2. Clone the site production pages
+
+As a commiter you will use it to push into production the generated site. As a contributor, you will use it to check locally the result of your changes.
+
+This clone must be called `velocity-site-prod` and must be made in the same directory as the `velocity-site` one.
-### Building the Site
+ :::shell
+ git clone --single-branch --branch asf-site https://github.com/apache/velocity-site.git velocity-site-prod
+
+3. Make your changes to the site sources
+
+4. Run the script `velocity-site/builder/bin/builder.sh` (linux implied...)
+
+5. Check the result using your favorite browser
+
+6. Advertize your changes
+
+Commiters have to push the changes in both clones. Contributors only need to submit a pull request to the site sources.
+
+### Building the site without docker
+
+Apache Velocity uses the [Apache Content Management System](https://www.apache.org/dev/cms.html) to manage its site.
+
+The site is not *hosted* by the CMS (it's planned to move it to pelican), so it still has to be build locally.
-To build the site locally, you'll need a local checkout of the [Apache CMS](https://svn.apache.org/repos/infra/websites/cms), then refer to the [STATUS](https://svn.apache.org/repos/infra/websites/cms/STATUS) file.
+To do so, you'll need a local checkout of the [Apache CMS](https://svn.apache.org/repos/infra/websites/cms), then refer to the [STATUS](https://svn.apache.org/repos/infra/websites/cms/STATUS) file.
You'll of course also need a local clone of [the site sources](https://gitbox.apache.org/repos/asf/velocity-site.git), or even preferably a local clone of [github's mirror](https://github.com/apache/velocity-site.git), where you can submit pull requests.
You'll have to generate the site in some `target` temporary directory, then check added/modified/deleted files in the `asf-site` branch of the `velocity-site` repository.
[velocity-site] 03/03: [site] Some style tweaks
Posted by cb...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
cbrisson pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/velocity-site.git
commit 0b478001e34f7fdef128cc1120fac759f1863ccd
Author: Claude Brisson <cl...@renegat.net>
AuthorDate: Mon Mar 8 19:28:54 2021 +0100
[site] Some style tweaks
---
src/content/css/site.css | 23 +++++++++++++++++++----
1 file changed, 19 insertions(+), 4 deletions(-)
diff --git a/src/content/css/site.css b/src/content/css/site.css
index 5ad5af9..cff1c1e 100644
--- a/src/content/css/site.css
+++ b/src/content/css/site.css
@@ -126,20 +126,30 @@ h1
h2
{
- font-size: 1.2em;
+ font-size: 1.3em;
}
h3
{
- font-size: 1em;
+ font-size: 1.2em;
+}
+
+h3::before
+{
+ content: '> ';
}
h4
{
- font-size: 1em;
- font-weight: 300;
+ font-size: 1.1em;
}
+h4::before
+{
+ content: '>> ';
+}
+
+
hr
{
margin-top: 1em;
@@ -453,6 +463,11 @@ table.conversions th
word-wrap: no;
}
+.smalltable td, .smalltable th
+{
+ text-align: left;
+}
+
.blue
{
color: blue;
[velocity-site] 01/03: [site] Prepare download page for new
releases; fix VELOCITY-936
Posted by cb...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
cbrisson pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/velocity-site.git
commit 565064aee1cb807215e259daa7ef5282d9acea3e
Author: Claude Brisson <cl...@renegat.net>
AuthorDate: Mon Mar 8 19:28:10 2021 +0100
[site] Prepare download page for new releases; fix VELOCITY-936
---
src/content/download.mdtext | 226 ++++++++++++++++++++++++++------------------
1 file changed, 136 insertions(+), 90 deletions(-)
diff --git a/src/content/download.mdtext b/src/content/download.mdtext
index 4c006d8..a724489 100644
--- a/src/content/download.mdtext
+++ b/src/content/download.mdtext
@@ -4,6 +4,8 @@ Title: Apache Velocity - Download Page
You can download sources and binaries for all Apache Velocity projects from here.
+[TOC]
+
### Mirror Selection
[if-any logo] <a href="[link]"><img src="[logo]" align="right" border="0" alt="logo" /></a>[end]
@@ -16,7 +18,7 @@ The currently selected mirror is <b>[preferred]</b>. If you encounter a problem
[if-any http]
[for http]
<option value="[http]">[http]</option>
- [end]
+ [end] a
[end]
[if-any ftp]
[for ftp]
@@ -45,18 +47,28 @@ The <tt>SHA</tt> links download the checksum from the main site. None of these s
These releases are considered stable and suitable for production.
-### Engine
+### Velocity Engine 2.3
+
+Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine/2.3/release-notes.html) and the [dependencies](https://velocity.apache.org/engine/2.3/dependencies.html).
-Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine/2.2/release-notes.html) and the [dependencies](https://velocity.apache.org/engine/2.2/dependencies.html).
+#### Modules
+
++ `velocity-engine-core`, the core templating engine
++ `velocity-engine-scripting`, the JSR223 scripting engine
++ `spring-velocity-support`, Spring framework integration support classes of the engine
++ `velocity-engine-examples`, a zip file of simple examples for the engine
++ `velocity-custom-parser-example`, a `pom.xml` example demonstrating parser customization
#### Inclusion as a maven dependency
<dependency>
<groupId>org.apache.velocity</groupId>
<artifactId>velocity-engine-core</artifactId>
- <version>2.2</version>
+ <version>2.3</version>
</dependency>
+Replace `velocity-engine-core` with `velocity-engine-scripting` to include the scripting engine, or with `spring-velocity-support` to include the Spring integration support. Both will include `velocity-engine-core` as a dependency.
+
#### Binaries
<table class="smalltable">
@@ -64,16 +76,22 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
</thead>
<tbody>
<tr>
- <th>engine-core</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2.jar">velocity-engine-core-2.2.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.jar.sha256">SHA256</a>]</td>
+ <th>velocity-engine-core</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-core-2.3.jar">velocity-engine-core-2.3.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3.jar.sha256">SHA256</a>]</td>
+ </tr>
+ <tr>
+ <th>velocity-engine-scripting</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-scripting-2.3.jar">velocity-engine-scripting-2.3.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
- <th>engine-scripting</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2.jar">velocity-engine-scripting-2.2.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.jar.sha256">SHA256</a>]</td>
+ <th>spring-velocity-support</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-spring-velocity-support-2.3.jar">velocity-spring-velocity-support-2.3.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3.jar.sha256">SHA256</a>]</td>
</tr>
</tbody>
</table>
@@ -85,22 +103,28 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
</thead>
<tbody>
<tr>
- <th>engine-core</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2.pom">velocity-engine-core-2.2.pom</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.pom.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2.pom.sha256">SHA256</a>]</td>
+ <th>velocity-engine-core</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-core-2.3.pom">velocity-engine-core-2.3.pom</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3.pom.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3.pom.sha256">SHA256</a>]</td>
+ </tr>
+ <tr>
+ <th>velocity-engine-scripting</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-scripting-2.3.pom">velocity-engine-scripting-2.3.pom</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3.pom.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3.pom.sha256">SHA256</a>]</td>
</tr>
<tr>
- <th>engine-scripting</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2.pom">velocity-engine-scripting-2.2.pom</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.pom.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2.pom.sha256">SHA256</a>]</td>
+ <th>spring-velocity-support</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-spring-velocity-support-2.3.pom">velocity-spring-velocity-support-2.3.pom</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3.pom.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3.pom.sha256">SHA256</a>]</td>
</tr>
<tr>
<th>velocity-custom-parser-example</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom">velocity-engine-scripting-2.2.pom</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-custom-parser-example-2.2.pom.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-custom-parser-example-2.3.pom">velocity-engine-scripting-2.3.pom</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-custom-parser-example-2.3.pom.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-custom-parser-example-2.3.pom.sha256">SHA256</a>]</td>
</tr>
</tbody>
</table>
@@ -112,16 +136,22 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
</thead>
<tbody>
<tr>
- <th>engine-core</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar">velocity-engine-core-2.2-javadoc.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-javadoc.jar.sha256">SHA256</a>]</td>
+ <th>velocity-engine-core</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-core-2.3-javadoc.jar">velocity-engine-core-2.3-javadoc.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3-javadoc.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3-javadoc.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
- <th>engine-scripting</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar">velocity-engine-scripting-2.2-javadoc.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-javadoc.jar.sha256">SHA256</a>]</td>
+ <th>velocity-engine-scripting</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-scripting-2.3-javadoc.jar">velocity-engine-scripting-2.3-javadoc.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3-javadoc.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3-javadoc.jar.sha256">SHA256</a>]</td>
+ </tr>
+ <tr>
+ <th>spring-velocity-support</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-spring-velocity-support-2.3-javadoc.jar">velocity-spring-velocity-support-2.3-javadoc.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3-javadoc.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3-javadoc.jar.sha256">SHA256</a>]</td>
</tr>
</tbody>
</table>
@@ -133,16 +163,22 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
</thead>
<tbody>
<tr>
- <th>engine-core</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar">velocity-engine-core-2.2-sources.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-core-2.2-sources.jar.sha256">SHA256</a>]</td>
+ <th>velocity-engine-core</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-core-2.3-sources.jar">velocity-engine-core-2.3-sources.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3-sources.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-core-2.3-sources.jar.sha256">SHA256</a>]</td>
+ </tr>
+ <tr>
+ <th>velocity-engine-scripting</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-scripting-2.3-sources.jar">velocity-engine-scripting-2.3-sources.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3-sources.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-scripting-2.3-sources.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
- <th>engine-scripting</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar">velocity-engine-scripting-2.2-sources.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-scripting-2.2-sources.jar.sha256">SHA256</a>]</td>
+ <th>spring-velocity-support</th>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-spring-velocity-support-2.3-sources.jar">velocity-spring-velocity-support-2.3-sources.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3-sources.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-spring-velocity-support-2.3-sources.jar.sha256">SHA256</a>]</td>
</tr>
</tbody>
</table>
@@ -155,27 +191,35 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
<tbody>
<tr>
<th>velocity-engine-examples</th>
- <td><a href="[preferred]/velocity/engine/2.2/velocity-engine-examples-2.2.zip">velocity-engine-examples.zip</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-examples-2.2.zip.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/engine/2.2/velocity-engine-examples-2.2.zip.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/engine/2.3/velocity-engine-examples-2.3.zip">velocity-engine-examples.zip</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-examples-2.3.zip.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/engine/2.3/velocity-engine-examples-2.3.zip.sha256">SHA256</a>]</td>
</tr>
</tbody>
</table>
-### Tools
+### Velocity Tools 3.1
+
+#### Modules
+
++ `velocity-tools-generic`, the generic tools
++ `velocity-tools-view`, the view tools, meant to be used in a J2EE webapp
++ `velocity-tools-view-jsp`, the view tools JSP extension
#### Inclusion as a maven dependency
+Use one of:
+
<dependency>
<groupId>org.apache.velocity.tools</groupId>
<artifactId>velocity-tools-generic</artifactId>
- <version>3.0</version>
+ <version>3.1</version>
</dependency>
<dependency>
<groupId>org.apache.velocity.tools</groupId>
<artifactId>velocity-tools-view</artifactId>
- <version>3.0</version>
+ <version>3.1</version>
</dependency>
<dependency>
@@ -184,6 +228,8 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
<version>3.0</version>
</dependency>
+Each of those modules will include the previous one as a dependency. But note that `velocity-tools-view-jsp` is still in 3.0.
+
#### Binaries
<table class="smalltable">
@@ -192,18 +238,18 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
<tbody>
<tr>
<th>Generic Tools</th>
- <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-generic-3.0.jar">velocity-tools-generic-3.0.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0.jar.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-generic-3.1.jar">velocity-tools-generic-3.1.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
<th>View Tools</th>
- <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-3.0.jar">velocity-tools-view-3.0.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0.jar.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-view-3.1.jar">velocity-tools-view-3.1.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
- <th>JSP View Tools</th>
+ <th>JSP View Tools (3.0)</th>
<td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-jsp-3.0.jar">velocity-tools-view-jsp-3.0.jar</a></td>
<td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0.jar.asc">PGP</a>]</td>
<td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0.jar.sha256">SHA256</a>]</td>
@@ -219,18 +265,18 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
<tbody>
<tr>
<th>Generic Tools</th>
- <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-generic-3.0.pom">velocity-tools-generic-3.0.pom</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0.pom.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0.pom.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-generic-3.1.pom">velocity-tools-generic-3.1.pom</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1.pom.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1.pom.sha256">SHA256</a>]</td>
</tr>
<tr>
<th>View Tools</th>
- <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-3.0.pom">velocity-tools-view-3.0.pom</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0.pom.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0.pom.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-view-3.1.pom">velocity-tools-view-3.1.pom</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1.pom.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1.pom.sha256">SHA256</a>]</td>
</tr>
<tr>
- <th>JSP View Tools</th>
+ <th>JSP View Tools (3.0)</th>
<td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-jsp-3.0.pom">velocity-tools-view-jsp-3.0.pom</a></td>
<td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0.pom.asc">PGP</a>]</td>
<td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0.pom.sha256">SHA256</a>]</td>
@@ -246,18 +292,18 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
<tbody>
<tr>
<th>Generic Tools</th>
- <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-generic-3.0-javadoc.jar">velocity-tools-generic-3.0-javadoc.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0-javadoc.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0-javadoc.jar.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-generic-3.1-javadoc.jar">velocity-tools-generic-3.1-javadoc.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1-javadoc.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1-javadoc.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
<th>View Tools</th>
- <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-3.0-javadoc.jar">velocity-tools-view-3.0-javadoc.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0-javadoc.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0-javadoc.jar.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-view-3.1-javadoc.jar">velocity-tools-view-3.1-javadoc.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1-javadoc.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1-javadoc.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
- <th>JSP View Tools</th>
+ <th>JSP View Tools (3.0)</th>
<td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-jsp-3.0-javadoc.jar">velocity-tools-view-jsp-3.0-javadoc.jar</a></td>
<td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0-javadoc.jar.asc">PGP</a>]</td>
<td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0-javadoc.jar.sha256">SHA256</a>]</td>
@@ -273,18 +319,18 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
<tbody>
<tr>
<th>Generic Tools</th>
- <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-generic-3.0-sources.jar">velocity-tools-generic-3.0-sources.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0-sources.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-generic-3.0-sources.jar.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-generic-3.1-sources.jar">velocity-tools-generic-3.1-sources.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1-sources.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-generic-3.1-sources.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
<th>View Tools</th>
- <td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-3.0-sources.jar">velocity-tools-view-3.0-sources.jar</a></td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0-sources.jar.asc">PGP</a>]</td>
- <td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-3.0-sources.jar.sha256">SHA256</a>]</td>
+ <td><a href="[preferred]/velocity/tools/3.1/velocity-tools-view-3.1-sources.jar">velocity-tools-view-3.1-sources.jar</a></td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1-sources.jar.asc">PGP</a>]</td>
+ <td>[<a href="https://www.apache.org/dist/velocity/tools/3.1/velocity-tools-view-3.1-sources.jar.sha256">SHA256</a>]</td>
</tr>
<tr>
- <th>JSP View Tools</th>
+ <th>JSP View Tools (3.0)</th>
<td><a href="[preferred]/velocity/tools/3.0/velocity-tools-view-jsp-3.0-sources.jar">velocity-tools-view-jsp-3.0-sources.jar</a></td>
<td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0-sources.jar.asc">PGP</a>]</td>
<td>[<a href="https://www.apache.org/dist/velocity/tools/3.0/velocity-tools-view-jsp-3.0-sources.jar.sha256">SHA256</a>]</td>
@@ -292,7 +338,12 @@ Be sure to check the [release notes](https://www.apache.org/dist/velocity/engine
</tbody>
</table>
-Or checkout the svn repository from [the 3.0 subversion tag](https://svn.apache.org/repos/asf/velocity/tools/tags/3.0).
+Or clone the github mirror repository and checkout the 3.1 tag:
+
+ :::shell
+ git clone https://github.com/apache/velocity-tools
+ cd velocity-tools
+ git checkout tags/3.1
---
@@ -300,47 +351,43 @@ Or checkout the svn repository from [the 3.0 subversion tag](https://svn.apache.
These releases are not considered production-ready but they might contain new features or bug fixes that are not yet in the production release.
-## Engine
+### Engine
There are no current Alpha or Beta releases of the Engine project.
-## Tools
+### Tools
There are no current Alpha or Beta releases of the Tools project.
---
-## Snapshot Releases
-
-Snapshot releases published from times to times on [Apache's repository](https://repository.apache.org/content/repositories/snapshots/org/apache/velocity/).
-
## Archived Components Releases
### Anakia
Binaries and sources:
-+ [anakia-1.0.zip]([preferred]/velocity/anakia/1.0/anakia-1.0.zip) [[PGP](https://www.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip.asc)] [[SHA1](https://www.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip.sha1)]
-+ [anakia-1.0.tar.gz]([preferred]/velocity/anakia/1.0/anakia-1.0.tar.gz) [[PGP](https://www.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz.asc)] [[SHA1](https://www.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz.sha1)]
++ [anakia-1.0.zip](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip) [[PGP](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip.asc)] [[SHA1](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.zip.sha1)]
++ [anakia-1.0.tar.gz](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz) [[PGP](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz.asc)] [[SHA1](https://archive.apache.org/dist/velocity/anakia/1.0/anakia-1.0.tar.gz.sha1)]
### Texen
Binaries and sources:
-+ [texen-1.0.zip]([preferred]/velocity/texen/1.0/texen-1.0.zip) [[PGP](https://www.apache.org/dist/velocity/texen/1.0/texen-1.0.zip.asc)] [[SHA1](https://www.apache.org/dist/velocity/texen/1.0/texen-1.0.zip.sha1)]
-+ [texen-1.0.tar.gz]([preferred]/velocity/texen/1.0/texen-1.0.tar.gz) [[PGP](https://www.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz.asc)] [[SHA1](https://www.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz.sha1)]
++ [texen-1.0.zip](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.zip) [[PGP](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.zip.asc)] [[SHA1](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.zip.sha1)]
++ [texen-1.0.tar.gz](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz) [[PGP](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz.asc)] [[SHA1](https://archive.apache.org/dist/velocity/texen/1.0/texen-1.0.tar.gz.sha1)]
### DVSL
Binaries:
-+ [velocity-dvsl-1.0.zip]([preferred]/velocity/dvsl/1.0/velocity-dvsl-1.0.zip) [[PGP](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip.asc)] [[SHA1](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip.sha1)]
-+ [velocity-dvsl-1.0.tar.gz]([preferred]/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz) [[PGP](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz.asc)] [[SHA1](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz.sha1)]
++ [velocity-dvsl-1.0.zip](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip) [[PGP](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip.asc)] [[SHA1](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.zip.sha1)]
++ [velocity-dvsl-1.0.tar.gz](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz) [[PGP](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz.asc)] [[SHA1](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0.tar.gz.sha1)]
Sources:
-+ [velocity-dvsl-1.0-src.zip]([preferred]/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip) [[PGP](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip.asc)] [[SHA1](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip.sha1)]
-+ [velocity-dvsl-1.0-src.tar.gz]([preferred]/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz) [[PGP](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz.asc)] [[SHA1](https://www.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz.sha1)]
++ [velocity-dvsl-1.0-src.zip](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip) [[PGP](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip.asc)] [[SHA1](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.zip.sha1)]
++ [velocity-dvsl-1.0-src.tar.gz](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz) [[PGP](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz.asc)] [[SHA1](https://archive.apache.org/dist/velocity/dvsl/1.0/velocity-dvsl-1.0-src.tar.gz.sha1)]
## Older Releases
@@ -349,14 +396,13 @@ Older versions of the Apache Velocity projects are available from [our archive s
* [Engine old versions documentation](/engine/#older-releases)
* [Tools old versions documentation](/tools/#older-releases)
-
Unless otherwise stated, the most current release of the Apache Velocity projects is considered the *best* release and should be used for development and new projects. These older releases are mainly for maintenance purposes and archaeological interests.
<!-- nightly builds -->
## Source Code Repository
-You can download the source code to each Apache Velocity project directly from our apache gitbox repositories or from our github mirrors (which are preferable to open a pull request). Here you get logs, change histories and all the information necessary to follow the development process. If you are interested in the project development, please join the Apache Velocity development list.
+You can download the source code to each Apache Velocity project directly from our apache gitbox repositories or from our github mirrors (which are preferable if you intend to open a pull request). Here you get logs, change histories and all the information necessary to follow the development process. If you are interested in the project development, please join the Apache Velocity development list.
Project | Apache Gitbox Repository | Github Repository
--------|----------------|--------------------------