10.2 @quotation: Block quotations

The text of a quotation is processed normally (regular font, text is filled) except that:

• the margins are closer to the center of the page, so the whole of the quotation is indented;
• and the first lines of paragraphs are indented no more than other lines.

This is an example of text written between an @quotation command and an @end quotation command. An @quotation command is most often used to indicate text that is excerpted from another (real or hypothetical) printed work.

Write an @quotation command as text on a line by itself. This line will disappear from the output. Mark the end of the quotation with a line beginning with and containing only @end quotation. The @end quotation line will likewise disappear from the output.

@quotation takes one optional argument, given on the remainder of the line. This text, if present, is included at the beginning of the quotation in bold or otherwise emphasized, and followed with a ‘:’. For example:

@quotation Note
This is
a foo.
@end quotation

produces

Note: This is a foo.

If the @quotation argument is exactly one of these words:

Caution  Important  Note  Tip  Warning

then the Docbook output uses corresponding special tags (<note>, etc.) instead of the default <blockquote>. HTML output always uses <blockquote>.