Configuration property fixed at build time - All other configuration properties are overridable at runtime

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