Markup Reference
Rich Text Markup
Rich Text Markup is applied
only to the content of Rich Text items.
Font Styling
|
{.f:fontname}text{/f:}
|
Change font
|
|
{.b}text{/b}
|
Bold face
|
|
{.i}text{/i}
|
Italic face
|
|
{.u}text{/u}
|
Underline
|
|
{.x}text{/x}
|
Strikethrough
|
|
{.ts:black}text{/x}
|
Text shadow. The value must be one of: black, white, none
|
Font Size
|
This is {.-3}smaller{/fs} text
|
Reduces font size by the specified number of points
|
|
This is {.+3}larger{/fs} text
|
Increases font size by the specified number of points
|
|
This is {.fs:15}15-point{/fs} text
|
Sets font size to the specified number of points
|
Restore Default Font Characteristics
|
{.f}
|
Restore the default font, font size, and face
(but does not affect text color)
|
Specifying Colors
Colors can be specified in your choice of several formats.
A
colorspec is a color specified
in any of these formats.
Note that a
colorspec must be embedded within a markup command
(such as
{.c:rgb[100,0,100]} )
in order to have effect .
|
red
|
Color name must be one of: black, blue, brown, cyan, darkGray, gray, green,
lightGray, magenta, orange, purple, red, white, yellow
|
|
#ff00ff
|
Hex (HTML) RGB color
|
|
cmyk[100,0,100,0]
|
CMYK colorspace (range 0 - 100)
|
|
xcmyk[255,0,255,0]
|
CMYK colorspace (range 0 - 255)
|
|
cmyk[100,0,100,0,50]
|
CMYK colorspace with added alpha for translucency
|
|
rgb[100,0,100]
|
RGB colorspace (range 0 - 100)
|
|
xrgb[255,0,255]
|
RGB colorspace (range 0 - 255)
|
|
rgb[100,0,100,50]
|
RGB colorspace with added alpha for translucency
|
|
gray[50]
|
Grayscale colorspace (range 0 - 100)
|
|
xgray[128]
|
Grayscale colorspace (range 0 - 255)
|
|
gray[50,50]
|
Grayscale colorspace with added alpha for translucency
|
Text Coloring
Text color markup affects the color of subsequent text,
until the end of the text or until the text color
is changed again.
You may use any of the colorspec formats
shown above;
several examples using different colorspecs are show here.
|
{.c:red}text{/b}
|
|
{.c:rgb[100,0,100]}
|
|
{.c:xcmyk[255,0,255,0,128]}
|
|
{.c:#ff00ff}
|
|
{.c}
|
Restores the default text color
|
Item Background Color
Unlike most markup,
the background color command
affects the entire item
rather than a range of the text.
It may appear anywhere within the text of the field
(although we recommend putting it at the start of the field,
for clarity).
It will override all other background color effects.
You may use any of the colorspec formats
shown above;
the sample shown here use the RGB and Hex (HTML) specifications.
|
{.bgc:rgb[90,90,100]}
|
|
{.bgc:#ff00ff}
|
Line Break
Text will wrap naturally to fit the bounds of its item,
but you can force a line break if you need to:
|
text{.n}text
|
Forced line break
|
References to Other Columns
The values of fields in other columns
on the same row of source
can be embedded in rich text.
|
text {..columnName} text
|
Embed value of column named columnName
|
Embedded Images
An embedded image is treated as if it were
a character in the text.
|
{imageFilename}
|
Embed the image in the text.
The imageFilename
must be the name of an image file
found in the designated Images folder.
|
Literal Text
The value of this field
will be treated as literal text.
If you put rich text markup in the text,
it will not be interpreted and that text
will be visible on the card.
Style Markup
Style markup is applied only to
the value of Rich Text items
and Image With Markup items.
Specifying Styles
Every style markup directive
must include a style specification.
|
{*stylename}
|
Specifies the style
whose name is stylename.
(Styles are defined and named
in the Styles tab.)
|
|
{**}
|
Specifies the default style,
which is set in the Styles popup menu
in the Item Info for the item.
|
|
{*..columnName}
|
Specifies the defined style
named in the columnName column.
|
Specifying Attributes
Every style markup directive
may optionally include an attribute specification.
If am attribute is specified,
then only that attribute of the style
is applied.
If no attribute is specified,
then all attributes of the style
are applied.
|
{*style}
|
Applies all attributes of the specified style.
|
|
{*style.attrname}
|
Applies the specified attribute of the specified style.
|
Attribute Names
This is the list of all attribute names.
| fontname |
|
| fontsize |
|
| bold |
|
| italic |
|
| underline |
|
| strikethrough |
|
| textcolor |
|
| textshadow |
|
| alignment |
|
| fontOutlineColor |
|
| fontOutlineWidth |
|
|
|
(Center Text Vertically) |
| sttf |
(Shrink Text to Fit) |
| bgcolor |
(Background Color) |
| corner |
(Corner Radius) |
| hidewhenempty |
|
| margin |
|
| margincolor |
|
| contentAttrName |
(The name of a content attribute defined by the style.) |
Content Attributes
Specify content attributes
by the name given them in the Style tab.
Note that using a content attribute
to specify an embedded image
in a rich text item
requires two nested pairs of curly braces:
the first to begin an imagename directive,
the second to begin the style markup directive.
Also note that the double curly braces
are
not required
in Image With Markup items,
because those items recognize only Style Markup
and not Rich Text markup.
| {*style.contentAttrName} |
(The name of a content attribute defined by the style.) |
| {{*style.contentAttrName}} |
Using the content of a style's content attribute
as the name of an embedded image in rich text. |
Copyright © 2023
by
Semicolon LLC.
All international rights reserved.
