Line-oriented text block (line block)
Text blocks in which each line begins with the prefix "|" followed by a space are called line blocks in reStructuredText. Each vertical bar prefix indicates a new line.
Line blocks are suitable for structures where the line layout is important. In addition, a line block can be used to force blank lines in the Library Manager display or to separate text body elements.
Properties
- Indentations can result in nested structures.
- Wrapped sections of long lines are continuation lines. They start with a space instead of the vertical bar. The left margin of a continuation line must be indented, but does not have to be aligned with the left margin of the text above it.
- Inline markups are processed.
- A blank line must be inserted before and after a line block.
Principle
+----+-------------------+
|"| "|line |
+----|continuation line |
+-------------------+
Sample
The following sample shows the nesting of line blocks and the structure of continuation lines.
(In sample project: B_DocuElements\Text blocks\FB_Libdoc_LineBlock)
(*
| Each new line begins with
| a vertical bar ("|").
| Line breaks and initial indents
| are preserved.
| Continuation lines are wrapped
portions of long lines; they begin
with spaces in place of vertical bars.
*)
If there is another text body element in front of a line block, the entire line block can be indented (the minimum indentation is one space).
(*
Line blocks are useful where the structure of lines is significant.
| Each new line begins with
| a vertical bar ("|").
| Line breaks and initial indents
| are preserved.
| Continuation lines are wrapped
portions of long lines; they begin
with spaces in place of vertical bars.
| Each new line begins with
| a vertical bar ("|").
| Line breaks and initial indents
| are preserved.
| Continuation lines are wrapped
portions of long lines; they begin
with spaces in place of vertical bars.
*)