Configuration property |
Type |
Default |
Comma-separated list of absolute resource paths to scan recursively for templates. All tree folder from 'resource-paths' will be added as a resource. Unprefixed locations or locations starting with classpath will be processed in the same way.
Defaults relevant for this option are documented on quarkus.freemarker.base-path
Environment variable: QUARKUS_FREEMARKER_RESOURCE_PATHS
|
list of string |
|
The base path of this template set. Template set is a triple of base-path , includes and excludes serving to select a number of templates for inclusion in the native image. includes and excludes are relative to base-path .
Use slash (/ ) as a path separator on all platforms. The value must not start with a slash.
Do not set any base-path value if you want includes and excludes to be relative to root resource path. Defaults Option Default value in case none of
quarkus.freemarker.[base-path|includes|excludes|resource-paths]
is set Default value otherwise quarkus.freemarker.base-path freemarker/templates not set (interpreted as root resource path folder) quarkus.freemarker.includes ** not set (no files included) quarkus.freemarker.excludes not set (no files excluded) not set (no files excluded)
The defaults described in the second column of the table are to achieve the backwards compatibility with the behavior of quarkus.freemarker.resource-paths before Quarkus Freemarker 0.2.0.
Allowed combinations
Setting base-path and/or excludes but not setting includes will result in a build time error. We have chosen this behavior (rather than using ** as a default for includes) to avoid including all resources inadvertently and thus bloating your native image.
Environment variable: QUARKUS_FREEMARKER_BASE_PATH
|
string |
|
A comma separated list of globs to select FreeMarker templates for inclusion in the native image.
includes are relative to base-path . Use slash (/ ) as a path separator on all platforms. The glob syntax is documented on quarkus.native.resources.includes .
Example: quarkus.freemarker.includes = **.ftl
Environment variable: QUARKUS_FREEMARKER_INCLUDES
|
list of string |
|
A comma separated list of globs not to include in the native image.
excludes are relative to base-path . Use slash (/ ) as a path separator on all platforms. The glob syntax is documented on quarkus.native.resources.includes .
Example: quarkus.freemarker.excludes = **/unwanted*
Environment variable: QUARKUS_FREEMARKER_EXCLUDES
|
list of string |
|
Comma-separated of file system paths where freemarker templates are located
Environment variable: QUARKUS_FREEMARKER_FILE_PATHS
|
list of string |
|
Set the preferred charset template files are stored in.
Environment variable: QUARKUS_FREEMARKER_DEFAULT_ENCODING
|
string |
|
Sets how errors will appear. rethrow, debug, html-debug, ignore.
Environment variable: QUARKUS_FREEMARKER_TEMPLATE_EXCEPTION_HANDLER
|
string |
|
If false, don’t log exceptions inside FreeMarker that it will be thrown at you anyway.
Environment variable: QUARKUS_FREEMARKER_LOG_TEMPLATE_EXCEPTIONS
|
boolean |
|
Wrap unchecked exceptions thrown during template processing into TemplateException-s.
Environment variable: QUARKUS_FREEMARKER_WRAP_UNCHECKED_EXCEPTIONS
|
boolean |
|
If false, do not fall back to higher scopes when reading a null loop variable.
Environment variable: QUARKUS_FREEMARKER_FALLBACK_ON_NULL_LOOP_VARIABLE
|
boolean |
|
The string value for the boolean true and false values, usually intended for human consumption (not for a computer language), separated with comma.
Environment variable: QUARKUS_FREEMARKER_BOOLEAN_FORMAT
|
string |
|
Sets the default number format used to convert numbers to strings.
Environment variable: QUARKUS_FREEMARKER_NUMBER_FORMAT
|
string |
|
If true, the object wrapper will be configured to expose fields.
Environment variable: QUARKUS_FREEMARKER_OBJECT_WRAPPER_EXPOSE_FIELDS
|
boolean |
|
List of directives to register with format name=classname
Environment variable: QUARKUS_FREEMARKER_DIRECTIVES
|
Map<String,String>
|
|
Additional named template sets |
Type |
Default |
The base path of this template set. Template set is a triple of base-path , includes and excludes serving to select a number of templates for inclusion in the native image. includes and excludes are relative to base-path .
Use slash (/ ) as a path separator on all platforms. The value must not start with a slash.
Do not set any base-path value if you want includes and excludes to be relative to root resource path. Defaults Option Default value in case none of
quarkus.freemarker.[base-path|includes|excludes|resource-paths]
is set Default value otherwise quarkus.freemarker.base-path freemarker/templates not set (interpreted as root resource path folder) quarkus.freemarker.includes ** not set (no files included) quarkus.freemarker.excludes not set (no files excluded) not set (no files excluded)
The defaults described in the second column of the table are to achieve the backwards compatibility with the behavior of quarkus.freemarker.resource-paths before Quarkus Freemarker 0.2.0.
Allowed combinations
Setting base-path and/or excludes but not setting includes will result in a build time error. We have chosen this behavior (rather than using ** as a default for includes) to avoid including all resources inadvertently and thus bloating your native image.
Environment variable: QUARKUS_FREEMARKER__TEMPLATE_SET_NAME__BASE_PATH
|
string |
|
A comma separated list of globs to select FreeMarker templates for inclusion in the native image.
includes are relative to base-path . Use slash (/ ) as a path separator on all platforms. The glob syntax is documented on quarkus.native.resources.includes .
Example: quarkus.freemarker.includes = **.ftl
Environment variable: QUARKUS_FREEMARKER__TEMPLATE_SET_NAME__INCLUDES
|
list of string |
|
A comma separated list of globs not to include in the native image.
excludes are relative to base-path . Use slash (/ ) as a path separator on all platforms. The glob syntax is documented on quarkus.native.resources.includes .
Example: quarkus.freemarker.excludes = **/unwanted*
Environment variable: QUARKUS_FREEMARKER__TEMPLATE_SET_NAME__EXCLUDES
|
list of string |
|