Question Text

Overview

When executing a data entry application, CSPro can display question text, which is generally used to show the question that an enumerator should say to a respondent, or helpful information for an enumerator that is not suitable to include as part of a field's label.

Question text and help text can be defined for both fields and blocks. This text is associated with an application via the question file (with the extension .qsf).

Dynamic question text is created by using CSPro's text templates system, where static text is combined with delimiters (~~, ~~~, and <? ?>) that allow for the dynamic creation of sections of the question text.

Question Text Formats

Question text can be defined using HTML or Markdown. This is a per-question format, so a single application can use both HTML and Markdown. The default format can be set for new questions.

When editing question text, the toolbar shows four icons:

Icon	Description	Details
	Edit HTML visually	You can edit the question text using Summernote, a WYSIWGY HTML editor. In this mode, template expressions can be specified using ~~ and ~~~ but not <? ?>.
	Edit HTML code	This option shows the HTML code generated by Summernote and allows you to modify the code directly.
	Edit as HTML text template	You can specify question text directly using HTML, parsed as a text template.
	Edit as Markdown text template	You can specify question text directly using Markdown, parsed as a text template. This Markdown will be converted to HTML for display.

All question text is processed as a text template, but the first two options do not allow the use of template expressions delimited with <? ?>. Using the first two options, which allow the visual editing of question text using the Summernote editor, is a good choice for most users, but if you intend to embed custom HTML tags, you may want to use the third option because Summernote can sometimes mangle complex HTML.

Previewing Question Text

When editing question text in the CSPro Designer, a preview can be viewed by pressing Ctrl + F5 or selecting Preview Text Template from the View menu. This will not run the CSPro logic, so the preview will not necessarily look complete, but it can be useful to view an approximation of how the rendered question text will appear.

The Designer also shows a preview of the question text when you are editing the data entry application's forms.

Question Text Functionality

More information about editing question text is available on the following pages:

Text Templates: This is the system used to create dynamic question text. Learn more about how to create template expressions using the delimiters: ~~, ~~~, and <? ?>.
Create Helps for Fields: Every field and block can have question text and/or help text. Help text is generally used for information that may be useful to an enumerator rather than the question text, which is generally the text that an enumerator reads out loud to a respondent.
Enter Question Text: Information about the question text editor.
Create Fills in Questions: Details about creating dynamic question text using the template expressions with the ~~ and ~~~ delimiters.
Create Conditional Questions: You can define multiple sets of question text for a given field or block and use logic conditions to determine which one is displayed.
Question Text Properties: Settings that determine how question text is edited within the CSPro Designer.
Question Text Styles: A way to specify the styles that are used when rendering question text.
Change Formatting: Options that facilitate formatting and editing question text.
Add Images: A feature that allows the insertion of images into question text.
Insert Link in Question Text: A feature that allows the insertion of hyperlinks into question text.
Define Languages: An application can contain question text in multiple languages.
Question Text Macros: Some features for automating the editing of question text.

See also: Text Templates