|
Using Document Blocks
|
|
With the Document Block feature, you can create Maple worksheets or documents that present text and math in formats similar to those found in business and education documents. If your main purpose is to create a document, you can use Document Mode, which is a Maple worksheet comprised of document blocks.
|
|
|
With document blocks, note the following:
|
|
•
|
Input prompts and execution groups are not displayed.
|
|
•
|
(Optional) Before using document blocks, set your worksheet to display Markers. Icons representing document blocks are displayed in a vertical bar left of the associated text.
|
|
•
|
On the View tab, ensure Markers (
) is selected.
|
|
|
You can also create document blocks within Worksheet mode.
|
|
Inline Text, Math, and Computations
|
|
A document block is designed to let you create content that includes text and mathematics in one line.
|
•
|
Toggle Math/Text entry mode by using F5. For more about switching between text and math, see Select Entry Mode.
|
|
•
|
Evaluate a math expression and display the result inline by using Alt + Enter (Alt + Return, for Mac). For other ways to execute math in document blocks, see Executing 2-D Math in Document Blocks below.
|
|
|
|
Executing 2-D Math in Document Blocks
|
|
|
|
In document blocks, to execute 2-D math input, use any of the following methods:
|
|
•
|
Press Alt + Enter (Alt + Return, for Mac). This evaluates and displays results inline.
|
|
•
|
On the Evaluation tab, click Evaluate and Display Inline (
). (This can also be invoked through the Context Panel.)
|
|
•
|
On the Evaluation tab, click Evaluate (
).
|
|
•
|
Press Enter (Return, for Mac). This evaluates and displays results on the next line or, if set in the Options dialog, simply evaluates.
|
|
|
The dual behavior of the Enter key (Evaluate menu item) is set in the Display tab of the Options dialog. See Options>Display.
|
|
|
Note: When a document block is evaluated using Evaluate, all executable 2-D math in the document block is evaluated. You can convert to nonexecutable math any 2-D math that you do not want evaluated. For more information, see Executable and Nonexecutable Math.
|
|
|
|
Step-by-Step Evaluation
|
|
|
|
When you press Enter to evaluate an input, the cursor moves to the next math input. Thus, you can easily step through your document, evaluating each math input.
|
|
|
|
Insert New Document Block
|
|
|
|
When you want to insert white space in your document, insert new document blocks.
|
|
|
To insert a document block below the cursor location:
|
|
•
|
On the Insert tab, click Document Block (
).
|
|
|
To insert a document block above the cursor location:
|
|
1.
|
Move the cursor to the left (Home) position in a document block. The cursor is now bold, as illustrated here:
|
|
2.
|
Press Enter. The in-focus prompt moves down and a new document block is created.
|
|
|
You can control this feature in the Interface tab of the Options dialog. See Options>Interface.
|
|
|
|
Copy Command
|
|
After performing an operation from the context panel, you can copy the underlying command.
|
1.
|
Place the cursor on the arrow for the context-sensitive operation.
|
|
2.
|
Right-click (Control-click, Mac) and select Copy Command from the menu.
|
|
|
Alternatively, on the Home tab of the ribbon, click the arrow below Copy (
) and then click Copy Command.
|
|
3.
|
On a new line, paste the command.
|
|
|
|
View Document Block Code
|
|
|
|
To view the contents, that is, to expand the document block to see its code and expanded execution groups:
|
|
1.
|
Place the cursor in the document block region.
|
|
2.
|
On the Edit tab, click Show (
), and then click Show Command.
|
|
3.
|
To hide code again, click Show Command again.
|
|
|
Note: Document blocks will always try to display something; output will be displayed if available. If there is no output, then input will be displayed.
|
|
|
|
Expand an Execution Group within a Document Block
|
|
|
|
An execution group is a grouping of Maple input with its corresponding Maple output. It is distinguished by a large square bracket called a group range at the left. As document blocks can contain many execution groups, you can select to expand one execution group within a document block.
|
|
1.
|
Place the cursor in the document block region.
|
|
2.
|
On the Edit tab, click Show (
), and then click Show Execution Group.
|
|
3.
|
To hide the group, click Show Execution Group again.
|
|
|
|
Switch between 2-D Math Input and Output
|
|
|
|
You can control the display of a 2-D math input/output pair. For example, you can show only the output from a 2-D math input.
|
|
1.
|
Place the cursor in a 2-D math input or output section in a document block region.
|
|
2.
|
On the Edit tab, click Input/Output Display (
).
|
|
|
|
Applying Document Blocks in Worksheet Mode
|
|
|
1.
|
Enter input at the Maple command prompt.
|
|
|
Note: These instructions are for Worksheet mode.
|
|
2.
|
Execute the area, creating output that may be referenced elsewhere in the document. See Equation Labels.
|
|
3.
|
Intersperse the area with the content that is to remain visible, adding references to the input and output in the appropriate locations.
|
|
4.
|
Select the area (text and math content) you want to format.
|
|
5.
|
On the Insert tab, click Document Block.
|
|
6.
|
On the Edit tab, click Inline Document Output.
|
|
|
The block displays text and 2-D math output only. You can select areas to display 2-D math input instead of output.
|
|
7.
|
Select the output region you want to display as input. On the Edit tab, click Input/Output Display. The selected region displays input.
|
|
|
|
|
|
|
