Formatting Response Instructions

Licensing Requirements

This feature requires either an Enterprise-level license, or the Enterprise Response Module.

Using Markdown to format text

If you have a lot of instructions for a site or user that will appear on an activation, it may be more readable to format the text with headings, bold and italic text, bullet points, and colours. You can do this by using Markdown. With Markdown, you add markers at the start of lines, or around blocks of text to indicate how to format it.

As an example, if you want to have a section of text in bold, add two asterisks at the start and end:

This is normal text. **This is BOLD text.**

When an operator views the activation, the instructions will display as:

This is normal text. This is BOLD text.

New lines

A single new line character will not be displayed in the final output. For example (↩ = Enter key):

This is the first line.↩
This is the second line.

Will display as:

This is the first line. This is the second line.

So if you want to make any section of text appear on a new line, add 2 spaces at the end of the previous line. For example:

This is the first line.[space][space]
This is the second line.

Will display as:

This is the first line.
This is the second line.

If you want to make a new paragraph, press enter twice. For example:

This is the first paragraph.↩

This is the second paragraph.

Will display as:

This is the first paragraph.

This is the second paragraph.

Common formatting tags

Below is a list of the most common tags that you can use:

Type Or to Get
*Italic* _Italic_ Italic
**Bold** __Bold__ Bold
# Heading 1 Heading 1
=========

Heading 1

## Heading 2 Heading 2
---------

Heading 2

[Link](http://a.com) [Link][1]
?
[1]: http://b.org
Link
![Image](http://url/a.png) ![Image][1]
?
[1]: http://url/b.jpg
Markdown
> Blockquote  
Blockquote
* List
* List
* List
- List
- List
- List
  • List
  • List
  • List
1. One
2. Two
3. Three
1) One
2) Two
3) Three
  1. One
  2. Two
  3. Three
--- *** Horizontal Rule

There are a number of other options for formatting supported by Patriot, based on the CommonMark standard. For the full CommonMark specification, go to spec.commonmark.org/.

Any text boxes that support this formatting will have a checkbox option for enabling "Formatted Text". When this is enabled, a Preview tab is also shown, for viewing how it will look on an activation.

Text box that supports markdown
Editing view for Markdown-supported textboxes.

Use the Instructions tab for editing, and the Preview tab to check the final result.

Previewing how the formatted instructions will look
The Preview tab shows how the text formatting will look to an operator.

Whenever you need to, open the quick reference by clicking the help button to the right of the editing controls. This will pop up a list of the commonly used tags.

Font colours

It is possible to change the font colour, below is a list of the colours support by Patriot:

Black   Green   Red   Blue  
Gray   Lime   Maroon   Navy  
Silver   Yellow   Purple   Teal  
Olive   Fuchsia   Aqua   White  

To change the colour just type ":::" followed by the colour, the colour will be applied to the text below. To switch back to the normal colour, enter ":::" again and everything below this line will be displayed in normal(black) colour.

Previewing how to customize colour
Change text colour in Instructions textbox.
Previewing the end result
The instruction's text colour has changed to red.

Font colours for ICA

The colour values of the 16 colour tags are fixed when displayed in the desktop workstations, but can be altered when displayed in ICA. The default RGB value of the colour can be changed by modifying "~/Patriot Systems/Patriot Data Service/ICA/css/patriot_styles.css"

Note: Some knowledge of HTML and CSS will be required to change to look of your website. If you are going to make your own changes, please backup all files beforehand.

Example of CSS colours
Example of colours' definition in patriot_styles.css

Disabling text formatting

If you ever encounter instructions that are displayed with incorrect formatting, you can quickly toggle between formatted text and plain text by clicking the formatting toggle button above the response list on the activation screen.

Toggle button to disable markdown
Text formatting for response instructions can be switched on or off at any time.

When the option is turned off, ALL instructions will show as unformatted text. When it is turned on, text formatting will be applied only if it has been enabled for that particular instruction. This is a display option for the current operator, it will not affect any other operators using Patriot.

Text formatting defaults when upgrading from older versions

Text formatting was introduced in version 6.7 of Patriot. All instructions entered in earlier versions of Patriot will have formatting disabled by default.

You can also manually set all instructions to unformatted across the whole system, using an option in the Patriot Utilities program. Use this with caution, as the change cannot be reversed.

Related Documents