..	*******************************************************************************
	* MetaFactory.io R2
	* Technical Documentation
	* 
	* File name   : CIS_VelocitySettings.rst
	* Created by  : Marnix Bochove (original text)
	* Last update : 23-03-2021
	* Updated by  : Niels de Nies
	*
	* MetaFactory BV Amsterdam 
	*******************************************************************************

.. include:: /inline-images.txt

Velocity settings
=================

In MetaFactory the template engine Velocity can be used (though Freemarker is recommended).
With this tool you can add links to the velocity files that are loaded by the Velocity Engine,
thus making all macros available to other velocity files in the pattern. 

|Eye S| Links to these velocity files are relative to the snippetFolders that are defined in the MetaFactory project. 


If a velocity library cannot be found during loading of a pattern, an error message is given immediately and the process stops (Fail Fast).

.. rubric:: Usage


In the example below 2 velocity libraries are defined:

.. code-block:: xml
	:caption: <velocity settings/> example
	:name: velocity settings-01
	:linenos:
	:emphasize-lines: 8,9,10,11

	<?xml version="1.0" encoding="UTF-8"?>
	<pattern xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
		 xmlns="http://www.firstbase.nl/xsd/personaliom/pattern"
		 xsi:schemaLocation="http://www.firstbase.nl/xsd/personaliom/pattern
				     http://www.firstbase.nl/xsd/personaliom/pattern.xsd">
	
		...
	<velocity>
		<velocityLibrary>relative path to a velocity file with macro's</velocityLibrary>
		<velocityLibrary>some other path</velocityLibrary>
	</velocity>
		...
	</pattern>