<<*Options/Optional*. . .>> text blocks are specially marked sections of text that allow the end user to choose whether all or portions of the text block will remain in the final document.
Two types of optional text blocks are used in Pathagoras. They are both created with, and denoted by, plain-text boundary markers “<<” and “>>” placed around the subject text.
Pathagoras provides a 'simpler' version of both of these blocks. They are simpler in terms of how they are composed, but they are not as robust as the tools discussed here. One is not better than the other. It just depends on personal preference and need. Simple Options/Optional text is discussed starting at this link.)
|1.||“Optional” text: This is pure ‘optional' (take it or delete it) text’ relative to the entire block of text. At document assembly time, Pathagoras On Cloud will highlight the text, pause and ask “Do you want to keep this text?”. The user need only respond “Yes” or “No” to tell Pathagoras On Cloud whether the text block should be retained in the final document.|
<<*Optional*The widgets you have ordered are not currently in stock. We will ship them as soon as possible.
|2.||“Options” text: This block ‘type’ allows the user to select among several choices. Each choice is separated from the others by a simple, plain text slash (“/”). At document assembly time, the choice are presented to the user on a selection screen. The user selects one or more of the displayed choices.|
<<*Options*Per your request, the widgets will be shipped by Federal Express. We will bill you for the extra cost of shipping./Per your request, we will send the widgets by standard ground transport. This may take 3 to 5 additional days./As per your request, we will hold the widgets for pickup by your courier./The widgets you have ordered are not currently in stock. We will ship them as soon as possible. If we have not shipped within 5 days of this date, you will have the option to cancel the order.>>
When Pathagoras encounters the options block (#2 above), it will parse out the individual choices and display them onto buttons on a selection screen. (If the text is too long to fit, only the first 200 or so characters of the particular option will display.) Checkboxes are shown at the left of each choice so that you can choose more than one option, if desired. If you want just a single choice, click on the 'bar' containing that choice.
Figure 2 Options block dialog.
Note that the actual option text is provided (subject to space constraints.)