summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
Diffstat (limited to 'doc')
-rw-r--r--doc/documentation.rst51
1 files changed, 51 insertions, 0 deletions
diff --git a/doc/documentation.rst b/doc/documentation.rst
index acb8b18..4a5a692 100644
--- a/doc/documentation.rst
+++ b/doc/documentation.rst
@@ -231,6 +231,57 @@ v First order list, fifth entry.
.. caution::
Don’t forget the blank lines between list items.
+Line Blocks
+***********
+
+Line blocks are a convenient environment for parts of the text
+that need to preserve line breaks and indentation. This makes it
+the first choice for most kinds of poems: ::
+
+ | When does a dream begin?
+ | Does it start with a goodnight kiss?
+ | Is it conceived or simply achieved?
+ | When does a dream begin?
+ |
+ | When does a dream begin?
+ | Is it born in a moment of bliss?
+ | Or is it begun when two hearts are one?
+ | When does a dream exist?
+ |
+ | The vision of you appears somehow
+ Impossible to resist
+ | But I'm not imagining seeing you
+ For who could have dreamed of this?
+ |
+ | When does a dream begin?
+ | When reality is dismissed?
+ | Or does it commence when we lose all pretence?
+ | When does a dream begin?
+
+Indentation, continued lines, etc. should work out without
+problems:
+
+| When does a dream begin?
+| Does it start with a goodnight kiss?
+| Is it conceived or simply achieved?
+| When does a dream begin?
+|
+| When does a dream begin?
+| Is it born in a moment of bliss?
+| Or is it begun when two hearts are one?
+| When does a dream exist?
+|
+| The vision of you appears somehow
+ Impossible to resist
+| But I'm not imagining seeing you
+ For who could have dreamed of this?
+|
+| When does a dream begin?
+| When reality is dismissed?
+| Or does it commence when we lose all pretence?
+| When does a dream begin?
+
+
==========
Directives
==========