Renderer Referenz

Doxey stellt eine Reihe von Renderern zur Verfügung, die Ihnen helfen Ihre Daten auf entsprechende Weise zu formatieren.

In den folgenden Abschnitten werden alle verfügbaren Formatierungsoptionen angezeigt.

String

If the variable contains text, you can apply different formatting options:

Break into multiple lines

If no delimiter is specified the text will be wrapped whenever a newline character occurs. Using the character sequence space as delimiter will replace newlines with spaces.

wrap

Characters

UPPERCASE

Prints the contents of a variable in uppercase letters

uppercase

true

false

lowercase

Prints the contents of a variable in lowercase letters

lowercase

true

false

Titlecase

Prints the first letter in uppercase (e.g. first will become First)

titlecase

true

false

CamelCase

Prints the contents of a variable in camelcase (e.g. FIRST_LAST will become FirstLast)

camelcase

true

false

Maximum length

Cuts off the contents of a variable after the specified number of characters

max

Number (0-99999)

Ellipsis

Prints the specified character sequence if the text has been cut off.
Only makes sense in conjunction with the max option

ellipsis

Characters

Prepend characters

Prepends the given characters, but only if the variable is set

pre

Characters

Append characters

Appends the given characters, but only if the variable is set

post

Characters

Insert linebreak

Adds a newline before or after the text, but only if the variable is set

break

after
before

Encode

Encode the value if you want to use it in an URL or an other context that requires encoding

encode

url
csv
html
xml
javascript
json

Decode

If you are dealing with an encoded value you can decode it by picking the correct encoding

decode

url
csv
html
xml
javascript
json

From

Use this option if you want to print a substring starting from the given character index.

from

Number (0-999)

From first

Creates a substring starting from the first appearance of the given character(s)

fromFirst

Characters

From after first

Creates a substring starting after the first appearance of the given character(s)

fromAfterFirst

Characters

From last

Creates a substring starting from the last appearance of the given character(s)

fromLast

Characters

From after last

Creates a substring starting after the last appearance of the given character(s)

fromAfterLast

Characters

To

Use this option if you want to print a substring up to the given character index.

to

Number (0-999)

To first

Creates a substring ending before the first appearance of the given character(s)

toFirst

Characters

To after first

Creates a substring ending after the first appearance of the given character(s)

toAfterFirst

Characters

To last

Creates a substring ending before the last appearance of the given character(s)

toLast

Characters

To after last

Creates a substring ending after the last appearance of the given character(s)

toAfterLast

Characters

Equals

Returns true if given string is equal to the parameter value, otherwise false

equals

Characters

Starts with

Returns true if given string starts with the parameter value, otherwise false

startsWith

Characters

Ends with

Returns true if given string ends with the parameter value, otherwise false

endsWith

Characters

Contains

Returns true if given string contains the parameter value, otherwise false

contains

Characters

Replace

Replaces the given character sequence with the value from the with parameter

replace

Characters

With

Replaces the character sequence from the replace parameter with this value

with

Characters

Beispiele

Beispiele für den string-Renderer, um die Variable fullName mit dem Wert Daniel zu formatieren.

Beispiel

Ausgabe

${fullName;string(uppercase)}

DANIEL

${fullName;string(lowercase)}

daniel

Beispiele für den string-Renderer, um die Variable description mit dem Wert Note: This is a description that may contain a very long text zu formatieren.

Beispiel

Ausgabe

${description;string(max=20)}

Note: This is a descriptio

${description;string(max=20;ellipsis)}

Note: This is a descriptio...

${description;string(from=1;to=8)}

ote: Thi

${description;string(fromFirstAfter= ;toFirstBefore= descr)}

This is a

Boolean

If the variable contains a boolean value (true or false), you can render it using symbols like checkboxes

Symbol

Select the symbol to be used to display if the given value is true or false

symbol

mark
checkbox
yes/no
face
male
female
heart
flag
circle
star

True text

Specify the text to be printed if the give value is true

true

Characters

False text

Specify the text to be printed if the give value is false

false

Characters

Beispiele

Beispiele für den boolean-Renderer, um die Variable tosAccepted mit dem Wert true zu formatieren.

Beispiel

Ausgabe

${tosAccepted;boolean(symbol=yes/no)}

Yes

${tosAccepted;boolean(true=Accepted;false=Declined)}

Accepted

${tosAccepted;boolean(symbol=mark)}

Beispiele für den boolean-Renderer, um die Variable male mit dem Wert false zu formatieren.

Beispiel

Ausgabe

${male;boolean(true=Mr.;false=Mrs.)}

Mrs.

${tosAccepted;boolean(symbol=male)}

Number

If the variable contains a number, you can parse and format it using locale specific patterns:

Output pattern

Specifies the output number format. Use integer, percent or a custom pattern

op

Characters

Output locale

Specifies the output language and region

ol_oc

Specify language as two lowercase letters, e.g. de or en

Input pattern

Specifies the input number format. Use integer, percent or a custom pattern

ip

Characters

Input locale

Specifies the input language and region

il_ic

Specify language as two lowercase letters, e.g. de or en

Add

Add parameter value to the given number

add

Number

Subtract

Subtract parameter value from the given number

sub

Number

Multiply

Multiply given number by the parameter value

mul

Number

Divide

Divide given number by the parameter value

div

Number

Equals

Returns true if given number is equal to the parameter value, otherwise false

equals

Number

Greater than

Returns true if given number is greater than the parameter value, otherwise false

gt

Number

Greater than or equals

Returns true if given number is greater than or equals the parameter value, otherwise false

gte

Number

Less than

Returns true if given number is less than the parameter value, otherwise false

lt

Number

Less than or equal

Returns true if given number is less than or equals the parameter value, otherwise false

lte

Number

Beispiele

Beispiele für den number-Renderer, um die Variable result mit dem Wert 1234567890.12345 zu formatieren.

Beispiel

Ausgabe

${result;number(ol=en)}}

1,234,567,890.123

${result;number(ol=fr)}

1 234 567 890,123

${result;number(op=#.00;ol=de)}

1234567890,12

Beispiele für den number-Renderer, um die Variable value mit dem Wert 10 zu formatieren.

Beispiel

Ausgabe

${value;number(sub=7)}

3

${value;number(mul=10;add=5)}

105

${value;number(gt=5)}

true

${value;number(mul=5;lt=40)}

false

Currency

If the variable contains a number, you can parse and format it as a currency:

Output pattern

Specifies the output currency code. Use USD, EUR or any other valid currency code

op

Characters

Output locale

Specifies the output language and region

ol_oc

Specify language as two lowercase letters, e.g. de or en

Input pattern

Specifies the pattern to convert a given string into a number. The pattern is locale sensitive and will parse the given string using the input language and country if they are available

ip

Characters

Input locale

Specifies the input language and region

il_ic

Specify language as two lowercase letters, e.g. de or en

Add

Add parameter value to the given number

add

Number

Subtract

Subtract parameter value from the given number

sub

Number

Multiply

Multiply given number by the parameter value

mul

Number

Divide

Divide given number by the parameter value

div

Number

Equals

Returns true if given number is equal to the parameter value, otherwise false

equals

Number

Greater than

Returns true if given number is greater than the parameter value, otherwise false

gt

Number

Greater than or equals

Returns true if given number is greater than or equals the parameter value, otherwise false

gte

Number

Less than

Returns true if given number is less than the parameter value, otherwise false

lt

Number

Less than or equal

Returns true if given number is less than or equals the parameter value, otherwise false

lte

Number

Beispiele

Beispiele für den currency-Renderer, um die Variable amount mit dem Wert 1234567890.12345 zu formatieren.

Beispiel

Ausgabe

${amount;currency(ol=de;oc=DE;op=EUR)}

1.234.567.890,12 €

${amount;currency(ol=de;oc=CH;op=EUR)}

EUR 1'234'567'890.12

${amount;currency(ol=en;oc=US;op=USD)}

1.234.567.890,12 USD

Date

If the variable contains a date, you can parse and format it using locale specific patterns:

Output pattern

Specifies the output date format. Use short, medium, long, full or a custom pattern

op

Characters

Output locale

Specifies the output language and region

ol_oc

Specify language as two lowercase letters, e.g. de or en

Output timezone

Specifies the output timezone

otz

Specifies the output timezone, either an abbreviation such as PST, a full name such as America/Los_Angeles, or a custom ID such as GMT-8:00

Input pattern

Specifies the input date format. Use short, medium, long, full or a custom pattern

ip

Characters

Input locale

Specifies the input language and region

il_ic

Specify language as two lowercase letters, e.g. de or en

Input timezone

Specifies the input timezone

itz

Specifies the output timezone, either an abbreviation such as PST, a full name such as America/Los_Angeles, or a custom ID such as GMT-8:00

Add days

Specify the number of days to be added to or substracted from the given date

addDay

Number (1-365)

Add weeks

Specify the number of weeks to be added to or substracted from the given date

addWeek

Number (1-56)

Add months

Specify the number of months to be added to or substracted from the given date

addMonth

Number (1-12)

Add years

Specify the number of years to be added to or substracted from the given date

addYear

Number (1-999)

Set day

Sets the day to the given day in month

day

Number (1-31)

Set month

Sets the month of the date

month

Number (1-12)

Set year

Sets the year of the date

year

Number (-9999-9999)

Equals

Returns true if given date is equal to the parameter value, otherwise false

equals

Date

Before

Returns true if given date is before to the parameter value, otherwise false

before

Date

After

Returns true if given date is after to the parameter value, otherwise false

after

Date

Beispiele

Beispiele für den date-Renderer, um die Variable appointment mit dem Wert 2016/04/16 zu formatieren.

Beispiel

Ausgabe

${appointment;date(op=short)}

4/16/16

${appointment;date(op=long;ol=fr)}

16 avril 2016

${appointment;date(op=long;ol=en)}

April 16, 2016

${appointment;date(op=MMMM;ol=it)}

aprile

${appointment;date(op=yyyy/MM/dd)}

2016/04/16

Time

If the variable contains a timestamp, you can parse and format it as a time using locale specific patterns:

Output pattern

Specifies the output date format. Use short, medium, long, full or a custom pattern

op

Characters

Output locale

Specifies the output language and region

ol_oc

Specify language as two lowercase letters, e.g. de or en

Output timezone

Specifies the output timezone

otz

Specifies the output timezone, either an abbreviation such as PST, a full name such as America/Los_Angeles, or a custom ID such as GMT-8:00

Input pattern

Specifies the input date format. Use short, medium, long, full or a custom pattern

ip

Characters

Input locale

Specifies the input language and region

il_ic

Specify language as two lowercase letters, e.g. de or en

Input timezone

Specifies the input timezone

itz

Specifies the output timezone, either an abbreviation such as PST, a full name such as America/Los_Angeles, or a custom ID such as GMT-8:00

Add minutes

Specify the number of minutes to be added to or substracted from the given time

addMinute

Number (1-9999)

Add hours

Specify the number of hours to be added to or substracted from the given time

addHour

Number (1-9999)

Equals

Returns true if given time is equal to the parameter value, otherwise false

equals

Characters

Before

Returns true if given time is before to the parameter value, otherwise false

before

Characters

After

Returns true if given time is after to the parameter value, otherwise false

after

Characters

Beispiele

Beispiele für den time-Renderer, um die Variable now mit dem Wert 2:23:12 PM zu formatieren.

Beispiel

Ausgabe

${now;time(op=short)}

2:23 PM

${now;time(op=medium)}

2:23:12 PM

${now;time(op=full;ol=fr)}

14 h 23 UTC

${now;time(op=hh:mm:ss)}

02:23:12

Date and time

If the variable contains a timestamp, you can parse and format it as date and time using locale specific patterns:

Output pattern

Specifies the output date format. Use short, medium, long, full or a custom pattern

op

Characters

Output locale

Specifies the output language and region

ol_oc

Specify language as two lowercase letters, e.g. de or en

Output timezone

Specifies the output timezone

otz

Specifies the output timezone, either an abbreviation such as PST, a full name such as America/Los_Angeles, or a custom ID such as GMT-8:00

Input pattern

Specifies the input date format. Use short, medium, long, full or a custom pattern

ip

Characters

Input locale

Specifies the input language and region

il_ic

Specify language as two lowercase letters, e.g. de or en

Input timezone

Specifies the input timezone

itz

Specifies the output timezone, either an abbreviation such as PST, a full name such as America/Los_Angeles, or a custom ID such as GMT-8:00

Add minutes

Specify the number of minutes to be added to or substracted from the given time

addMinute

Number (1-9999)

Add hours

Specify the number of hours to be added to or substracted from the given time

addHour

Number (1-9999)

Add days

Specify the number of days to be added to or substracted from the given date

addDay

Number (1-365)

Add weeks

Specify the number of weeks to be added to or substracted from the given date

addWeek

Number (1-56)

Add months

Specify the number of months to be added to or substracted from the given date

addMonth

Number (1-12)

Add years

Specify the number of years to be added to or substracted from the given date

addYear

Number (1-999)

Equals

Returns true if given date and time is equal to the parameter value, otherwise false

equals

Characters

Before

Returns true if given date and time is before to the parameter value, otherwise false

before

Characters

After

Returns true if given date and time is after to the parameter value, otherwise false

after

Characters

Beispiele

Beispiele für den datetime-Renderer, um die Variable now mit dem Wert 4/16/13 2:26:48 PM zu formatieren.

Beispiel

Ausgabe

${now;datetime(op=short)}

4/16/13 2:26 PM

${now;datetime(op=medium)}

2:23:12 PM

${now;datetime(op=long)}

April 16, 2014 2:26:48 PM UTC

${now;datetime(op=full;ol=en)}

Tuesday, April 16, 2014 2:26:48 PM UTC

${now;datetime(op=yyyy, MMM dd. hh:mm:ss)}

2014, Apr 16. 02:28:13

Locale

If the variable contains a locale, country or language, you can parse and format it using locale specific patterns:

Output pattern

Specifies which parts of the locale to be rendered and in which format

op

locale
country
countryCode
language
languageCode

Output locale

Specifies the output language and region

ol_oc

Specify language as two lowercase letters, e.g. de or en

Input pattern

Specifies how to parse the given variable content

ip

locale
country
countryCode
language
languageCode

Input locale

Specifies the input language and region

il_ic

Specify language as two lowercase letters, e.g. de or en

Beispiele

Beispiele für den locale-Renderer, um die Variable lang mit dem Wert en-US zu formatieren.

Beispiel

Ausgabe

${lang;locale}

English (United States)

${lang;locale(op=language)}

English

${lang;locale(op=country)}

United States

${lang;locale(ol=fr)}

anglais (Etats-Unis)

${lang;locale(op=language;ol=fr)}

anglais

${lang;locale(op=country;ol=de;oc=DE)}

Vereinigte Staaten von Amerika

${lang;locale(op=country;ol=fr;oc=FR)}

Etats-Unis

Beispiele für den locale-Renderer, um die Variable country mit dem Wert France zu formatieren.

Beispiel

Ausgabe

${country;locale(ip=country;il=en;op=country;ol=de}

Frankreich

${country;locale(ip=country;il=en;op=countryCode}

FR

If the variable contains a URL, you can render it as a clickable link:

Displayed text

Specifies the text that will be displayed in the generated document instead of the URL. If not set, the URL will be displayed as text

text

Characters

Target frame

When rendering HTML output you can specify the target frame of the link. Use _blank, _self or target frame name

target

Characters

Link color

Specify the link color when rendering HTML output

color

Text decoration

Specify the text decoration when rendering HTML output

text-decoration

none
underline

Email

If the variable contains an email address, you can render it as a clickable link:

Displayed text

Specifies the text that will be displayed in the generated document. If not set, the email will be displayed as text

text

Characters

Subject

Enter the subject if you want to prepopulate the subject field

subject

Characters

Body

Enter the body if you want to prepopulate the body field

body

Characters

Link color

Specify the link color when rendering HTML output

color

Text decoration

Specify the text decoration when rendering HTML output

text-decoration

none
underline

Image

If the variable contains a URL pointing to an image, you can render it as an image

Width

Specifies the width of the image in cm, pt etc.

width

Characters

Height

Specifies the height of the image in cm, pt etc.

height

Characters

Aspect ratio

Use this option to maintain the aspect ratio of the original image

aspect-ratio

ignore
maintain

Resize

Resizes the image to reduce the resulting document size

resize

Characters

Border radius

When generating HTML output, this option allows you to generate rounded borders

border-radius

Characters

Color mode

When generating PDF document this option converts the image to a greyscale, monochromatic or watermark image

color-mode

standard
greyscale
mono
watermark

Mirror image

When generating PDF document this option mirrors the image vertically, horizontally along both axis

mirror

none
horizontal
vertical
horizontal vertical

Luminance

When generating PDF document this option adjusts the luminance of image

luminance

Percent (0-100)

Contrast

When generating PDF document this option adjusts the contrast of image

contrast

Percent (0-100)

Image opacity

0% = image is totally transparent, 100% image is opaque

image-opacity

Percent (0-100)

Gamma correction

When generating PDF document this option applies gamma correction to the image

gamma

Percent (0-100)

Red channel

When generating PDF document this option adjusts the red channel

red

Percent (0-100)

Blue channel

When generating PDF document this option adjusts the blue channel

blue

Percent (0-100)

Green channel

When generating PDF document this option adjusts the green channel

green

Percent (0-100)

Map

If the variable contains a postal address, you can render it as a map

Map type

Select the type of map that will be rendered

maptype

roadmap
satellite
hybrid
terrain

Zoom level

Specified the zoom level. 0 will show the whole planet, 21 is the highest zoom level

zoom

Resolution

Specifies the resolution of the generated image in px

res

Characters

Marker

Add a marker to the map with additional options (color: |label: |size: )

markers

Characters

Width

Specifies the width of the image in cm, pt etc.

width

Characters

Height

Specifies the height of the image in cm, pt etc.

height

Characters

Aspect ratio

Use this option to maintain the aspect ratio of the original map

aspect-ratio

ignore
maintain

Resize

Resizes the image to reduce the resulting document size

resize

Characters

Border radius

When generating HTML output, this option allows you to generate rounded borders

border-radius

Characters

Color mode

When generating PDF document this option converts the image to a greyscale, monochromatic or watermark image

color-mode

standard
greyscale
mono
watermark

Mirror image

When generating PDF document this option mirrors the image vertically, horizontally along both axis

mirror

none
horizontal
vertical
horizontal vertical

Luminance

When generating PDF document this option adjusts the luminance of image

luminance

Percent (0-100)

Contrast

When generating PDF document this option adjusts the contrast of image

contrast

Percent (0-100)

Image opacity

0% = image is totally transparent, 100% image is opaque

image-opacity

Percent (0-100)

Gamma correction

When generating PDF document this option applies gamma correction to the image

gamma

Percent (0-100)

Red channel

When generating PDF document this option adjusts the red channel

red

Percent (0-100)

Blue channel

When generating PDF document this option adjusts the blue channel

blue

Percent (0-100)

Green channel

When generating PDF document this option adjusts the green channel

green

Percent (0-100)

Form

If the variable contains a form definition, you can render it as a form

Action URL

Enter a fixed URL or a variable prefixed with a dollar sign (without curly braces)

action

Characters

Legend

Enter an optional header for your form

legend

Characters

Method

Select the desired method to send your form data

method

POST
GET

Buttons

Add text for submit buttons, separated by comma. First button will be blue, UPPERCASE buttons will be red, others default. The selected button will be available in the button variable

buttons

Characters

Layout

Horizontal will put the labels on the left of the input fields, vertcial will put them on top

layout

horizontal
vertical

Font family

Specify the desired font to be used when rendering the form

font-family

Characters

Object

If the variable contains an object, you can render it as JSON or XML

Input Format

Select if your object comes in XML, JSON format or as an Object

if

object
json
xml

Output Format

Specify if you want to render your objeect in XML or JSON format.

of

json
xml

Binary

If the variable contains binary content like generated documents etc. you can render it as a string, base64 or as a hashcode

Input Format

Specify if your binary content comes as bytes, string or base64 encoded

if

bytes
string
base64

Input Character Set

If your content comes as a string you can specify the character set

ic

Characters

Output Format

Specify if you want to render your binary content as String, Base64 or as a Hashcode

of

string
base64
hash

Output Character Set

Specify the character set if you want to render your binary content as a string

oc

Characters

Social

If you are rendering HTML output and the variable contains an URL you can render share buttons for social networks

Platform

Select the social network to share the URL

platform

google+
facebook
twitter
linkedin

URL

By default the URL will be takes from the variable to be rendered. If you want to share a different URL, you can pass it as url parameter.

url

Characters

Title

You can specify the title of the post

title

Characters

Target

Specify the target frame for your link

target

Characters

Hashtag

If you create a share button for Twitter you can specify the hashtag

hashtag

Characters

Width

The width of the generated image

width

Characters

Padding

The padding of the generated image

padding

Characters

HTML

If the variable contains HTML code, you modify or extract values from it

Fragment

Add this option if your variable only contains an HTML snippet

fragment

true

false

Inline Styles

Add this option if you want to inline the styles

inlineStyles

true

false

Remove Styles

Add this option if you want to remove the styles defined in your HTML page

removeStyle

true

false

Select

Select elements by entering a CSS like selector syntax. Separate by comma if you want to select multiple elements

select

Characters

Retrieve

Sepcify the format for the retrieved result. Separate by comma if you are selecting multiple elements

retrieve

text
outerHtml
html
id
tagName

Remove attributes

Specify the attributes to be removed from the selected elements

removeAttr

Characters

Remove tags

Specify the tags to be removed from the selected elements

removeTag

Characters

Convert

If your HTML comes from a Google Doc you can convert it into a different format

convert

bootstrap3

Color

If the variable contains color value, you can manipulate the color in many ways

Saturation

Set the saturations of the color

saturation

Percent (0-100)

Adjust saturation

Increase or decrease the saturations of the color

addSaturation

Number (-100-100)

Lightness

Sets the lightness of the color

lightness

Percent (0-100)

Adjust lightness

Increase or decrease the lightness of the color

addLightness

Number (-100-100)

Hue

Sets the hue of the color

hue

Number (0-360)

Adjust hue

Increase or decrease the hue of the color

addHue

Number (0-360)

Palette

Derive a color from the given color (e.g. the complementary color)

palette

complement
light
lighter
darker
dark
text

Output Format

Specify if you want to render the color in RGB or RGBA format.

of

rgb
rgba

Beispiele

Beispiele für den color-Renderer, um die Variable brandColor mit dem Wert #dc0021 zu formatieren.

Beispiel

Ausgabe

${brandColor;color(palette=dark)}

#6E0010

${brandColor;color(palette=text)}

#FFFFFF

Erfahren Sie mehr

Weitere Informationen über die Templating-Sprache finden Sie in folgenden Anleitungen.

Questions and Feedback

If you have any comments on this page, feel free to add suggestions right to the Google document that we are using to create this site.

If you are not yet member of the Doxey community, please join now to get updates from our end or to provide feedback, bug reports and discuss with other users.

Last Updated: 03.01.20