Download Halibut User Manual
Transcript
1. Two, part one.
2. Two, part two.
3. Two, part three.
3. Three.
This syntax might seem a little bit inconvenient, and perhaps counter-intuitive: you might expect
the enclosing braces to have to go around the whole list item, rather than everything except the
first paragraph.
\lcont is a recent addition to the Halibut input language; previously, all lists were required to
use no more than one paragraph per list item. So it's certainly true that this feature looks like an
afterthought because it is an afterthought, and it's possible that if I'd been designing the language
from scratch with multiple-paragraph list items in mind, I would have made it look different.
However, the advantage of doing it this way is that no enclosing braces are required in the
common case: simple lists with only one paragraph per item are really, really easy to write. So
I'm not too unhappy with the way it turned out; it obeys the doctrine of making simple things
simple, and difficult things possible.
Note that \lcont can only be used on \b, \n and \dd paragraphs; it cannot be used on \dt.
3.3.3 \rule: Horizontal rules
The command \rule, appearing on its own as a paragraph, will cause a horizontal rule to be
drawn, like this:
Some text.
\rule
Some more text.
This produces the following output:
Some text.
Some more text.
3.3.4 \quote: Indenting multiple paragraphs as a long quotation
Quoting verbatim text using a code paragraph (section 3.3.1) is not always sufficient for your
quoting needs. Sometimes you need to quote some normally formatted text, possibly in multiple
paragraphs. This is similar to HTML's <BLOCKQUOTE> command.
To do this, you can use the \quote command. Like \lcont, this is a command which expects
to enclose at least one paragraph and possibly more. Simply write \quote{ at the beginning
of your quoted section, and } at the end, and the paragraphs in between will be formatted to
indicate that they are a quotation.
(This very manual, in fact, uses this feature a lot: all of the examples of Halibut input followed
by Halibut output have the output quoted using \quote.)
22